Kaynak Meta Verileri

Şunu kullanabilirsiniz: SearchAds360FieldService ve kaynakların ve kaynakların alanları için kataloğu dinamik olarak istemek üzere SearchAds360Service'ndaki segmentasyon anahtarları ve metrikleri Search ve SearchStream yöntemleri. Katalogda, kitlenizle ilgili Search Ads 360'ın doğrulanması ve oluşturulması için Search Ads 360 Reporting API istemcileri tarafından kullanılır Sorgu Dili ifadeleri.

Örnek HTTP isteği ve yanıtı

İstek, Search Ads 360 Reporting API sunucusuna yönelik bir HTTP GET aşağıdaki URL:

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

Aşağıda, bir istek örneği verilmiştir. Ardından gelen ad_group kaynağı için SearchAds360FieldService:

İ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 ifadesini kullanın.

metrics

FROM ifadesini ekleyin. Yalnızca category öğesinin RESOURCE olduğu alanlar için doldurulur.

segments

FROM ifadesindeki kaynakla seçilebilen anahtarları segmentlere ayırın. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca alanlar için doldurulur burada category değeri RESOURCE olur.

selectableWith

FROM içinde değilken belirli bir alanın yanında seçilebilecek alanlar ifadesini ekleyin. Bu özellik yalnızca kaynakları veya segmentleri tanımlarken kullanılabilir Bunlar, FROM ifadesindeki kaynak kodunu girin. Örneğin, ad_group.id seçeneğini kullanıyorsanız ve ad_group kullanıcısından segments.date ve campaign varsa segments.date öğesinin şurada olup olmadığını kontrol etmeniz gerekir: seçildiği için kampanya için selectableWith özelliği Mevcut segments.date alanı.

Meta veri ayrıntıları

Şuradaki SearchAds360FieldService hizmetini kullanarak katalog isteğinde bulunabilirsiniz: seviyeler:

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ı,

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