YouTube karşılaştırmaları

BenchmarksService, reklamverenlerin ve ajansların YouTube reklam performanslarını sektör karşılaştırmalarıyla kıyaslamasına olanak tanır. Bu hizmeti kullanarak kampanyalarınızın hedeflenen sektörlere göre veya belirli ürün ve hizmet kategorilerindeki tüm reklamverenlere kıyasla nasıl performans gösterdiğini değerlendirebilirsiniz.

Temel özellikler

BenchmarksService ile şunları yapabilirsiniz:

  • Performansı karşılaştırma: Bir müşterinin ortalama oran metriklerini (BGBM, GBM, TO ve görüntülenebilirlik gibi) toplu sektör ortalamalarıyla karşılaştırın.
  • Pazar payını analiz etme: Görünürlük payı (göreli gösterimler) ve harcama payı aracılığıyla müşterinin pazardaki göreli varlığını anlayın.
  • Rekabet durumunu değerlendirme: Temel boyutlardaki performansı rekabetçi katmanlara (ör. Pazar Lideri veya Rakip) ayıran yüzdelik dilim metriklerini kullanarak müşterinin rekabet durumunu ölçün.
  • Zamana göre segmentlere ayırma: Karşılaştırma metriklerini haftalık, aylık veya üç aylık zaman ayrıntı düzeylerine göre gruplandırın.
  • Desteklenen karşılaştırma boyutlarını keşfedin: Kullanılabilir tarih aralıklarını, coğrafi konumları, reklamcılık ürünlerini ve karşılaştırma kaynaklarını (hedeflenen sektörler veya ürün ve hizmet kategorileri) sorgulayın.

Keşif yöntemleri

Karşılaştırma metrikleri oluşturmadan önce, istekleriniz için geçerli parametreleri ve kapsam ölçütlerini almak üzere keşif yöntemlerini kullanın.

Müsait tarihleri listele

ListBenchmarksAvailableDates yöntemi, ListBenchmarksAvailableDatesResponse içinde karşılaştırma verilerini destekleyen geçmiş tarih aralıklarını döndürür.

Yanıtta iki farklı tarih aralığı verilmiştir:

  • supported_dates: Karşılaştırma metriklerinin desteklendiği genel tarih aralığı (dahil). Karşılaştırma istekleri bu aralıktaki tarihleri sorgulayabilir.
  • supported_dates_for_all_metrics (v25 ve sonraki sürümlerde): Karşılaştırma metriklerinin tamamını destekleyen bir supported_dates alt kümesi. Belirli metrikler (özellikle müşteri payı metrikleri (share_of_voice ve share_of_spend) ve karşılaştırma kaynağının ortalama oran metrikleri) sınırlı veri kullanılabilirliği nedeniyle yalnızca bu tarih aralığında kullanılabilir. İstenen date_range, supported_dates_for_all_metrics aralığına tamamen girmiyorsa bu metrikler yanıttan çıkarılır.

Konumları listeleyin

ListBenchmarksLocations yöntemi, karşılaştırma verilerini destekleyen coğrafi konumların (ör. ülkeler) listesini döndürür.

Yanıttaki her BenchmarksLocation şunları içerir:

  • location_name: İngilizce benzersiz konum adı (ör. "United States").
  • location_type: Google Ads API'de target_type değerine karşılık gelen konum türü (ör. "Country").
  • location_info: Coğrafi hedef sabitini (ör. geo_target_constant: "geoTargetConstants/2840") içeren bir LocationInfo nesnesi.

Ürünleri listele

ListBenchmarksProducts yöntemi, karşılaştırma için kullanılabilen ürünlerin ve pazarlama hedeflerinin listesini döndürür.

Her BenchmarksProductMetadata girişi şunları içerir:

  • product_name: Kullanıcı dostu ürün adı.
  • product_code: Ürünün benzersiz tanımlayıcı dizesi. ProductFilter oluşturulurken kullanılır.
  • marketing_objective: İlişkili pazarlama hedefi (BenchmarksMarketingObjective):
    • AWARENESS: Marka veya ürün bilinirliğini artırmak için tasarlanmış kampanyalar.
    • CONSIDERATION: Potansiyel müşterileri markayı veya ürünleri değerlendirmeye teşvik etmek için tasarlanmış kampanyalar.
    • ACTION: Belirli bir dönüşüm işlemini artırmak için tasarlanmış kampanyalardır.

Karşılaştırma kaynaklarını listeleme

