YouTube karşılaştırmaları

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

Temel özellikler

BenchmarksService ile yapabilecekleriniz:

  • Performansı karşılaştırma: Bir müşterinin ortalama oran metriklerini (ör. BGBM, GBM, TO ve görüntülenebilirlik) toplu sektör ortalamalarıyla karşılaştırarak değerlendirin.
  • Pazar payını analiz edin: Görünürlük payı (gösterim payı) ve harcama payı aracılığıyla müşterinin göreceli pazar varlığını anlayın.
  • Rekabetteki durumu değerlendirme: Temel boyutlardaki performansı rekabetçi katmanlara (ör. Pazar Lideri veya Rakip) göre sınıflandıran yüzdelik metrikleri kullanarak bir müşterinin rekabetteki konumunu ö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ı (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.

Kullanılabilir 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ıt, iki farklı tarih aralığı sunuyor:

  • 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: Karşılaştırma metriklerinin tamamını destekleyen supported_dates alt kümesi. Belirli metrikler (özellikle müşteri payı metrikleri share_of_voice ve share_of_spend ile 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 içinde tamamen yer almıyorsa 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 dilinde benzersiz konum adı (örneğin, "United States").
  • location_type: Google Ads API'deki target_type öğesine karşılık gelen konum türü (örneğin, "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ün ve pazarlama hedefleri 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ış kampanyalar.

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

ListBenchmarksSources yöntemi, kullanılabilir 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ı (örneğin, "Teknoloji" veya "Finans").
  • CATEGORY: Ürün ve hizmet kategorileri (örneğin, "/Giyim/Kıyafet"). 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 (geçerliyse) içerir.
  • CategoryInfo: category_name, category_id ve category_path (tam kategori hiyerarşisi) 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 numaralı telefonu arayın.

İstek parametreleri

GenerateBenchmarksMetricsRequest kapsamları analizi belirler. En azından bir müşteri customer_id, coğrafi location, bir benchmarks_source (ör. belirli bir hedeflenen sektör veya category_filter kapsamındaki tüm reklamverenler) ve bir product_filter belirtmeniz gerekir. İsteğe bağlı olarak date_range sağlayabilir, grup metriklerini breakdown_definition ile birleştirebilir, currency_code belirtebilir veya supplemental_data üzerinden PERCENTILE_DATA gibi ek özellikler isteyebilirsiniz.

Parametre tanımları ve koşulları hakkında ayrıntılı bilgi için GenerateBenchmarksMetricsRequest referans belgelerine bakın.

Tarihe göre dökümler

BenchmarksTimeGranularity kullanarak breakdown_definition.date_breakdown değerini ayarlayarak metrikleri gruplandırabilirsiniz:

  • WEEK: Metrikleri haftaya göre toplar. date_range, Pazar günü başlayıp Cumartesi günü sona ermelidir (ISO 8601'den farklı olduğunu unutmayın).
  • MONTH: Metrikleri aya göre toplar. date_range, ayın ilk günü başlayıp ayın son günü sona ermelidir.
  • QUARTER: Metrikleri takvim çeyreğine göre toplar. date_range, çeyreğin ilk günü başlayıp çeyreğin son günü sona ermelidir.

Yanıt metrikleri

GenerateBenchmarksMetricsResponse şu değerleri döndürür:

Alan spesifikasyonlarının tamamı için GenerateBenchmarksMetricsResponse referans belgelerine bakın.

Yüzdelik metrikler

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

Ön koşullar

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

  1. Karşılaştırma kaynağı: benchmarks_source seçilmelidir all_advertisers = true.
  2. Kategori filtresi: ListBenchmarksSources kaynağından alınan bir veya daha fazla geçerli category_ids içeren category_filter sağlanmalıdır.
  3. Ek veriler: supplemental_data alanına GenerateBenchmarksMetricsRequest içinde PERCENTILE_DATA eklemeniz gerekir.

Yüzdelik dilimler

Müşterinin performansı, BenchmarksCustomerPercentileTier enum değerlerinden birine göre sınıflandırılır (düşük katmanlar için DEVELOPING'dan en iyi performansı gösteren reklamverenler için MARKET_LEADER'a kadar). Her katmanın açıklaması ve yüzdelik sınırları için BenchmarksCustomerPercentileTier referans belgelerine bakın.

Örnek istek

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

{
  "customer_id": "1234567890",
  "location": {
    "geo_target_constant": "geoTargetConstants/2840"
  },
  "benchmarks_source": {
    "all_advertisers": true
  },
  "category_filter": {
    "category_ids": ["10176"]
  },
  "product_filter": {
    "marketing_objective_list": {
      "marketing_objectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplemental_data": [
    "PERCENTILE_DATA"
  ]
}

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

{
  "customer_metrics": {
    "average_rate_metrics": {
      "average_cpm": 5.42,
      "click_through_rate": 0.0185
    },
    "share_metrics": {
      "share_of_voice": 0.0345,
      "share_of_spend": 0.0410
    },
    "aggregate_metrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentile_metrics": {
      "cost_percentile_tier": "STRONG_COMPETITOR",
      "impressions_percentile_tier": "STRONG_COMPETITOR",
      "clicks_percentile_tier": "MARKET_LEADER",
      "video_trueview_views_percentile_tier": "COMPETITOR",
      "viewable_impressions_percentile_tier": "STRONG_COMPETITOR",
      "interactions_percentile_tier": "MARKET_LEADER",
      "engagements_percentile_tier": "COMPETITOR"
    }
  },
  "average_benchmarks_metrics": {
    "average_rate_metrics": {
      "average_cpm": 6.15,
      "click_through_rate": 0.0142
    }
  }
}

Hata işleme

BenchmarksService işlevini çağırı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 içindeki ürün sayısını azaltın.
  • NO_METRICS_FOUND: İstenen giriş kombinasyonu (ör. belirli bir konumda ve tarih aralığında reklamverenlerin kampanya yayınlamadığı bir niş kategori) için metrik bulunamadı. Kategori, konum, tarih aralığı veya ürünleri ayarlamayı deneyin.

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

Önceki
YouTube İçerik Üretici Analizleri