YouTube İçerik Üretici Analizleri

İçerik üretici analizleri özelliğini kullanarak YouTube içerik üreticileri hakkında analizler keşfedin ve 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:

  1. İçerik üreticilerin keşfedilebilirliği: Belirli bir konu, demografi, kitle veya içerik üretici özellikleriyle ilgili içerik üreticileri bulun.
  2. İçerik üretici konu analizleri: Belirtilen konular hakkında içerik üreten alakalı içerik üreticilerle ilgili analizleri alın.
  3. İç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.
  4. Trend olan analizler: Belirli kitlelere veya konulara göre belirli trendler hakkında analizler alın.

Ek veriler istenerek konu tabanlı içerik üretici keşfi veya trend olan analizler kullanılırken yerel içerik üretici keşfi (belirli bir ülkede yaşayan veya bu ülkeden içerik yayınlayan ve bu ülkede görüntülenen içerik üreticileri bulma) desteklenir.

Uygunluk koşulları

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:

  • Google Ads API'yi entegre edecek bir planlama aracına veya kullanıcı arayüzüne sahip olmak.
  • 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.
  • Google Ads API Hizmet Şartları'nı kabul edin.

Daha fazla bilgi için Google temsilcinizle iletişime geçin.

İçerik üretici analizleri oluşturma

İçerik üretici analizleri oluşturmak için GenerateCreatorInsights yöntemine istek gönderin. Bu yöntemin saniyede 5 sorgu (QPS) sınırı vardır. İçerik üreticilerin keşfedilmesini sağlamak, konulara göre alakalı içerik üreticileri aramak veya içerik üreticilerle ilgili analizler almak isteyip istemediğinize bağlı olarak farklı türlerde girişler gerekir. Veri almak istediğiniz ülke konumlarını sağlamanız gerekir.

  1. İçerik üreticilerin keşfedilebilirliği: Yaş, cinsiyet ve kullanıcı ilgi alanları (yakın ilgi alanı, pazardaki kitle ve yaşamdaki önemli olay kitleleri dahil) 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.

    Kullanılabilir kitle özelliklerini almak için ListAudienceInsightsAttributes işlevini kullanabilirsiniz. İlgi alanları gibi özellik istediğiniz boyutları sağlayarak KNOWLEDGE_GRAPH işlevini kullanabilirsiniz.

    Google Ads API v23'ten itibaren audience_combinations kullanarak karmaşık kitle özelliği ilişkileri belirtebilirsiniz. Bu alan, audience_attributes ile mümkün olmayan boole mantığı (VE/VEYA) kullanarak kitleleri tanımlamanıza olanak tanır.

    audience_attributes, birleştirilmiş (VEYA ile birleştirilmiş) özellikler listesine göre hedefleme için uygun olsa da (ör. "spor" VEYA "seyahat" VEYA ... ile ilgilenen kullanıcılar) audience_combinations daha ayrıntılı kontrol sunar. audience_combinations içindeki her InsightsAudienceAttributeGroup, özellikleri mantıksal bir VEYA ile birleştirir. Bu gruplar daha sonra mantıksal bir VE ile birleştirilir.

    Örneğin, ("Cilt bakımı" VEYA "Saç bakımı") İLE "Kozmetik" ile de ilgilenen bir kitleyi hedeflemek için InsightsAudienceAttributeGroup içinde iki audience_combinations öğesi kullanırsınız. "Cilt bakımı", "Saç bakımı" ve "Kozmetik", Bilgi Grafiği varlıklarıyla (ör. Kozmetik için /m/014trl) temsil edilen ilgi alanlarıdır. İlk grupta "Cilt bakımı" ve "Saç bakımı" ile ilgili bilgi grafiği öğesi özellikleri, ikinci grupta ise "Kozmetik" ile ilgili bilgi grafiği öğesi özelliği yer alır.

    audience_attributes bölümünde Bilgi Grafiği varlıklarını, Ürün ve Hizmet Kategorilerini veya kullanıcı ilgi alanlarını belirtirseniz audience_combinations kullanamayacağınızı unutmayın. audience_combinations kullanıyorsanız bu özellikleri audience_attributes içinde değil, audience_combinations içinde belirtmeniz gerekir. Ancak audience_attributes'yi demografi gibi diğer özellik türleri için audience_combinations ile birlikte kullanmaya devam edebilirsiniz.

  2. İçerik üretici konusu analizleri: search_topics alanını kullanarak içerik konularının listesini sağlayın. API, belirtilen konularla ilgili içerik üreten alakalı içerik üreticileri döndürür. Getirilen veriler, country_locations içinde belirtilen ülkeye göre belirlenir. Bu seçeneğin yalnızca bir ülke için arama yapmaya izin verdiğini unutmayın.

    SearchTopics alanında desteklenen öğeler, CONTENT_TRENDING_INSIGHTS veya CREATOR_TOPIC_INSIGHTS özelliğiyle etiketlenmelidir. Desteklenen öğe özelliklerini almak için ListAudienceInsightsAttributes yöntemini kullanın.

    Not: search_brand seçeneğinin desteği v24.2'den itibaren sonlandırılmış olup v25 sürümünde tamamen kaldırılmıştır. Kullanıcılar bunun yerine search_topics kullanmaya geçmelidir.

  3. İçerik üretici analizleri: search_channels alanını kullanarak YouTube kanal kimliklerinin listesini sağlayın. API, bu kanallarla ilgili analizler döndürür.

