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ızcacategory
öğesininRESOURCE
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ızcacategory
öğesininRESOURCE
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
öğesindenad_group.id
vesegments.date
öğelerini seçer vecampaign
özelliğinden özellikleri dahil etmek istersenizsegments.date
öğesinin mevcutsegments.date
alanının yanında seçildiği için kampanyanınselectableWith
ö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"
)