ListBenchmarksSources yöntemi, mevcut karşılaştırma kaynaklarını alır. BenchmarksSourceType kullanarak alınacak kaynak türlerini belirtin:

  • INDUSTRY_VERTICAL: Sektör segmentlerinin sınıflandırmaları (ör. "Technology" veya "Finance").
  • CATEGORY (v25 ve sonraki sürümlerde): Ürün ve Hizmet Kategorileri (ör. "/Apparel/Clothing"). Kategoriler, tüm reklamverenlerle karşılaştırma yaparken karşılaştırmanın kapsamını belirlemek için filtre olarak kullanılabilir.

Yanıt, aşağıdakilerden birini içeren BenchmarksSourceMetadata nesnelerinin listesini döndürür:

  • IndustryVerticalInfo: industry_vertical_name, industry_vertical_id ve parent_industry_vertical_id (varsa) bilgilerini içerir.
  • CategoryInfo (v25 ve sonraki sürümlerde): category_name, category_id ve category_path (tam kategori hiyerarşisi) değerlerini içerir.

Karşılaştırma metrikleri oluşturma

Bir müşterinin YouTube reklam metriklerini sektör karşılaştırmalarıyla karşılaştırmak için GenerateBenchmarksMetrics yöntemini çağırın.

İstek parametreleri

GenerateBenchmarksMetricsRequest, analizin kapsamını belirler. En azından bir istemci customer_id, coğrafi location (LocationInfo), bir benchmarks_source (industry_vertical_id veya v25 ve sonraki sürümlerde category_filter kapsamındaki all_advertisers) ve bir product_filter belirtmeniz gerekir. İsteğe bağlı olarak şunları yapabilirsiniz:

  • date_range belirtin (atlanırsa veriler, mevcut verilerin bulunduğu en son çeyrek için döndürülür).
  • Metrikleri breakdown_definition ile gruplandırın.
  • Üç karakterli bir ISO 4217 currency_code belirtin (atlanırsa BGBM ve maliyet gibi parasal metrikler varsayılan olarak USD olur).
  • Planlama yapılan müşteri için kullanıcı tanımlı bir customer_benchmarks_group adı belirtin.
  • supplemental_data üzerinden PERCENTILE_DATA gibi ek özellikler isteyin (25 ve sonraki sürümlerde).

Parametre tanımlarının ve koşullarının tamamı için GenerateBenchmarksMetricsRequest referans dokümanlarına bakın.

Tarih dökümleri

