Insight kreator YouTube

Temukan dan ambil insight tentang kreator YouTube dengan fitur insight kreator. Hal ini dapat berguna bagi agensi dan pengiklan yang ingin menemukan kreator yang relevan dengan target audiens mereka.

API ini memiliki empat fungsi utama:

  1. Keterlihatan kreator: Temukan kreator teratas untuk sekumpulan topik, demografi, audiens, atau atribut kreator tertentu.
  2. Insight brand kreator: Ambil insight tentang kreator yang terkait dengan brand tertentu.
  3. Insight kreator: Ambil insight tentang channel YouTube tertentu, seperti jumlah subscriber, jumlah penayangan, dan demografi audiens.
  4. Insight tren: Ambil insight tentang tren tertentu, berdasarkan audiens atau topik tertentu.

Persyaratan kelayakan

ContentCreatorInsightsService.GenerateCreatorInsights adalah komponen pribadi Google Ads API yang ditawarkan dengan lisensi data bebas royalti dan tidak eksklusif. Partner yang login dapat menggunakan pustaka klien Google Ads standar untuk menjelajahi kreator dan konten YouTube. Agar memenuhi syarat, partner harus memenuhi kondisi berikut:

  • Memiliki alat perencanaan atau antarmuka pengguna yang akan mengintegrasikan Google Ads API.
  • Gunakan API untuk menjelajahi konten dan kreator YouTube untuk menemukan potensi peluang iklan.
  • Selesaikan penilaian pra-seleksi untuk memastikan kelayakan.
  • Mematuhi persyaratan penggunaan data dan bersedia menjalani audit data berkala.
  • Menandatangani perjanjian pemberian lisensi data yang secara hukum memberlakukan persyaratan penggunaan data.
  • Setujui persyaratan layanan Google Ads API.

Hubungi perwakilan Google untuk mendapatkan informasi selengkapnya.

Membuat insight kreator

Untuk membuat insight kreator, kirim permintaan ke metode ContentCreatorInsightsService.GenerateCreatorInsights. Metode ini memiliki batas 5 kueri per detik (QPS) dan memerlukan tiga jenis input, bergantung pada apakah Anda ingin melakukan penemuan kreator, insight merek kreator, atau mendapatkan insight kreator. Anda harus memberikan lokasi negara tempat Anda ingin mendapatkan data.

  1. Kemudahan penemuan kreator: Anda dapat memberikan daftar atribut audiens, seperti usia, gender, dan minat pengguna (termasuk audiens minat, berniat beli, dan peristiwa kehidupan). API menampilkan daftar kreator yang audiensnya cocok dengan atribut tersebut. Anda juga dapat memberikan atribut kreator untuk memfilter kreator yang kontennya secara khusus cocok dengan atribut kreator yang Anda masukkan.

    Anda dapat mengambil atribut audiens yang tersedia menggunakan AudienceInsightsService.ListAudienceInsightsAttributes, dengan memberikan dimensi yang atributnya Anda inginkan, seperti KNOWLEDGE_GRAPH untuk topik minat.

    Mulai Google Ads API v23, Anda dapat menentukan hubungan atribut audiens yang kompleks menggunakan audience_combinations. Kolom ini memungkinkan Anda menentukan audiens dengan logika Boolean (AND/OR) yang tidak mungkin dilakukan dengan audience_attributes.

    Meskipun audience_attributes cocok untuk penargetan berdasarkan daftar atribut yang digabungkan (dikombinasikan dengan OR) (misalnya, pengguna yang tertarik dengan "olahraga" ATAU "perjalanan" ATAU ...), audience_combinations menawarkan kontrol yang lebih terperinci. Setiap InsightsAudienceAttributeGroup dalam audience_combinations menggabungkan atribut dengan OR logis. Grup ini kemudian digabungkan dengan AND logis.

    Misalnya, untuk menargetkan audiens yang tertarik dengan ("Perawatan kulit" ATAU "Perawatan rambut") DAN juga "Kosmetik", Anda akan menggunakan dua item InsightsAudienceAttributeGroup di audience_combinations. "Perawatan kulit", "Perawatan rambut", dan "Kosmetik" adalah topik minat, yang diwakili oleh entity Knowledge Graph (misalnya, /m/014trl untuk Kosmetik). Grup pertama akan berisi atribut entity Grafik Pengetahuan untuk "Perawatan kulit" dan "Perawatan rambut", dan grup kedua akan berisi atribut entity Grafik Pengetahuan untuk "Kosmetik".

    Perhatikan bahwa jika Anda menentukan entitas Knowledge Graph, Kategori Produk & Layanan, atau minat pengguna di audience_attributes, Anda tidak dapat menggunakan audience_combinations. Jika menggunakan audience_combinations, Anda harus menentukan atribut ini dalam audience_combinations, bukan di audience_attributes; namun, Anda tetap dapat menggunakan audience_attributes untuk jenis atribut lain seperti demografi bersama dengan audience_combinations.

  2. Insight merek kreator: Berikan merek untuk menelusuri kreator teratas. API menampilkan insight tentang channel yang cocok.

  3. Insight kreator: Berikan daftar ID channel YouTube. API akan menampilkan insight tentang channel tertentu tersebut.

