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_criterionad_groupcampaigncustomer
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_viewile eşdeğer veriler döndürür. - Kampanyalar > Kitleler, anahtar kelimeler ve içerikler > Kitleler > Demografi:
age_range_viewvegender_viewile eşdeğer veriler döndürür. - Kampanyalar > Konumlar:
location_viewile eşdeğer veriler döndürür.