BenchmarksTimeGranularity kullanarak breakdown_definition.date_breakdown ayarını yaparak metrikleri gruplandırabilirsiniz. date_breakdown ayarlandığında GenerateBenchmarksMetricsRequest içindeki date_range zorunludur ve seçilen ayrıntı düzeyinin sınırlarıyla uyumlu olmalıdır:

  • WEEK: Metrikleri haftaya göre birleştirir. date_range pazar günü başlayıp cumartesi günü sona ermelidir (Bunun ISO 8601'den farklı olduğunu unutmayın).
  • MONTH: Metrikleri aya göre toplar. date_range, ayın ilk günü başlayıp son günü bitmelidir.
  • QUARTER: Metrikleri takvim yılındaki çeyreğe göre birleştirir. date_range, çeyreğin ilk gününde başlayıp son gününde bitmelidir.

Yanıt metrikleri

GenerateBenchmarksMetricsResponse şunları döndürür:

  • customer_metrics (25 ve sonraki sürümlerde CustomerMetrics türünde; 24 ve önceki sürümlerde yalnızca average_rate_metrics içeren Metrics türünde): Bir müşterinin YouTube reklam performansını temsil eden metrikler. Şunları içerir:
    • average_rate_metrics: Müşteri için ortalama oran metrikleri.
    • share_metrics (v25 ve sonraki sürümlerde): Göreceli pazar varlığı metrikleri (share_of_voice ve share_of_spend). Yalnızca benchmarks_source, all_advertisers = true'yı seçtiğinde (category_filter ayarlanmış olarak) ve date_range, supported_dates_for_all_metrics kapsamına girdiğinde doldurulur.
    • aggregate_metrics (v25 ve sonraki sürümlerde): Müşteri için toplu toplamlar (ör. cost, impressions, clicks ve video_trueview_views).
    • percentile_metrics (v25 ve sonraki sürümlerde): Temel boyutlar genelinde rekabetçi konum yüzdelik dilimleri.
  • average_benchmarks_metrics: Seçilen karşılaştırma kaynağındaki birleştirilmiş oran metrikleri (RateMetrics).
  • breakdown_metrics: breakdown_definition içinde tanımlanan dökümlere göre segmentlere ayrılmış metriklerin listesi.

Tam alan spesifikasyonları için GenerateBenchmarksMetricsResponse referans belgelerine bakın.

Yüzdelik metrikler

Yüzdelik dilim metrikleri, müşterinin kapsamlı analizdeki diğer reklamverenler arasındaki rekabetçi konumunu yüzdelik dilim katmanları olarak gösterir.

Ön koşullar

Yüzdelik dilim metriklerini almak için isteğinizin aşağıdaki şartları karşılaması gerekir:

  1. Karşılaştırma kaynağı: benchmarks_source, all_advertisers = true seçeneğini belirlemelidir.
  2. Kategori filtresi: category_filter sağlanmalıdır. Bu filtre, ListBenchmarksSources adresinden alınan bir veya daha fazla geçerli category_ids içermelidir.
  3. Ek veriler: GenerateBenchmarksMetricsRequest içindeki supplemental_data alanına PERCENTILE_DATA eklemeniz gerekir.

Yüzdelik dilimler

Müşterinin performansı, aşağıdaki BenchmarksCustomerPercentileTier enum değerlerinden birine göre sınıflandırılır:

  • DEVELOPING: 10. yüzdelik dilimin altında ([0%, 10%)).
  • ENTRY_LEVEL: 10. ila 25. yüzdelik dilim ([10%, 25%)).
  • EMERGING_PLAYER: 25. ila 50. yüzdelik dilim ([25%, 50%)).
  • COMPETITOR: 50. ila 75. yüzdelik dilim ([50%, 75%)).
  • STRONG_COMPETITOR: 75. ila 90. yüzdelik dilim ([75%, 90%)).
  • MARKET_LEADER: 90. yüzdelik dilimde veya üzerinde ([90%, 100%]).

Örnek istek

Aşağıdaki örnekte, müşterisinin YouTube reklam performansını /Apparel/Clothing kategorisinde reklam yayınlayan diğer reklamverenlerle karşılaştıran bir kullanıcı için yüzdelik dilim katmanlarıyla karşılaştırma metrikleri oluşturmaya yönelik REST JSON istek yükü gösterilmektedir:

{
  "customerId": "1234567890",
  "location": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "benchmarksSource": {
    "allAdvertisers": true
  },
  "categoryFilter": {
    "categoryIds": ["10176"]
  },
  "productFilter": {
    "marketingObjectiveList": {
      "marketingObjectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplementalData": [
    "PERCENTILE_DATA"
  ]
}

İstenen ek yüzdelik dilim verilerini içeren yanıt:

{
  "customerMetrics": {
    "averageRateMetrics": {
      "averageCpm": 5.42,
      "clickThroughRate": 0.0185
    },
    "shareMetrics": {
      "shareOfVoice": 0.0345,
      "shareOfSpend": 0.0410
    },
    "aggregateMetrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentileMetrics": {
      "costPercentileTier": "STRONG_COMPETITOR",
      "impressionsPercentileTier": "STRONG_COMPETITOR",
      "clicksPercentileTier": "MARKET_LEADER",
      "videoTrueviewViewsPercentileTier": "COMPETITOR",
      "viewableImpressionsPercentileTier": "STRONG_COMPETITOR",
      "interactionsPercentileTier": "MARKET_LEADER",
      "engagementsPercentileTier": "COMPETITOR"
    }
  },
  "averageBenchmarksMetrics": {
    "averageRateMetrics": {
      "averageCpm": 6.15,
      "clickThroughRate": 0.0142
    }
  }
}

Hata işleme

BenchmarksService çağrılırken BenchmarksError'deki karşılaştırma sorgularına özgü hatalarla karşılaşabilirsiniz:

  • MAX_QUERY_COMPLEXITY_EXCEEDED: İstenen girişlerin kombinasyonu, işlenemeyecek kadar karmaşık. Sorgu karmaşıklığını azaltmak için:
    • Daha spesifik veya ayrıntılı bir karşılaştırma kaynağı ya da kategori filtresi seçin.
    • İstenen date_range kısaltın.
    • product_filter ürün sayısını azaltın.
  • NO_METRICS_FOUND (25. ve sonraki sürümlerde): İstenen giriş kombinasyonu için metrik bulunamadı (ör. hiçbir reklamverenin kampanya yayınlamadığı belirli bir konum ve tarih aralığındaki niş bir kategori). Kategori, konum, tarih aralığı veya ürünleri değiştirmeyi deneyin.

Genel API hata işleme ve en iyi uygulamalar için Hata işleme kılavuzuna bakın.

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
YouTube İçerik Üretici Analizleri