YouTube İçerik Üretici Analizleri

ContentCreatorInsightsService'daki içerik üretici analizleri özelliğiyle YouTube içerik üreticilerini keşfedin ve onlarla ilgili analizlere ulaşın. Bu hizmet, ajansların ve reklamverenlerin hedef kitlelerine uygun içerik üreticiler bulmasına yardımcı olur.

API'nin dört ana işlevi vardır:

  1. İçerik üretici keşfedilebilirliği: Belirli bir konu, demografi, kitle veya içerik üretici özelliği grubu için alakalı içerik üreticileri bulun.
  2. İçerik üretici konu analizleri: Belirli konular hakkında içerik üreten alakalı içerik üreticilerle ilgili analizler alın.
  3. İçerik üretici analizleri: Belirli YouTube kanalları hakkında abone sayısı, görüntüleme sayısı ve kitle demografisi gibi analizleri alın.
  4. Trend analizleri: Belirli kitlelere veya konulara göre belirli trendler hakkında analizler alın.

Yerel içerik üretici bulma (belirli bir ülkede bulunan veya o ülkeden içerik yayınlayan ve o ülkede görüntülenen içerik üreticileri bulma), konuya dayalı içerik üretici bulma veya trend analizleri kullanılırken ek veriler istenerek desteklenir. Ek veri isteğinde bulunarak konuya dayalı trend analizleri için marka yaklaşımı analizleri de isteyebilirsiniz.

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şme imzalayan iş ortakları, YouTube içerik üreticilerini ve içeriklerini keşfetmek için standart Google Ads istemci kitaplıklarını kullanabilir. İş ortaklarının uygun olabilmesi için aşağıdaki koşulları karşılaması gerekir:

  • Google Ads API'yi entegre eden bir planlama aracına veya kullanıcı arayüzüne sahip olmalıdır.
  • Potansiyel reklam fırsatları için YouTube içeriklerini ve içerik üreticilerini keşfetmek üzere API'yi kullanma
  • Uygunluk durumunuzu doğrulamak için ön değerlendirmeyi tamamlayın.
  • Veri kullanımı şartlarına uymak ve periyodik veri denetimlerinden geçmek
  • Google Ads API hizmet şartlarını ve ilgili veri kullanımı politikası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 saniyedeki sorgu sayısı (QPS) sınırı 5'tir. İçerik üretici keşfedilebilirliği, konuya dayalı içerik üretici araması veya kanala özel içerik üretici analizleri isteyip istemediğinize bağlı olarak farklı ölçütleri kabul eder. Hedef ülke konumlarını country_locations içinde belirtmeniz gerekir.

  1. İçerik üretici keşfedilebilirliği (search_attributes): Kitleleri bu özelliklerle eşleşen içerik üreticileri bulmak için search_attributes alanını kullanarak yaş, cinsiyet ve kullanıcı ilgi alanları (yakın ilgi alanı, pazardaki kitle ve yaşamdaki önemli olay kitleleri) gibi kitle özelliklerinin listesini sağlayın. İçerikleri belirli özelliklerle eşleşen içerik üreticileri filtrelemek için içerik üretici özellikleri de sağlayabilirsiniz.

    İlgi alanları için KNOWLEDGE_GRAPH gibi ihtiyacınız olan boyutları belirterek ListAudienceInsightsAttributes ile kullanılabilir kitle özelliklerini alın. Özellikleri Boole AND ve OR gruplarını kullanarak birleştirmek için Karmaşık kitle kombinasyonları bölümünde açıklandığı şekilde audience_combinations kullanın.

  2. İçerik üretici konu analizleri (search_topics): 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. Veriler, country_locations parametresinde belirtilen ülke için getirilir (bu seçenek, istek başına tek bir ülkeyi destekler).

    search_topics içindeki desteklenen varlıklar, CONTENT_TRENDING_INSIGHTS veya CREATOR_TOPIC_INSIGHTS özelliğiyle etiketlenmelidir. Desteklenen varlık özelliklerini almak için ListAudienceInsightsAttributes kullanın.

  3. İçerik üretici analizleri (search_channels): search_channels alanını kullanarak YouTube kanalı kimliklerinin, YouTube kanalı herkese açık kullanıcı adlarının (youtube_channel_handles, v25 ve sonraki sürümlerde kullanılabilir) veya her ikisinin bir kombinasyonunun listesini sağlayın. API, bu kanallarla ilgili analizler döndürür.

