Ölçüt metrikleri

Google Ads API'de her ölçüt raporu ayrı bir kaynakla temsil edilir. Aksi gerekmedikçe *_view kaynakları yalnızca bir resource_name alanı içerir.

Google Ads API istemcileri, ölçüte özgü verilerin getirilmesi gerekiyorsa ilgili ad_group_criterion veya campaign_criterion alanlarını belirtmelidir. Her görünüm, hedefleme düzeyiyle eşleşen ölçüt kaynağına katılır (örneğin, keyword_view, ad_group_criterion ile birleşirken location_view, campaign_criterion ile birleşir). Bu sayede Google Ads API istemcileri, GoogleAdsService.SearchStream yöntemine yönelik aynı istekte ad_group_criterion veya campaign_criterion alanlarını ve *_view kaynağını isteyebilir.

Örnek sorgu isteği

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

Belirli bir ölçüt türü için performans verilerini (metrikleri) almak istiyorsanız FROM ifadesinde ilgili görünüm kaynağını belirtin. Örneğin, anahtar kelime metriklerini almak için SELECT ifadesinde keyword_view ve FROM ifadesinde metrics alanlarını kullanın.

Ölçüt görünümünden, üst kaynaklardaki alanları customer kaynağına kadar seçebilirsiniz. Örneğin, FROM keyword_view seçildiğinde aşağıdaki kaynakların tümünden alan isteğinde bulunabilirsiniz:

  • ad_group_criterion
  • ad_group
  • campaign
  • customer

Belirli bir kaynak için bu şekilde istenebilecek kaynakları öğrenmek istiyorsanız referans sayfasındaki İlişkilendirilen kaynaklar satırını inceleyin. Örneğin, keyword_view ile ilgili kaynakları referans sayfasında bulabilirsiniz.

Kullanıcı arayüzüyle eşleme

Her ölçüt raporu, Google Ads kullanıcı arayüzündeki belirli bir görünüme karşılık gelir. Bunları eşlemek, API verilerini arayüzde gördüklerinizle karşılaştırmanıza yardımcı olabilir. Daha kapsamlı bir eşleme listesi için Kullanıcı arayüzündeki raporlar başlıklı makaleyi inceleyin.

Aşağıda, ölçütlere dayalı bazı yaygın raporlar ve bunların tipik kullanıcı arayüzü konumları verilmiştir:

  • Kampanyalar > Kitleler, anahtar kelimeler ve içerikler > Arama ağı anahtar kelimeleri: keyword_view ile eşdeğer veriler döndürür.
  • Kampanyalar > Kitleler, anahtar kelimeler ve içerikler > Kitleler > Demografi: age_range_view ve gender_view ile eşdeğer veriler döndürür.
  • Kampanyalar > Konumlar: location_view ile eşdeğer veriler döndürür.