Metode generateCreatorInsights menampilkan objek GenerateCreatorInsightsResponse. Objek ini berisi daftar objek YouTubeCreatorInsights. Setiap objek YouTubeCreatorInsights berisi informasi berikut tentang kreator:

  • Nama kreator
  • Channel YouTube
  • Total metrik kreator
  • Daftar insight channel YouTube

Objek YouTubeMetrics berisi metrik berikut:

  • Jumlah subscriber
  • Jumlah tayangan
  • Jumlah video
  • Adalah kreator Shorts aktif
  • Peluang kemitraan (dimulai di v23)

Objek YouTubeChannelInsights berisi informasi berikut tentang channel YouTube:

  • Nama saluran
  • ID Channel
  • URL channel
  • Deskripsi channel
  • Metrik channel
  • Atribut audiens saluran (seperti usia, gender, dan minat pengguna

    perincian)

  • Video teratas

  • Jenis saluran

  • Bahasa yang terkait dengan konten channel

  • Skor relevansi (khusus untuk penelusuran tren topik)

Untuk membuat insight trending, kirim permintaan ke metode ContentCreatorInsightsService.GenerateTrendingInsights. Metode ini memiliki batas 5 kueri per detik (QPS) dan memerlukan dua jenis input, bergantung pada apakah Anda ingin mendapatkan tren audiens atau tren topik. Anda harus memberikan lokasi negara tertentu tempat Anda ingin mendapatkan tren.

  1. Tren audiens: Anda dapat memberikan daftar atribut audiens, seperti usia, jenis kelamin, dan minat pengguna (termasuk audiens minat, berniat beli, dan peristiwa kehidupan). API menampilkan daftar insight yang sedang tren untuk audiens tersebut, termasuk metrik seperti perubahan persentase nilai tren selama periode perbandingan.

    Anda dapat mengambil atribut audiens yang tersedia menggunakan AudienceInsightsService.ListAudienceInsightsAttributes, dengan memberikan dimensi yang atributnya Anda inginkan, seperti KNOWLEDGE_GRAPH untuk topik minat.

    Mulai Google Ads API v23, Anda dapat menentukan hubungan atribut audiens yang kompleks menggunakan audience_combinations. Kolom ini memungkinkan Anda menentukan audiens dengan logika Boolean (AND/OR) yang tidak mungkin dilakukan dengan audience_attributes.

    Meskipun audience_attributes cocok untuk penargetan berdasarkan daftar atribut yang digabungkan (dikombinasikan dengan OR) (misalnya, pengguna yang tertarik dengan "olahraga" ATAU "perjalanan" ATAU ...), audience_combinations menawarkan kontrol yang lebih terperinci. Setiap InsightsAudienceAttributeGroup dalam audience_combinations menggabungkan atribut dengan OR logis. Grup ini kemudian digabungkan dengan AND logis.

    Misalnya, untuk menargetkan audiens yang tertarik dengan ("Perawatan kulit" ATAU "Perawatan rambut") DAN juga "Kosmetik", Anda akan menggunakan dua item InsightsAudienceAttributeGroup di audience_combinations. "Perawatan kulit", "Perawatan rambut", dan "Kosmetik" adalah topik minat, yang diwakili oleh entity Knowledge Graph (misalnya, /m/014trl untuk Kosmetik). Grup pertama akan berisi atribut entity Grafik Pengetahuan untuk "Perawatan kulit" dan "Perawatan rambut", dan grup kedua akan berisi atribut entity Grafik Pengetahuan untuk "Kosmetik".

    Perhatikan bahwa jika Anda menentukan entitas Knowledge Graph, Kategori Produk & Layanan, atau minat pengguna di audience_attributes, Anda tidak dapat menggunakan audience_combinations. Jika menggunakan audience_combinations, Anda harus menentukan atribut ini dalam audience_combinations, bukan di audience_attributes; namun, Anda tetap dapat menggunakan audience_attributes untuk jenis atribut lain seperti demografi bersama dengan audience_combinations.

  2. Tren topik: Berikan daftar topik konten. API menampilkan daftar insight yang sedang tren untuk topik tersebut, termasuk metrik seperti perubahan persentase nilai tren selama periode perbandingan.