Karmaşık kitle kombinasyonları

Hem GenerateCreatorInsights hem de GenerateTrendingInsights platformunda, audience_combinations kullanarak karmaşık kitle özelliği ilişkileri tanımlayabilirsiniz. Bu alan, kitle özelliklerini audience_attributes'nin düz birleşim (OR) davranışının ötesinde Boole mantığıyla (AND ve OR) birleştirmenize olanak tanır:

  • audience_combinations içindeki her InsightsAudienceAttributeGroup, özelliklerini mantıksal bir OR ile birleştirir.
  • audience_combinations içindeki birden fazla InsightsAudienceAttributeGroup öğesi, mantıksal bir AND ile birleştirilir.

Örneğin, ("Skin care" OR "Hair care") AND "Cosmetics" ile ilgilenen bir kitleyi hedeflemek için audience_combinations içine iki InsightsAudienceAttributeGroup öğesi ekleyin:

  1. "Skin care" ve "Hair care" için Bilgi Grafiği varlık özelliklerini içeren 1. grup.
  2. "Cosmetics" için Bilgi Grafiği varlık özelliğini içeren 2. grup (ör. /m/014trl).

Ek veriler ve yerel içerik üreticiler

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

Örneğin, LOCAL_CREATOR_DATA enum değerini supplemental_data alanına ekleyerek yerel içerik üretici verilerini isteyebilirsiniz. search_topics kullanarak içerik üretici ararsanız (ve konu, CREATOR_TOPIC_INSIGHTS özelliğiyle etiketlenmiş bir Bilgi Grafiği varlığıysa) API, yanıttaki local_creator_insights alanını konum verilerini paylaşmayı kabul eden yerel içerik üreticilerle doldurur.

Yerel içerik üretici bulma için aşağıdaki özellikleri göz önünde bulundurun:

  • Tanım: Yerel içerik üreticiler, seçilen ülkede bulunan 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 üretici bulma desteklenmez.
  • Özellikler: Desteklenen Bilgi Grafiği varlıklarının ve özelliklerinin listesini ListAudienceInsightsAttributes kullanarak alabilirsiniz.

GenerateCreatorInsights yöntemi, aşağıdaki alanları içeren bir GenerateCreatorInsightsResponse nesnesi döndürür:

  • creator_insights: Temel ölçütlerinizle eşleşen YouTubeCreatorInsights nesnelerinin 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 şunları içerir:

  • creator_name: Resmi oluşturan kişinin adı.
  • creator_channels: YouTubeChannelInsights nesnelerinin listesi. Kanal ayrıntıları ve channel_metrics (YouTubeMetrics), creator_channels içindeki her YouTubeChannelInsights nesnesinde döndürülür.

YouTubeMetrics nesnesi şunları içerir:

  • Abone, görüntüleme ve video sayıları
  • Kanalın tüm videolarındaki toplam beğeni, paylaşım ve yorum sayısı
  • Ömür boyu etkileşim oranı (toplam etkileşimin toplam görüntüleme sayısına bölümü)
  • Son 28 günde video başına ortalama görüntüleme, beğeni, paylaşım ve yorum sayısı
  • Shorts görüntüleme ve video sayıları
  • İçerik üreticinin aktif bir Shorts içerik üreticisi veya aktif bir canlı yayın içerik üreticisi olup olmadığı (son 90 gün içinde bir içerik yayınlamış olması gerekir)
  • İş ortaklığı fırsatları

Etkileşim oranı ve video başına ortalama görüntüleme, beğeni ve yorum sayısı, yalnızca içerik üretici paylaşmayı kabul ettiğinde doldurulan herkese açık olmayan metriklerdir.

