Kaynak Meta Verileri

Kaynaklar, kaynakların alanları, segmentasyon anahtarları ve SearchAds360Service Search ve SearchStream yöntemlerinde bulunan metrikler için katalogu dinamik olarak istemek üzere SearchAds360FieldService yöntemini kullanabilirsiniz. Katalog, Search Ads 360 sorgu dili ifadelerinin doğrulanması ve oluşturulması için Search Ads 360 Reporting API istemcileri tarafından kullanılabilecek meta veriler sağlar.

Örnek HTTP isteği ve yanıtı

İstek, aşağıdaki URL'deki Search Ads 360 Reporting API sunucusuna gönderilen bir HTTP GET'den oluşur:

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

Aşağıda, ad_group kaynağı için SearchAds360FieldService kaynağından döndürülen yanıtın ardından bir istek örneği verilmiştir:

İstek

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

Yanıt

{
  "resourceName": "searchAds360Fields/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
FROM yan tümcesinde kaynağa dolaylı olarak birleştirilebilecek kaynaklar.
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ı. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.
selectableWith
FROM yan tümcesinde değilken belirli bir alanla birlikte seçilebilecek alanlar. Bu özellik yalnızca, FROM yan tümcesinde kaynak tarafından dahil edilmedikleri bir sorguda seçilebilen kaynakları veya segmentleri tanımlarken alakalıdır. Örneğin, ad_group'den ad_group.id ve segments.date'yi seçiyor ve campaign'daki özellikleri dahil etmek istiyorsanız mevcut segments.date alanının yanında seçildiği için segments.date'nin kampanya için selectableWith özelliğinde yer aldığını kontrol etmeniz gerekir.

Meta veri ayrıntıları

Kataloğu şu düzeylerde SearchAds360FieldService kullanarak isteyebilirsiniz:

Kaynak
Örneğin, searchAds360Fields/campaign.
Kaynağın alanı
Örneğin, searchAds360Fields/campaign.name.
Segmentasyon alanı
Örneğin, searchAds360Fields/segments.ad_network_type.
Metrik
Örneğin, searchAds360Fields/metrics.clicks.

Alan ayrıntılarını almak için sorgu kullanma

Aşağıdaki URL'ye sorgu göndererek alan ayrıntılarını almak mümkündür:

https://searchads360.googleapis.com/v0/searchAds360Fields:search

1. Örnek: Normal ifade kullanma.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

2. Örnek: Belirli alanları, metrikleri veya segmentleri sorgulamak.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )