Kaynak Meta Verileri

SearchAds360Service Search ve SearchStream yöntemlerinde bulunan kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için kataloğu dinamik olarak istemek amacıyla SearchAds360FieldService aracını kullanabilirsiniz. Katalog, Search Ads 360 Sorgu Dili ifadelerinin doğrulanması ve oluşturulması için Search Ads 360 Raporlama API'si istemcileri tarafından kullanılabilecek meta veriler sağlar.

Örnek HTTP isteği ve yanıtı

İstek, aşağıdaki URL'de Search Ads 360 Raporlama API'si sunucusuna yönelik bir HTTP GET içerir:

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

Aşağıda, bir istek örneği ve ardından ad_group kaynağı için SearchAds360FieldService öğesinden döndürülen yanıt 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 örnek için önemli diziler şunlardır:

attributeResources
FROM yan tümcesinde dolaylı olarak kaynağa eklenebilecek kaynaklar.
metrics
FROM yan tümcesindeki kaynakla birlikte seçilebilecek metrikler. Yalnızca category öğesinin RESOURCE olduğu alanlar için doldurulur.
segments
FROM yan tümcesindeki kaynakla seçilebilen segment anahtarları. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca category öğesinin RESOURCE olduğu alanlar için doldurulur.
selectableWith
FROM yantümcesinde değilken belirli bir alanın yanında seçilebilen alanlar. Bu özellik yalnızca, FROM ifadesindeki kaynak tarafından dahil edilmedikleri bir sorguda seçilebilen kaynakları veya segmentleri tanımlarken kullanılabilir. Örneğin, ad_group öğesinden ad_group.id ve segments.date öğelerini seçer ve campaign özelliğinden özellikleri dahil etmek isterseniz segments.date öğesinin mevcut segments.date alanının yanında seçildiği için kampanyanın selectableWith özelliğinde seçili olduğundan emin olmanız gerekir.

Meta veri ayrıntıları

Aşağıdaki düzeylerde SearchAds360FieldService öğesini kullanarak katalog isteğinde bulunabilirsiniz:

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

Alan ayrıntılarını,

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 sorgulama.

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"
  )