Kaynak meta verileri

GoogleAdsService Search ve SearchStream yöntemlerinde bulunan kaynakların, kaynak alanlarının, segmentasyon anahtarlarının ve metriklerin kataloğunu dinamik olarak istemek için GoogleAdsFieldService (GetGoogleAdsField veya SearchGoogleAdsFields aracılığıyla) kullanabilirsiniz. Katalog, Google Ads API istemcileri tarafından Google Ads Sorgu Dili ifadelerinin doğrulanması ve oluşturulması için kullanılabilecek meta veriler sağlar.

Örnek HTTP isteği ve yanıtı

İstek, aşağıdaki URL'de bulunan Google Ads API sunucusuna gönderilen bir HTTP GET öğesinden oluşur:

https://googleads.googleapis.com/v26/googleAdsFields/{resource_or_field}

Aşağıdaki örnekte, ad_group kaynağı için GoogleAdsFieldService tarafından döndürülen yanıtın ardından gelen bir istek gösterilmektedir:

İstek

https://googleads.googleapis.com/v26/googleAdsFields/ad_group

Yanıt

{
  "resourceName": "googleAdsFields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device"
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],
  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks"
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device"
  ]
}

Bu örnekte, önemli diziler şunlardır:

attributeResources
Metrikleri segmentlere ayırmadan FROM yan tümcesindeki kaynağa dolaylı olarak birleştirilebilen kaynaklar. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.
metrics
FROM yan tümcesinde kaynakla birlikte seçilebilecek metrikler. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.
segments
FROM yan tümcesinde kaynakla birlikte seçilebilecek
segment anahtarları (segments.* alanları ve segmentasyon kaynakları). Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.
selectableWith
Bu kaynak veya segment, FROM yan tümcesindeki birincil kaynak olmadığında aynı Google Ads sorgu dili sorgusunda seçilebilecek kaynaklar, segmentler veya metrikler.

selectableWith ile uyumluluğu sorgulama

Bir kaynak veya segment alanındaki selectableWith özelliği, aynı Google Ads Sorgu Dili sorgusunda seçilebilecek diğer kaynakları, segmentleri veya metrikleri belirtir. Bu özellik, FROM yan tümcesinde belirtilmeyen bir kaynak veya segmentteki alanları dahil etmek istediğinizde çok önemlidir.

Google Ads Sorgu Dili sorgusu oluştururken:

  1. FROM yan tümcesindeki kaynak, birincil öğedir. Bu kaynaktan dilediğiniz zaman alan seçebilirsiniz.
  2. Birincil öğeyle kullanılabilen uyumlu metrikleri ve segmentleri de seçebilirsiniz.
  3. FROM yan tümcesi dışındaki bir kaynaktan veya segmentten alanlar eklerseniz bu FROM dışı kaynak veya segmentin, sorguda seçilen diğer tüm alanlar, segmentler ve metriklerle uyumlu olduğundan emin olmanız gerekir.

Belirli bir kaynak (Kaynak A) için selectableWith listesi, Kaynak A birincil öğe olmadığında Kaynak A'daki alanlarla birlikte seçilebilecek diğer tüm kaynakları, segmentleri ve metrikleri içerir.

Örnek

Aşağıdaki örnek sorguyu inceleyin:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group
  • FROM ifadesi ad_group değerini belirtir.
  • Bu sorgu, ad_group.id (FROM kaynağından), segments.date ve campaign.name alanlarını seçer.
  • campaign.name seçili olduğu ancak campaign, FROM yan tümcesinde olmadığı için diğer seçili öğelerle uyumluluğunu doğrulamanız gerekir.
  • Bu sorgunun geçerli olması için campaign kaynağının segments.date (seçilen başka bir alan) ile uyumlu olması gerekir. Bu nedenle, campaign kaynağının selectableWith özelliğini kontrol etmeniz gerekir. segments.date, campaign adlı kullanıcının selectableWith listesinde yer alıyorsa sorgu geçerlidir.

FROM yan tümcesinde bulunmayan bir kaynaktan alanlar seçerseniz bu kaynağın selectableWith listesi, SELECT yan tümcenizde bulunan diğer tüm segmentleri ve kaynakları içermelidir.

Meta veri ayrıntıları

Kataloğu GoogleAdsFieldService kullanarak (GetGoogleAdsField ile kaynak adına göre veya SearchGoogleAdsFields ile sorgulayarak) şu GoogleAdsFieldCategory seviyelerinde isteyebilirsiniz:

Kaynak (RESOURCE)
Örneğin, googleAdsFields/campaign.
Kaynak özelliği (ATTRIBUTE)
Örneğin, googleAdsFields/campaign.name.
Segmentasyon alanı (SEGMENT)
Örneğin, googleAdsFields/segments.ad_network_type.
Metrik (METRIC)
Örneğin, googleAdsFields/metrics.clicks.
Önceki
Nesne alma
Sonraki
Telefon görüşmesi yapısı