Untuk mendiskusikan dan memberikan masukan tentang produk kami, bergabunglah ke channel Discord Google Ads resmi di server Komunitas Iklan dan Pengukuran Google.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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:
Keterlihatan Kreator: Temukan kreator teratas untuk sekumpulan topik, demografi, audiens, atau atribut kreator tertentu.
Insight Brand Kreator: Ambil insight tentang kreator yang terkait dengan brand tertentu.
Insight Kreator: Ambil insight tentang channel YouTube tertentu, seperti jumlah subscriber, jumlah penayangan, dan demografi audiensnya.
Insight yang Sedang 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
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 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.
Hubungi perwakilan Google untuk mendapatkan informasi selengkapnya.
Menghasilkan 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.
Kemudahan Penemuan Kreator: Anda dapat memberikan daftar atribut audiens, seperti usia, gender, dan minat. 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.
Insight Brand Kreator: Berikan brand untuk menelusuri kreator teratas. API
menampilkan insight tentang channel yang cocok.
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
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
Menghasilkan insight yang sedang tren
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.
Tren Audiens: Anda dapat memberikan daftar atribut audiens, seperti usia, gender, dan minat. API akan menampilkan daftar insight yang sedang trending untuk audiens tersebut.
Tren Topik: Berikan daftar topik konten. API menampilkan daftar
insight yang sedang tren untuk topik tersebut.
[null,null,["Terakhir diperbarui pada 2025-08-27 UTC."],[[["\u003cp\u003eDiscover top YouTube creators based on topics, demographics, and target audiences using the creator insights feature.\u003c/p\u003e\n"],["\u003cp\u003eAccess creator insights such as subscriber count, view count, and audience demographics for specific YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently in beta and requires meeting specific eligibility criteria, including a pre-screen assessment and data usage agreement.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003eContentCreatorInsightsService.GenerateCreatorInsights\u003c/code\u003e method to request either creator discovery or specific channel insights.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides data like creator name, channel details, metrics (subscriber count, view count), and audience attributes.\u003c/p\u003e\n"]]],[],null,["# YouTube creator insights\n\n| **Note:** This feature is in beta and is only available to developers on an allowlist.\n\nDiscover and fetch insights about YouTube creators with the creator insights\nfeature. This can be useful for agencies and advertisers who want to find\ncreators who are relevant to their target audience.\n\nThe API has four main functions:\n\n1. **Creator Discoverability:** Find the top creators for a given set of topics, demographics, audiences, or creator attributes.\n2. **Creator Brand Insights:** Fetch insights about creators relating to a specific brand.\n3. **Creator Insights:** Fetch insights about specific YouTube channels, such as their subscriber count, view count, and audience demographics.\n4. **Trending Insights:** Fetch insights about specific trends, based on specific audiences or topics.\n\nEligibility requirements\n------------------------\n\n[`ContentCreatorInsightsService.GenerateCreatorInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateCreatorInsights)\nis a private component of the Google Ads API offered with a non-exclusive, royalty-free\ndata license. Signed partners can use the standard\n[Google Ads client libraries](/google-ads/api/docs/client-libs) to explore YouTube creators and\ncontent. To be eligible, partners must satisfy the following conditions:\n\n- Have a planning tool or user interface that will integrate the API.\n- Use the API to explore YouTube content and creators for potential advertising opportunities.\n- Complete a pre-screen assessment to ensure eligibility.\n- Follow data usage requirements and be willing to undergo periodic data audits.\n- Sign a data-licensing agreement that legally enforces data usage requirements.\n- Accept the Google Ads API [terms of service](../../terms).\n\nContact your Google representative for more information.\n\nGenerate creator insights\n-------------------------\n\nTo generate creator insights, send a request to the\n[`ContentCreatorInsightsService.GenerateCreatorInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateCreatorInsights)\nmethod. This method has a limit of 5 queries per second (QPS) and takes three\ntypes of input depending on if you want to do creator discoverability, creator\nbrand insights or get creator insights. You must provide the country locations\nwhere you want to get data from.\n\n1. **Creator Discoverability:** You can provide a list of audience attributes, such as age, gender, and interests. The API returns a list of creators whose audiences match those attributes. You can also provide creator attributes to filter for creators whose content specifically matches your inputted creator attributes.\n2. **Creator Brand Insights:** Provide a brand to search for top creators. The API returns insights about matching channels.\n3. **Creator Insights:** Provide a list of YouTube channel IDs. The API returns insights about those specific channels.\n\nThe `generateCreatorInsights` method returns a `GenerateCreatorInsightsResponse`\nobject. This object contains a list of `YouTubeCreatorInsights` objects. Each\n`YouTubeCreatorInsights` object contains the following information about a\ncreator:\n\n- Creator name\n- YouTube channel\n- Total creator metrics\n- List of YouTube channel insights\n\nThe `YouTubeMetrics` object contains the following metrics:\n\n- Subscriber count\n- View count\n- Video count\n- Is Active Shorts Creator\n\nThe `YouTubeChannelInsights` object contains the following information about a\nYouTube channel:\n\n- Channel name\n- Channel ID\n- Channel URL\n- Channel description\n- Channel metrics\n- Channel audience attributes (such as age, gender, and user interest breakdown)\n- Top Videos\n- Channel type\n\nGenerate trending insights\n--------------------------\n\nTo generate trending insights, send a request to the\n[`ContentCreatorInsightsService.GenerateTrendingInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateTrendingInsights)\nmethod. This method has a limit of 5 queries per second (QPS) and takes two\ntypes of input depending on if you want to get audience trends or topic trends.\nYou must provide the specific country location where you want to get trends\nfrom.\n\n1. **Audience Trends:** You can provide a list of audience attributes, such as age, gender, and interests. The API returns a list of trending insights for those audiences.\n2. **Topic Trends:** Provide a list of content topics. The API returns a list of trending insights for those topics."]]
