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. Kemudahan penemuan kreator: Temukan kreator yang relevan untuk sekumpulan topik, demografi, audiens, atau atribut kreator tertentu.
  2. Insight topik kreator: Dapatkan insight tentang kreator yang relevan yang membuat konten tentang topik 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.

Penemuan kreator lokal (menemukan kreator yang berbasis di atau memposting dari negara tertentu dan dilihat di negara tersebut) didukung saat menggunakan penemuan kreator berbasis topik atau insight trending dengan meminta data tambahan.

Persyaratan kelayakan

GenerateCreatorInsights adalah komponen pribadi Google Ads API yang ditawarkan dengan lisensi data bebas royalti dan tidak eksklusif. Partner yang telah menandatangani perjanjian 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 verifikasi awal untuk memastikan kelayakan.
  • Mematuhi persyaratan penggunaan data dan bersedia menjalani audit data secara 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 GenerateCreatorInsights. Metode ini memiliki batas 5 kueri per detik (QPS). API ini menerima berbagai jenis input, bergantung pada apakah Anda ingin melakukan penemuan kreator, menelusuri kreator yang relevan berdasarkan topik, 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 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 gabungan (digabungkan 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. Kemudian, grup ini 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 yang diminati, yang diwakili oleh entity Pustaka Pengetahuan (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 Pustaka Pengetahuan, Kategori Produk & Layanan, atau minat pengguna di audience_attributes, Anda tidak dapat menggunakan audience_combinations. Jika Anda menggunakan audience_combinations, Anda harus menentukan atribut ini dalam audience_combinations, bukan dalam audience_attributes; namun, Anda tetap dapat menggunakan audience_attributes untuk jenis atribut lain seperti demografi bersama dengan audience_combinations.

  2. Insight topik kreator: Berikan daftar topik konten menggunakan kolom search_topics. API menampilkan kreator yang relevan yang membuat konten tentang topik yang ditentukan. Data yang diambil didasarkan pada negara yang ditentukan dalam country_locations. Perhatikan bahwa opsi ini memungkinkan penelusuran hanya untuk satu negara.

    Entitas yang didukung di kolom SearchTopics harus diberi tag dengan kemampuan CONTENT_TRENDING_INSIGHTS atau CREATOR_TOPIC_INSIGHTS. Gunakan metode ListAudienceInsightsAttributes untuk mengambil kemampuan entity yang didukung.

    Catatan: Opsi search_brand tidak digunakan lagi mulai v24.2 dan dihapus sepenuhnya dalam rilis v25. Pengguna harus beralih menggunakan search_topics.

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

Data tambahan dan kreator lokal

Secara default, hanya data insight inti yang ditampilkan. Anda dapat meminta fitur opsional dan data tambahan dalam respons dengan menetapkan kolom berulang supplemental_data.

Misalnya, Anda dapat meminta data kreator lokal dengan menambahkan nilai enum LOCAL_CREATOR_DATA ke kolom supplemental_data. Jika Anda menelusuri kreator menggunakan search_topics (dan topik tersebut adalah entitas Pustaka Pengetahuan yang diberi tag dengan kemampuan CREATOR_TOPIC_INSIGHTS), API akan mengisi kolom local_creator_insights dalam respons dengan kreator lokal yang telah memberikan izin untuk membagikan data lokasi mereka.

Perhatikan spesifikasi berikut untuk penemuan kreator lokal:

  • Definisi: "Kreator lokal" adalah kreator yang berbasis di atau memposting dari negara yang dipilih dan ditonton di negara tersebut.
  • Batasan: Penemuan kreator lokal tidak didukung jika sub_country_locations ditetapkan dalam permintaan.
  • Kemampuan: Anda dapat mengambil daftar entity Pustaka Pengetahuan yang didukung dan kemampuannya menggunakan ListAudienceInsightsAttributes.

Metode generateCreatorInsights menampilkan objek GenerateCreatorInsightsResponse. Objek ini berisi kolom berikut:

  • creator_insights: Daftar objek YouTubeCreatorInsights yang cocok dengan kriteria inti Anda.
  • local_creator_insights: Daftar objek YouTubeCreatorInsights untuk kreator lokal. Kolom ini hanya diisi jika LOCAL_CREATOR_DATA diminta dan kriteria yang digunakan adalah search_topics.

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 (mulai di v23)

Untuk mengidentifikasi apakah kreator memenuhi syarat untuk kemitraan konten bermerek asli, periksa partnership_opportunities; kreator memenuhi syarat jika daftar berisi nilai CREATOR_PARTNERSHIPS.

Objek YouTubeChannelInsights berisi informasi berikut tentang channel YouTube:

  • Nama saluran
  • ID Channel
  • URL channel
  • Deskripsi channel
  • Metrik channel
  • Atribut audiens saluran (seperti perincian usia, gender, dan minat pengguna)
  • 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 GenerateTrendingInsights. Metode ini memiliki batas 5 kueri per detik (QPS). API ini 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, gender, 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 ListAudienceInsightsAttributes, dengan memberikan dimensi yang atributnya Anda inginkan, seperti KNOWLEDGE_GRAPH untuk topik minat.

    Atribut KNOWLEDGE_GRAPH akan memiliki satu atau beberapa tag InsightsKnowledgeGraphEntityCapabilities. Atribut yang didukung untuk Insight Trending akan memiliki tag yang relevan dalam metadata responsnya.

    Perhatikan bahwa developer yang memiliki akses ke ContentCreatorInsightsService juga akan memiliki akses otomatis ke AudienceInsightsService.ListAudienceInsightsAttributes. Endpoint lain di AudienceInsightsService memerlukan proses daftar yang diizinkan secara terpisah.

    Dokumentasi tambahan tentang ListAudienceInsightsAttributes dapat ditemukan di panduan Analisis Audiens.

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

    Anda dapat mengambil atribut audiens yang tersedia menggunakan metode 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 gabungan (digabungkan 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. Kemudian, grup ini 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 yang diminati, yang diwakili oleh entity Pustaka Pengetahuan (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 Pustaka Pengetahuan, Kategori Produk & Layanan, atau minat pengguna di audience_attributes, Anda tidak dapat menggunakan audience_combinations. Jika Anda menggunakan audience_combinations, Anda harus menentukan atribut ini dalam audience_combinations, bukan dalam audience_attributes; namun, Anda tetap dapat menggunakan audience_attributes untuk jenis atribut lain seperti demografi bersama dengan audience_combinations.

  3. 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.

Mirip dengan pembuatan insight kreator, Anda dapat meminta fitur opsional dalam insight trending dengan menyetel kolom berulang supplemental_data ke LOCAL_CREATOR_DATA.

Jika permintaan trending Anda menggunakan search_topics, kolom related_local_creators pada objek TrendInsight yang ditampilkan akan diisi dengan kreator lokal terkait untuk topik yang diminta yang telah memberikan izin untuk membagikan data lokasi mereka. Penemuan kreator lokal tunduk pada definisi dan batasan yang sama (seperti tidak kompatibel dengan sub_country_locations).

Sebelumnya
Analisis audiens