Bir içerik üreticinin orijinal markalı içerik iş ortaklıklarına uygun olup olmadığını kontrol etmek için partnership_opportunities değerini inceleyin. Listede CREATOR_PARTNERSHIPS değeri varsa içerik üretici uygundur.

YouTubeChannelInsights nesnesi, bir YouTube kanalı hakkında aşağıdaki bilgileri içerir:

  • Kanal adı, kimliği, herkese açık kullanıcı adı, URL'si, açıklaması ve küçük resim URL'si
  • Kanalın oluşturulma tarihi ve ilişkili ülke
  • Kanal metrikleri
  • Kanal kitlesi özellikleri (ör. yaş, cinsiyet ve kullanıcı ilgi alanı dökümü)
  • Kanal özellikleri (kanalın içeriğiyle ilişkili özellikler)
  • En popüler videolar
  • Kanal türü ve içerik dilleri
  • Alaka düzeyi puanı (yalnızca konu trendi aramaları için)
  • İçerik üreticinin, herkese açık olmayan metrikleri paylaşma izni verip vermediği

GenerateCreatorInsights istek ve yanıt referansı

Aşağıdaki uç noktada ContentCreatorInsightsService üzerinde GenerateCreatorInsights yöntemini çağırın:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

Aşağıdaki tabloda GenerateCreatorInsightsRequest sayfasındaki alanlar özetlenmiştir:

Alan yolu Gereksinim Biçim ve kısıtlamalar
customer_id Zorunlu Kısa çizgi içermeyen 10 haneli müşteri kimliği (string).
customer_insights_group Zorunlu Planlaması yapılan müşterinin veya markanın kullanıcı tarafından tanımlanan adı (string).
country_locations[] Zorunlu Ülke LocationInfo nesnelerinin listesi (geo_target_constant, örneğin "geoTargetConstants/2840"). search_topics kullanıldığında tek bir ülke içermelidir.
sub_country_locations[] İsteğe bağlı Ülke altı LocationInfo filtreleri; yalnızca search_attributes ile desteklenir ve LOCAL_CREATOR_DATA ile uyumlu değildir.
search_attributes criteria (oneof) SearchAttributes şunları içerir:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (audience_combinations kullanılmadığında user_interest, entity veya category eklenir).
• audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup öğe.
• creator_attributes[]: CREATOR_ATTRIBUTE özelliğine sahip entity Bilgi Grafiği öğesi.
search_topics criteria (oneof) entities[] içeren SearchTopics (CREATOR_TOPIC_INSIGHTS veya CONTENT_TRENDING_INSIGHTS ile etiketlenmiş knowledge_graph_machine_id içeren AudienceInsightsEntity).
search_channels criteria (oneof) youtube_channels[] (channel_id) ve/veya youtube_channel_handles[] (@ ile başlayan herkese açık kullanıcı adları, örneğin "@youtubecreators") içeren YouTubeChannels.
supplemental_data[] İsteğe bağlı ContentCreatorInsightsSupplementalData değerleri. local_creator_insights[] değerini doldurmak için tek ülkeli search_topics isteğinde (CREATOR_TOPIC_INSIGHTS içeren varlıklar için) LOCAL_CREATOR_DATA değerini ayarlayın.
insights_application_info İsteğe bağlı İsteği gönderen uygulamayla ilgili AdditionalApplicationInfo meta verileri.

GenerateCreatorInsightsResponse mesajı aşağıdaki alanları döndürür:

Yanıt alanı Tür Açıklama
creator_insights[] YouTubeCreatorInsights Temel ölçütlerinizle (creator_name ve creator_channels[]) eşleşen içerik üreticiler.
local_creator_insights[] YouTubeCreatorInsights Konum verilerini paylaşmayı kabul eden yerel içerik üreticiler (CREATOR_TOPIC_INSIGHTS içeren bir varlıkta search_topics ile LOCAL_CREATOR_DATA istendiğinde doldurulur).
creator_channels[] YouTubeChannelInsights Meta veriler: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location ve data_sharing_consent_given.
Analizler ve içerik: channel_audience_attributes[] (izne tabi), channel_attributes[], top_videos[], language_distributions[], relevance_score (yalnızca search_topics içeren GenerateTrendingInsights için doldurulur) ve channel_metrics.
channel_metrics YouTubeMetrics Herkese açık metrikler: subscriber_count, views_count, video_count, likes_count, shares_count, comments_count, shorts_views_count, shorts_video_count, is_active_shorts_creator, is_active_live_stream_creator ve partnership_opportunities[].
İzne tabi metrikler: engagement_rate ve video başına 28 günlük ortalamalar (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

GenerateCreatorInsights REST isteği ve yanıtı örnekleri

Aşağıdaki örnekte, searchAttributes ile demografik audienceAttributes, boole audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics") ve creatorAttributes kullanan içerik üreticiler bulunur:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchAttributes": {
    "audienceAttributes": [
      {
        "ageRange": {
          "type": "AGE_RANGE_25_34"
        }
      },
      {
        "gender": {
          "type": "FEMALE"
        }
      }
    ],
    "audienceCombinations": [
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/015c4z"
            }
          },
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/018bb_"
            }
          }
        ]
      },
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/014trl"
            }
          }
        ]
      }
    ],
    "creatorAttributes": [
      {
        "entity": {
          "knowledgeGraphMachineId": "/m/014trl"
        }
      }
    ]
  }
}

Yerel içerik üreticilerin yanı sıra konuya dayalı içerik üreticileri de getirmek için searchTopics kullanın ve supplementalData içine "LOCAL_CREATOR_DATA" ekleyin:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "supplementalData": [
    "LOCAL_CREATOR_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/m/014trl"
      }
    ]
  }
}

Belirli YouTube kanallarıyla ilgili analizleri kanal kimliğine veya herkese açık kullanıcı adına göre almak için searchChannels kullanın:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchChannels": {
    "youtubeChannels": [
      {
        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
      }
    ],
    "youtubeChannelHandles": [
      "@exampleskincare"
    ]
  }
}

Başarılı bir GenerateCreatorInsightsResponse, creatorInsights[] (ve LOCAL_CREATOR_DATA istendiğinde localCreatorInsights[]) döndürür:

{
  "creatorInsights": [
    {
      "creatorName": "Example Skincare Creator",
      "creatorChannels": [
        {
          "displayName": "Example Skincare Channel",
          "youtubeChannel": {
            "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
          },
          "channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
          "handle": "@exampleskincare",
          "publishDate": "2020-03-15",
          "countryLocation": {
            "geoTargetConstant": "geoTargetConstants/2840"
          },
          "dataSharingConsentGiven": true,
          "channelMetrics": {
            "subscriberCount": "450000",
            "viewsCount": "38200000",
            "videoCount": "210",
            "likesCount": "1950000",
            "commentsCount": "84000",
            "engagementRate": 0.056,
            "averageViewsPerVideo": 62000.0,
            "shortsViewsCount": "14500000",
            "shortsVideoCount": "95",
            "isActiveShortsCreator": true,
            "isActiveLiveStreamCreator": false,
            "partnershipOpportunities": [
              "CREATOR_PARTNERSHIPS",
              "PARTNERSHIP_ADS"
            ]
          }
        }
      ]
    }
  ],
  "localCreatorInsights": []
}

