Ölçüt metrikleri

Google Ads API'de her ölçüt raporu ayrı bir kaynakla temsil edilir. Gerekli olmadığı sürece *_view kaynakları yalnızca resource_name alanı içerir.

Google Ads API istemcileri, ölçüte özel herhangi bir verinin 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, Google Ads API istemcilerinin GoogleAdsService.SearchStream yöntemine aynı istekte ad_group_criterion veya campaign_criterion alanlarını ve *_view kaynağını istemesini sağlar.

Ö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 (metrikler) almak üzere FROM ifadesinde ilgili görünüm kaynağını belirtin. Örneğin, anahtar kelime metriklerini almak için FROM ifadesinde keyword_view, SELECT ifadesinde ise metrics alanlarını kullanın.

Bir ölçüt görünümünde, üst kaynaklardaki alanları customer'ya kadar seçebilirsiniz. Örneğin, FROM öğesini seçtiğinizde keyword_view, 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 üzere referans sayfasının Atfedilen 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üğünüz bilgilerle 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, yaygın olarak kullanılan bazı kritere dayalı 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.