Ek veriler ve yerel içerik üreticiler

Varsayılan olarak yalnızca temel analiz verileri döndürülür. Tekrarlanan alanı supplemental_data olarak ayarlayarak yanıtınızda isteğe bağlı özellikler ve ek veriler isteyebilirsiniz.

Örneğin, LOCAL_CREATOR_DATA enum değerini supplemental_data alanına ekleyerek yerel içerik üreticisi verileri isteyebilirsiniz. search_topics kullanarak içerik üreticileri arıyorsanız (ve konu, CREATOR_TOPIC_INSIGHTS özelliğiyle etiketlenmiş bir bilgi grafiği öğesiyse) API, yanıtın local_creator_insights alanını konum verilerini paylaşmayı kabul eden yerel içerik üreticilerle doldurur.

Yerel içerik üreticileri keşfetme ile ilgili aşağıdaki spesifikasyonlara dikkat edin:

  • Tanım: "Yerel içerik üreticiler", seçilen ülkede ikamet eden veya bu ülkeden içerik yayınlayan ve bu ülkede görüntülenen içerik üreticilerdir.
  • Kısıtlama: İstekte sub_country_locations ayarlandığında yerel içerik üreticilerin keşfedilmesi desteklenmez.
  • Özellikler: Desteklenen Bilgi Grafiği öğelerinin ve özelliklerinin listesini ListAudienceInsightsAttributes kullanarak alabilirsiniz.

generateCreatorInsights yöntemi, GenerateCreatorInsightsResponse nesnesini döndürür. Bu nesne aşağıdaki alanları içerir:

  • creator_insights: Temel ölçütlerinize uyan YouTubeCreatorInsights nesnelerin listesi.
  • local_creator_insights: Yerel içerik üreticiler için YouTubeCreatorInsights nesnelerinin listesi. Bu alan yalnızca LOCAL_CREATOR_DATA istendiyse ve kullanılan ölçüt search_topics ise doldurulur.

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][YouTubeMetrics] nesnesi aşağıdaki metrikleri içerir:

Bir içerik üreticinin orijinal markalı içerik iş ortaklıklarına uygun olup olmadığını belirlemek için partnership_opportunities seçeneğini işaretleyin. Listede CREATOR_PARTNERSHIPS değeri varsa içerik üretici uygundur.

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ına göre dağılım)
  • En popüler videolar
  • Kanal türü
  • Kanal içeriğiyle ilişkili diller
  • Alaka düzeyi puanı (yalnızca konu trendi aramaları için)