Trend analizleri oluşturmak için GenerateTrendingInsights yöntemine bir istek gönderin. Bu yöntemin saniyedeki sorgu sayısı (QPS) sınırı 5'tir. Kitle trendlerini mi yoksa konu trendlerini mi istediğinize bağlı olarak iki tür girişi kabul eder ve hedef ülke konumu gerektirir.

  1. Kitle trendleri (search_audience): search_audience öğesinin audience_attributes alanında kitle özelliklerinin (yaş, cinsiyet ve kullanıcı ilgi alanları gibi) bir listesini sağlayın ve isteğe bağlı olarak özellikleri Boole AND/OR mantığıyla birleştirmek için audience_combinations kullanın. API, karşılaştırma dönemi boyunca trend değerindeki yüzde değişimi gibi metrikler de dahil olmak üzere bu kitlelerle ilgili trend analizlerinin bir listesini döndürür.

    ContentCreatorInsightsService erişimi olan geliştiriciler, AudienceInsightsService uygulamasındaki ListAudienceInsightsAttributes erişimine otomatik olarak sahip olur (Kitle analizi kılavuzuna bakın). AudienceInsightsService içindeki diğer uç noktalar için ayrı bir izin verilenler listesi gerekir.

  2. Konu trendleri (search_topics): search_topics alanında içerik konularının listesini sağlayın. API, karşılaştırma dönemi boyunca trendin değerindeki yüzde değişim de dahil olmak üzere bu konularla ilgili trend analizlerini döndürür. supplemental_data değerini ayarlayarak yerel içerik üreticiler veya marka yaklaşımı analizleri de isteyebilirsiniz.

    ListAudienceInsightsAttributes tarafından döndürülen KNOWLEDGE_GRAPH özellikleri, bir veya daha fazla InsightsKnowledgeGraphEntityCapabilities etiketi içerir. CONTENT_TRENDING_INSIGHTS olarak etiketlenen varlıklar, GenerateTrendingInsights içinde konu olarak desteklenir.

İçerik üretici analizleri oluşturmaya benzer şekilde, yinelenen alanı supplemental_data, LOCAL_CREATOR_DATA veya BRAND_SENTIMENT_DATA olarak ayarlayarak trend analizlerinde isteğe bağlı özellikler talep edebilirsiniz:

  • Yerel içerik üreticiler (LOCAL_CREATOR_DATA): Trend isteğiniz search_topics kullanıyorsa (ve konu, CREATOR_TOPIC_INSIGHTS özelliğiyle etiketlenmiş bir Bilgi Grafiği varlığıysa) supplemental_data değerini LOCAL_CREATOR_DATA olarak ayarlamak, döndürülen TrendInsight nesnelerindeki related_local_creators alanını, konum verilerini paylaşmayı kabul eden ilgili yerel içerik üreticilerle doldurur. Yerel içerik üretici bulma özelliği sub_country_locations ile uyumlu değil.
  • Marka yaklaşımı (BRAND_SENTIMENT_DATA): Trend isteğiniz search_topics kullanıyorsa ve istenen Bilgi Grafiği varlık konusu BRAND özelliğine sahipse supplemental_data parametresini BRAND_SENTIMENT_DATA olarak ayarlamak, döndürülen TrendInsight nesnelerindeki brand_sentiment_insights alanını doldurur.

Marka yaklaşımını ölçmek için Gemini yapay zeka modelleri kullanılarak markayla ilgili YouTube video içeriği analiz edilir ve yaklaşım olumlu, olumsuz veya tarafsız olarak kategorize edilir. Yalnızca video içeriği analiz edilir, kullanıcı yorumları dahil edilmez.

