Insight kreator YouTube

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

API ini memiliki empat fungsi utama:

  1. Kemudahan penemuan kreator: Temukan kreator yang relevan untuk kumpulan topik, demografi, audiens, atau atribut kreator tertentu.
  2. Insight topik kreator: Ambil insight tentang kreator yang relevan yang membuat konten tentang topik tertentu.
  3. Insight kreator: Ambil insight tentang channel YouTube tertentu, seperti jumlah subscriber, jumlah tayangan, dan demografi audiens.
  4. Insight trending: Ambil insight tentang tren tertentu, berdasarkan audiens atau topik tertentu.

Penemuan kreator lokal (menemukan kreator yang berbasis di atau memposting dari negara tertentu dan ditonton 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 non-eksklusif dan bebas royalti. Partner yang menandatangani perjanjian dapat menggunakan library 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.
  • Menggunakan API untuk menjelajahi konten dan kreator YouTube untuk peluang iklan potensial.
  • Selesaikan verifikasi awal untuk memastikan kelayakan.
  • Mematuhi persyaratan penggunaan data dan bersedia menjalani audit data berkala.
  • Menandatangani perjanjian lisensi data yang secara hukum memberlakukan persyaratan penggunaan data.
  • Menyetujui 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). Metode ini memerlukan 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 akan 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 yang diminati.

    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 (DAN/ATAU) yang tidak dapat dilakukan dengan audience_attributes.

    Meskipun audience_attributes cocok untuk penargetan berdasarkan daftar atribut gabungan (dikombinasikan dengan OR) (misalnya, pengguna yang tertarik dengan "olahraga" OR "perjalanan" OR ...), 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" OR "Perawatan rambut") AND 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 entity Grafik Pengetahuan, 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 dan bukan di audience_attributes; namun, Anda tetap dapat menggunakan audience_attributes untuk jenis atribut lainnya seperti demografi bersama dengan audience_combinations.

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

    Entity 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 di v24.2 dan dihapus di v25. Gunakan search_topics sebagai gantinya.

  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 topiknya adalah entity Pustaka Pengetahuan yang diberi tag dengan kapabilitas 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
  • Apakah kreator Shorts aktif
  • Peluang kemitraan (mulai 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 channel
  • ID Channel
  • URL channel
  • Deskripsi channel
  • Metrik channel
  • Atribut audiens channel (seperti perincian usia, gender, dan minat pengguna)
  • Video teratas
  • Jenis saluran
  • Bahasa yang terkait dengan konten channel
  • Skor relevansi (hanya untuk penelusuran tren topik)
  • Apakah kreator telah memberikan izin untuk membagikan metrik non-publik

Untuk membuat insight trending, kirim permintaan ke metode GenerateTrendingInsights. Metode ini memiliki batas 5 kueri per detik (QPS). Metode 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 akan menampilkan daftar insight trending 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 yang diminati.

    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 (DAN/ATAU) yang tidak dapat dilakukan dengan audience_attributes.

    Meskipun audience_attributes cocok untuk penargetan berdasarkan daftar atribut gabungan (dikombinasikan dengan OR) (misalnya, pengguna yang tertarik dengan "olahraga" OR "perjalanan" OR ...), 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" OR "Perawatan rambut") AND 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 entity Grafik Pengetahuan, 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 dan bukan di audience_attributes; namun, Anda tetap dapat menggunakan audience_attributes untuk jenis atribut lainnya seperti demografi bersama dengan audience_combinations.

    Atribut KNOWLEDGE_GRAPH akan memiliki satu atau beberapa InsightsKnowledgeGraphEntityCapabilities tag. 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 topik: Berikan daftar topik konten. API akan menampilkan daftar insight trending untuk topik tersebut, termasuk metrik seperti perubahan persentase nilai tren selama periode perbandingan.

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

Jika permintaan trending Anda menggunakan search_topics, ini akan mengisi related_local_creators kolom pada objek TrendInsight yang ditampilkan 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).

Metode GenerateTrendingInsights menampilkan daftar objek TrendInsight, yang masing-masing berisi:

  • trend_attribute: AudienceInsightsAttributeMetadata utama untuk tren.
  • trend_metrics: Metrik untuk tren, seperti perubahan persentase selama periode perbandingan.
  • trend_data_points: Titik data historis untuk tren. Hanya diisi untuk tren yang menggunakan search_topics.
  • related_videos: Daftar objek AudienceInsightsAttributeMetadata untuk video trending yang terkait dengan topik tren. Hanya diisi untuk tren yang menggunakan search_topics. Untuk atribut ini, YouTubeVideoAttributeMetadata bertingkat akan diisi, yang berisi metadata tingkat video (seperti URL video, URL thumbnail, dan jumlah tayangan atau suka) dan metadata tingkat channel (seperti ID channel, nama, dan URL).
Sebelumnya
Analisis audiens