Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
İçerik üretici analizleri özelliğiyle YouTube içerik üreticileri hakkında bilgi edinin ve analizleri alın. Bu özellik, hedef kitleleriyle alakalı içerik üreticileri bulmak isteyen ajanslar ve reklamverenler için faydalı olabilir.
API'nin dört ana işlevi vardır:
İçerik üreticilerin keşfedilebilirliği: Belirli bir konu, demografi, kitle veya içerik üretici özelliklerine göre en popüler içerik üreticileri bulun.
İçerik üretici marka analizleri: Belirli bir markayla ilgili içerik üreticiler hakkında analizler alın.
İçerik üretici analizleri: Belirli YouTube kanallarıyla ilgili abone sayısı, görüntüleme sayısı ve kitle demografik özellikleri gibi analizleri alın.
Trend Olan İçgörüler: Belirli kitlelere veya konulara göre belirli trendler hakkında içgörüler alın.
Uygunluk koşulları
ContentCreatorInsightsService.GenerateCreatorInsights
Google Ads API'nin özel bir bileşenidir ve münhasır olmayan, telifsiz bir veri lisansıyla sunulur. Sözleşmeli iş ortakları, YouTube içerik üreticilerini ve içeriklerini keşfetmek için standart Google Ads istemci kitaplıklarını kullanabilir. İş ortaklarının uygunluk için aşağıdaki koşulları karşılaması gerekir:
API'yi entegre edecek bir planlama aracına veya kullanıcı arayüzüne sahip olmanız gerekir.
Potansiyel reklam fırsatları için YouTube içeriklerini ve içerik üreticilerini keşfetmek üzere API'yi kullanın.
Uygunluğunuzu doğrulamak için ön eleme değerlendirmesini tamamlayın.
Veri kullanımı şartlarına uymalı ve düzenli veri denetimlerine tabi olmayı kabul etmelisiniz.
Veri kullanım şartlarını yasal olarak zorunlu kılan bir veri lisanslama sözleşmesi imzalayın.
Daha fazla bilgi için Google temsilcinizle iletişime geçin.
İçerik üretici analizleri oluşturma
İçerik üretici analizleri oluşturmak için ContentCreatorInsightsService.GenerateCreatorInsights yöntemine istek gönderin. Bu yöntemde saniyede 5 sorgu (QPS) sınırı vardır ve içerik üreticilerin keşfedilebilirliğini artırmak, içerik üreticilerin marka analizlerini almak veya içerik üreticilerle ilgili analizler edinmek isteyip istemediğinize bağlı olarak üç tür giriş yapılır. Veri almak istediğiniz ülke konumlarını sağlamanız gerekir.
İçerik üreticilerin keşfedilebilirliği: Yaş, cinsiyet ve ilgi alanları gibi kitle özelliklerinin bir listesini sağlayabilirsiniz. API, kitleleri bu özelliklerle eşleşen içerik üreticilerin listesini döndürür. Ayrıca, içerikleri özellikle girdiğiniz içerik üretici özellikleriyle eşleşen içerik üreticileri filtrelemek için içerik üretici özellikleri de sağlayabilirsiniz.
İçerik üretici marka analizleri: En iyi içerik üreticileri aramak için bir marka girin. API, eşleşen kanallarla ilgili analizler döndürür.
İçerik üretici analizleri: YouTube kanal kimliklerinin listesini sağlayın. API, bu kanallarla ilgili analizler döndürür.
generateCreatorInsights yöntemi, GenerateCreatorInsightsResponse nesnesini döndürür. Bu nesne, YouTubeCreatorInsights nesnelerinin listesini içerir. Her YouTubeCreatorInsights nesnesi, içerik üreticiyle ilgili aşağıdaki bilgileri içerir:
İçerik üretici adı
YouTube kanalı
Toplam içerik üretici metrikleri
YouTube kanalı analizleri listesi
YouTubeMetrics nesnesi aşağıdaki metrikleri içerir:
Abone sayısı
Görüntüleme sayısı
Video sayısı
Etkin bir Shorts içerik üreticisi olmalısınız.
YouTubeChannelInsights nesnesi, bir YouTube kanalıyla ilgili aşağıdaki bilgileri içerir:
Kanal adı
Kanal Kimliği
Kanal URL'si
Kanal açıklaması
Kanal metrikleri
Kanal kitlesi özellikleri (ör. yaş, cinsiyet ve kullanıcı ilgi alanlarının dağılımı)
En İyi Videolar
Kanal türü
Trend olan analizler üretme
Trend olan analizler oluşturmak için ContentCreatorInsightsService.GenerateTrendingInsights yöntemine istek gönderin. Bu yöntemin saniyede 5 sorgu (QPS) sınırı vardır ve kitle trendlerini mi yoksa konu trendlerini mi almak istediğinize bağlı olarak iki tür giriş alır.
Trendleri almak istediğiniz belirli ülke konumunu sağlamanız gerekir.
Kitle Trendleri: Yaş, cinsiyet ve ilgi alanları gibi kitle özelliklerinin bir listesini sağlayabilirsiniz. API, bu kitleler için trend olan analizlerin listesini döndürür.
Trend Olan Konular: İçerik konularının listesini sağlar. API, bu konularla ilgili trend olan analizlerin listesini döndürür.
[null,null,["Son güncelleme tarihi: 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."]]