GenerateTrendingInsights yöntemi, her biri aşağıdakileri içeren TrendInsight nesnelerinin bir listesini döndürür:

  • trend_attribute: Trendin birincil AudienceInsightsAttributeMetadata.
  • trend_metrics: Karşılaştırma dönemindeki yüzde değişim gibi trendle ilgili metrikler.
  • trend: Trendin yönünü gösteren bir InsightsTrend değeri (EMERGING, RISING, SUSTAINED veya DECLINING). Değişikliğin boyutunu görmek için trend_metrics.trend_change_percent bölümüne bakın.
  • trend_data_points: Trend için geçmiş veri noktaları. Yalnızca search_topics kullanan trendler için doldurulur.
  • related_videos: Trend konusuyla ilişkili trend olan videolar için AudienceInsightsAttributeMetadata nesnelerinin listesi (yalnızca search_topics kullanan trendler için doldurulur). Bu özellikler için iç içe yerleştirilmiş YouTubeVideoAttributeMetadata, video düzeyindeki meta veriler (URL, küçük resim URL'si, görüntüleme ve beğeni sayıları) ve kanal düzeyindeki meta verilerle (kanal kimliği, adı ve URL'si) doldurulur.
  • related_creators: Trendin konusuyla ilgili içerik üreticiler için YouTubeCreatorInsights nesnelerinin listesi (yalnızca search_topics kullanan trendler için doldurulur).
  • related_local_creators: Trendin konusuyla ilgili olan ve konum verilerini paylaşmayı kabul eden yerel içerik üreticiler için YouTubeCreatorInsights nesnelerinin listesi. Yalnızca LOCAL_CREATOR_DATA istendiğinde doldurulur (Ek veriler, yerel içerik üreticiler ve marka yaklaşımı bölümüne bakın).
  • brand_sentiment_insights: Trend için BrandSentimentInsight nesnelerinin listesi (istek, BRAND özelliğine sahip bir varlık için search_topics kullanıp BRAND_SENTIMENT_DATA istediğinde doldurulur). Her BrandSentimentInsight nesnesi şunları içerir:
    • month: Marka algısının temsil ettiği ay (YYYY-MM biçiminde).
    • has_insufficient_data: Marka yaklaşımını hesaplamak için yeterli veri olup olmadığı.
    • sentiment_distributions: Olumlu, olumsuz ve tarafsız yaklaşım dağılımı. Bu değer, her bir yaklaşım için markayla ilgili videoların görüntüleme sayısının oranı olarak hesaplanır.
    • sentiment_summaries: Markayla ilgili içeriklerdeki olumlu ve olumsuz temaların yapay zeka tarafından oluşturulan özetleri ve her bir duygu için örnek videolar. Özetler yalnızca olumlu ve olumsuz yaklaşım için oluşturulur, nötr yaklaşım için oluşturulmaz.

Aşağıdaki uç noktada ContentCreatorInsightsService üzerinde GenerateTrendingInsights yöntemini çağırın:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

Aşağıdaki tabloda GenerateTrendingInsightsRequest sayfasındaki alanlar özetlenmiştir:

Alan yolu Gereksinim Biçim ve kısıtlamalar
customer_id Zorunlu Kısa çizgi içermeyen 10 haneli müşteri kimliği (string).
customer_insights_group Zorunlu Planlaması yapılan müşterinin veya markanın kullanıcı tarafından tanımlanan adı (string).
country_location Zorunlu Tek ülke LocationInfo (geo_target_constant, örneğin "geoTargetConstants/2840").
sub_country_locations[] İsteğe bağlı Ülke altı LocationInfo filtreleri; yalnızca search_audience için desteklenir ve LOCAL_CREATOR_DATA ile uyumlu değildir.
search_audience criteria (oneof) SearchAudience şunları içerir:
• audience_attributes[] (gerekli): age_range, gender, parental_status, income_range (audience_combinations kullanılmadığında user_interest, entity veya category).
• audience_combinations[] (isteğe bağlı): AND-of-ORs özellik grupları.
search_topics criteria (oneof) entities[] içeren SearchTopics (CONTENT_TRENDING_INSIGHTS ile etiketlenmiş knowledge_graph_machine_id içeren AudienceInsightsEntity).
supplemental_data[] İsteğe bağlı ContentCreatorInsightsSupplementalData değerleri:
• LOCAL_CREATOR_DATA: search_topics varlıkları için related_local_creators[] değerini CREATOR_TOPIC_INSIGHTS ile doldurur.
• BRAND_SENTIMENT_DATA: search_topics varlıkları için brand_sentiment_insights[] değerini BRAND ile doldurur.
insights_application_info İsteğe bağlı İsteği gönderen uygulamayla ilgili AdditionalApplicationInfo meta verileri.

GenerateTrendingInsightsResponse mesajı, trend_insights[] içinde TrendInsight girişlerini döndürür:

TrendInsight alanı Tür Açıklama
trend_attribute AudienceInsightsAttributeMetadata Trendin birincil özelliği (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics 3 aylık karşılaştırma dönemindeki metrikler (search_topics için views_count ve views_indexed_value; search_audience için audience_share; trend_change_percent).
trend InsightsTrend Trendin yönü (EMERGING, RISING, SUSTAINED veya DECLINING).
trend_data_points[] TrendInsightDataPoint Aylık geçmiş veriler (YYYY-MM biçiminde month ve trend_metrics); search_topics için doldurulur.
related_videos[] AudienceInsightsAttributeMetadata YouTubeVideoAttributeMetadata ile trend olan videolar; search_topics için dolduruldu.
related_creators[] YouTubeCreatorInsights Konuyla ilgili içerik üreticiler; search_topics için doldurulur.
related_local_creators[] YouTubeCreatorInsights İzin veren yerel içerik üreticiler; CREATOR_TOPIC_INSIGHTS içeren bir varlıkta LOCAL_CREATOR_DATA istendiğinde search_topics için doldurulur.
brand_sentiment_insights[] BrandSentimentInsight Aylık marka yaklaşımı (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); BRAND özelliğine sahip bir varlıkta BRAND_SENTIMENT_DATA istendiğinde search_topics için doldurulur.

Aşağıdaki örnekte, bir Bilgi Grafiği marka varlığı (/g/11example_brand, CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS ve BRAND ile etiketlenmiş) için searchTopics kullanılarak GenerateTrendingInsights çağrılır ve hem LOCAL_CREATOR_DATA hem de BRAND_SENTIMENT_DATA istenir:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocation": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "supplementalData": [
    "LOCAL_CREATOR_DATA",
    "BRAND_SENTIMENT_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/g/11example_brand"
      }
    ]
  }
}

Başarılı bir GenerateTrendingInsightsResponse, trendInsights[] içinde TrendInsight giriş döndürür:

{
  "trendInsights": [
    {
      "trendAttribute": {
        "dimension": "KNOWLEDGE_GRAPH",
        "displayName": "Example Skincare Brand",
        "attribute": {
          "entity": {
            "knowledgeGraphMachineId": "/g/11example_brand"
          }
        }
      },
      "trendMetrics": {
        "viewsCount": "18500000",
        "viewsIndexedValue": "82",
        "trendChangePercent": 0.24
      },
      "trend": "RISING",
      "trendDataPoints": [
        {
          "month": "2026-05",
          "trendMetrics": {
            "viewsCount": "18500000",
            "viewsIndexedValue": "82",
            "trendChangePercent": 0.08
          }
        }
      ],
      "brandSentimentInsights": [
        {
          "month": "2026-05",
          "hasInsufficientData": false,
          "sentimentDistributions": [
            {
              "sentiment": "SENTIMENT_POSITIVE",
              "sentimentShare": 0.68
            },
            {
              "sentiment": "SENTIMENT_NEUTRAL",
              "sentimentShare": 0.25
            },
            {
              "sentiment": "SENTIMENT_NEGATIVE",
              "sentimentShare": 0.07
            }
          ]
        }
      ],
      "relatedVideos": [],
      "relatedCreators": [],
      "relatedLocalCreators": []
    }
  ]
}

Google Issue Tracker

Destekle ilgili sorular sormak, hataları bildirmek veya özellik istekleri göndermek için Google Issue Tracker'ı kullanın. Google, isteklerinizi doğrudan Issue Tracker'da takip eder, önceliklendirir ve isteklerinizle ilgili güncellemeleri yayınlar. Daha fazla bilgi için Google Issue Tracker'da sorun oluşturma başlıklı makaleyi inceleyin.

Aşağıdaki Issue Tracker şablonlarından birini kullanarak sorun oluşturun:

Google'ın isteğinizi yeniden oluşturabilmesi ve önceliklendirebilmesi için şablondaki tüm alanları ayrıntılı bilgilerle doldurun. Google, eksik raporları kapatabilir ve eksik ayrıntıları içeren yeni bir sorun göndermenizi isteyebilir.

Önceki
Kitle analizi
Sonraki
YouTube karşılaştırmaları