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: 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 penayangan, dan demografi audiensnya.
  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. Anda juga dapat meminta insight sentimen merek untuk insight trending berbasis topik dengan meminta data tambahan.

Persyaratan kelayakan

GenerateCreatorInsights adalah komponen pribadi Google Ads API yang ditawarkan dengan lisensi data bebas royalti dan non-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 penilaian prapenyaringan untuk memastikan kelayakan.
  • Mengikuti 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 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" OR "perjalanan" OR ...), 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 dalam audience_combinations. "Perawatan kulit", "Perawatan rambut", dan "Kosmetik" adalah topik minat, yang diwakili oleh entity Pustaka Pengetahuan (misalnya, /m/014trl untuk Kosmetik). Grup pertama akan berisi atribut entitas Pustaka Pengetahuan untuk "Perawatan kulit" dan "Perawatan rambut", dan grup kedua akan berisi atribut entitas Pustaka 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 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 tertentu. 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 di v24.2 dan dihapus di v25. Sebagai gantinya, gunakan search_topics.

  3. Insight kreator: Berikan daftar ID channel YouTube, nama sebutan channel YouTube (dimulai di v25.2), atau kombinasi keduanya menggunakan kolom search_channels. API akan menampilkan insight tentang saluran 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 adalah entitas 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
  • 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 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). 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.

    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" OR "perjalanan" OR ...), 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 dalam audience_combinations. "Perawatan kulit", "Perawatan rambut", dan "Kosmetik" adalah topik minat, yang diwakili oleh entity Pustaka Pengetahuan (misalnya, /m/014trl untuk Kosmetik). Grup pertama akan berisi atribut entitas Pustaka Pengetahuan untuk "Perawatan kulit" dan "Perawatan rambut", dan grup kedua akan berisi atribut entitas Pustaka 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 Anda 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.

    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 yang terpisah.

    Dokumentasi tambahan tentang ListAudienceInsightsAttributes dapat ditemukan di panduan Analisis Audiens.

  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. Anda juga dapat meminta insight sentimen merek untuk topik merek dengan meminta data tambahan.

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

Jika permintaan trending Anda menggunakan search_topics, menyetel supplemental_data ke LOCAL_CREATOR_DATA akan mengisi kolom related_local_creators 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).

Jika permintaan trending Anda menggunakan search_topics, menyetel supplemental_data ke BRAND_SENTIMENT_DATA akan mengisi kolom brand_sentiment_insights pada objek TrendInsight yang ditampilkan saat topik entitas Pustaka Pengetahuan yang diminta memiliki kemampuan BRAND. Topik brand adalah entitas yang diberi tag dengan kemampuan BRAND. Anda dapat mengambil kemampuan entity yang didukung menggunakan metode ListAudienceInsightsAttributes.

Pengukuran sentimen merek melibatkan penggunaan model AI (yang didukung oleh Gemini) untuk menganalisis konten video YouTube yang terkait dengan merek, mengategorikan sentimen sebagai positif, negatif, atau netral. Hanya konten video itu sendiri yang dianalisis; komentar pengguna tidak disertakan.

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

  • trend_attribute: AudienceInsightsAttributeMetadata utama untuk tren.
  • trend_metrics: Metrik untuk tren, seperti persentase perubahan 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 diisi, yang berisi metadata tingkat video (seperti URL video, URL thumbnail, dan jumlah penayangan atau suka) dan metadata tingkat channel (seperti ID, nama, dan URL channel).
  • brand_sentiment_insights: Daftar objek BrandSentimentInsight untuk tren. Hanya diisi saat permintaan tren menggunakan search_topics, topik entity Pustaka Pengetahuan memiliki kemampuan BRAND, dan BRAND_SENTIMENT_DATA diminta di supplemental_data. Setiap objek BrandSentimentInsight berisi:
    • month: Bulan yang diwakili sentimen merek dalam format YYYY-MM.
    • has_insufficient_data: Apakah data tidak cukup untuk menghitung sentimen merek.
    • sentiment_distributions: Distribusi sentimen antara positif, negatif, dan netral, yang dihitung sebagai proporsi penayangan untuk video yang sesuai dengan merek dengan setiap sentimen.
    • sentiment_summaries: Ringkasan buatan AI tentang hal-hal positif dan negatif terkait konten yang berhubungan dengan merek, beserta contoh video untuk setiap sentimen. Ringkasan hanya dibuat untuk sentimen positif dan negatif, bukan netral.
Sebelumnya
Analisis audiens
Berikutnya
Tolok ukur YouTube