Trend olan analizler oluşturmak için GenerateTrendingInsights yöntemine istek gönderin. Bu yöntemin saniyede 5 sorgu (QPS) sınırı vardır. Kitle trendlerini mi yoksa konu trendlerini mi öğrenmek istediğinize bağlı olarak iki tür giriş alır. Trendleri almak istediğiniz ülkeyi belirtmeniz gerekir.

  1. Kitle trendleri: Yaş, cinsiyet ve kullanıcı ilgi alanları (yakın ilgi alanı, pazardaki kitle ve yaşamdaki önemli olay kitleleri dahil) gibi kitle özelliklerinin listesini sağlayabilirsiniz. API, bu kitlelerle ilgili trend olan analizlerin bir listesini döndürür. Bu listede, karşılaştırma dönemi boyunca trend değerindeki yüzde değişim gibi metrikler yer alır.

    Kullanılabilir kitle özelliklerini almak için ListAudienceInsightsAttributes işlevini kullanabilirsiniz. İlgi alanları gibi özellik istediğiniz boyutları sağlayarak KNOWLEDGE_GRAPH işlevini kullanabilirsiniz.

    KNOWLEDGE_GRAPH özelliklerinde bir veya daha fazla InsightsKnowledgeGraphEntityCapabilities etiketi bulunur. Trend Olan Analizler için desteklenen özelliklerin yanıt meta verilerinde alakalı etiketler bulunur.

    ContentCreatorInsightsService'a erişimi olan geliştiricilerin AudienceInsightsService.ListAudienceInsightsAttributes'a da otomatik olarak erişebileceğini unutmayın. AudienceInsightsService içindeki diğer uç noktalar için bağımsız bir izin verilenler listesi süreci gerekir.

    ListAudienceInsightsAttributes hakkında ek dokümanları Kitle Analizi kılavuzunda bulabilirsiniz.

  2. Kitle trendleri: Yaş, cinsiyet ve kullanıcı ilgi alanları (yakın ilgi alanı, pazardaki kitle ve yaşamdaki önemli olay kitleleri dahil) gibi kitle özelliklerinin bir listesini sağlayabilirsiniz. API, bu kitlelerle ilgili trend olan analizlerin bir listesini döndürür. Bu listede, karşılaştırma döneminde trendin değerindeki yüzde değişim gibi metrikler yer alır.

    Kullanılabilir kitle özelliklerini ListAudienceInsightsAttributes yöntemini kullanarak alabilirsiniz. Bunun için, özelliklerini istediğiniz boyutları (ör. ilgi alanları için KNOWLEDGE_GRAPH) sağlamanız gerekir.

    Google Ads API v23'ten itibaren audience_combinations kullanarak karmaşık kitle özelliği ilişkileri belirtebilirsiniz. Bu alan, audience_attributes ile mümkün olmayan boole mantığı (VE/VEYA) kullanarak kitleleri tanımlamanıza olanak tanır.

    audience_attributes, birleştirilmiş (VEYA ile birleştirilmiş) özellikler listesine göre hedefleme için uygun olsa da (ör. "spor" VEYA "seyahat" VEYA ... ile ilgilenen kullanıcılar) audience_combinations daha ayrıntılı kontrol sunar. audience_combinations içindeki her InsightsAudienceAttributeGroup, özellikleri mantıksal bir VEYA ile birleştirir. Bu gruplar daha sonra mantıksal bir VE ile birleştirilir.

    Örneğin, ("Cilt bakımı" VEYA "Saç bakımı") İLE "Kozmetik" ile de ilgilenen bir kitleyi hedeflemek için InsightsAudienceAttributeGroup içinde iki audience_combinations öğesi kullanırsınız. "Cilt bakımı", "Saç bakımı" ve "Kozmetik", Bilgi Grafiği varlıklarıyla (ör. Kozmetik için /m/014trl) temsil edilen ilgi alanlarıdır. İlk grupta "Cilt bakımı" ve "Saç bakımı" ile ilgili bilgi grafiği öğesi özellikleri, ikinci grupta ise "Kozmetik" ile ilgili bilgi grafiği öğesi özelliği yer alır.

    audience_attributes bölümünde Bilgi Grafiği varlıklarını, Ürün ve Hizmet Kategorilerini veya kullanıcı ilgi alanlarını belirtirseniz audience_combinations kullanamayacağınızı unutmayın. audience_combinations kullanıyorsanız bu özellikleri audience_attributes içinde değil, audience_combinations içinde belirtmeniz gerekir. Ancak audience_attributes'yi demografi gibi diğer özellik türleri için audience_combinations ile birlikte kullanmaya devam edebilirsiniz.

  3. Konu trendleri: İçerik konularının listesini sağlayın. API, bu konularla ilgili trend olan analizlerin bir listesini döndürür. Bu listede, karşılaştırma döneminde trendin değerindeki yüzde değişim gibi metrikler yer alır.

İçerik üretici analizleri oluşturmaya benzer şekilde, tekrarlanan alanı supplemental_data olarak ayarlayarak trend olan analizlerde isteğe bağlı özellikler isteyebilirsiniz.LOCAL_CREATOR_DATA

Trend olan içerik isteğinizde search_topics kullanılıyorsa bu, döndürülen TrendInsight nesnelerindeki related_local_creators alanını, konum verilerini paylaşmayı kabul eden ve istenen konuyla ilgili yerel içerik üreticilerle doldurur. Yerel içerik üreticilerin keşfedilmesi, aynı tanıma ve kısıtlamalara (ör. sub_country_locations ile uyumlu olmama) tabidir.

Önceki
Kitle analizi