Search Ads 360 Sorgu Dili, Search Ads 360 Reporting API'yi kullanarak raporlama verilerini ve kaynak meta verilerini almak için arama sorguları oluşturmanıza olanak tanır.
Hizmetlerde ara
Search Ads 360 Sorgu Dili'ni kullanarak API'yi sorgulamak için şunları kullanabilirsiniz:
SearchAds360Service
Kaynakları ve ilgili özelliklerini, segmentleri ve metriklerini sorgulamak için bu hizmeti kullanın.
Search
veSearchStream
olmak üzere iki yöntem vardır.SearchAds360Service
sorgularıSearchAds360Row
örneklerinden oluşan bir liste döndürür:- Her satır bir kaynağı temsil eder.
- İstenirse, satırlar özellikler ve metrik alanlarını içerir.
- Segment isteğinde bulunursanız her segment-kaynak parçası için ek satırlar dahil edilir.
Daha fazla bilgi için Arama raporları oluşturma bölümüne bakın.
SearchAds360FieldService
Kullanılabilir alanlar ve kaynaklarla ilgili meta verileri sorgulamak için bu hizmeti kullanın. Hizmet, sorgulanabilir alanların yer aldığı bir katalogda uyumlulukları ve türleri hakkında ayrıntılar sunar.
SearchAds360FieldService
,SearchAds360Field
örneklerinden oluşan bir liste döndürür:- Her alanda, istenen alanla ilgili ayrıntılar bulunur.
Daha fazla bilgi edinmek için Kaynak meta verilerini alma bölümüne bakın.
Temel sorgu örnekleri
Aşağıdaki bölümlerde, kendi sorgularınızı oluşturmak için uyarlayabileceğiniz temel sorgu örnekleri sunulmaktadır.
Bir kaynağın özellikleri için sorgu
Bu, kampanya kimliğini, adını ve durumunu döndüren campaign
kaynağının özellikleri için temel bir sorgudur:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- Döndürülen her
SearchAds360Row
, bircampaign
nesnesini temsil eder. - Satırlar, seçilen alanlarla doldurulur (kampanyanın
resource_name
alanı dahil). - Kampanya kimliğine göre sorgu sıraları.
Sorgularınızda kullanabileceğiniz diğer kullanılabilir alanlar için campaign
bölümüne bakın.
Metrikler için sorgu
Bu, campaign
kaynağının özellikleriyle ilgili metrikler için temel bir sorgudur:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- Sorgu,
PAUSED
durumuna sahip ve 1.000'den fazla gösterime sahip kampanyaları döndürür. - Döndürülen her
SearchAds360Row
, seçilen metriklerle doldurulmuş birmetrics
alanına sahiptir. - Kampanya kimliğine göre sorgu sıraları.
Sorgularınızda kullanabileceğiniz diğer metrikler için metrics
bölümüne bakın.
Segmentler için sorgu
Bu, campaign
kaynağının özellikleriyle ilgili segmentler için temel bir sorgudur:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- Sorgu,
PAUSED
durumuna sahip ve 1.000'den fazla gösterime sahip kampanyaları döndürür. - Verileri tarihe göre segmentlere ayırır.
- Segmentasyonun sonucu olarak, her
SearchAds360Row
bir kampanya ve tarih segmentini temsil eder. - Kampanya kimliğine göre sorgu sıraları.
Sorgularınızda kullanabileceğiniz segmentlerin listesi için segments
ve raporlarınızı segmentlere ayırma hakkında daha fazla bilgi için Segmentasyon bölümünü inceleyin.
İlişkili bir kaynağın özellikleri için sorgu
Bu, campaign
kaynağında yapılan ve varsa bidding_strategy
kaynağının özelliklerini birleştiren temel bir sorgudur. Bu ilgili kaynak türü, ilişkilendirilen kaynak olarak bilinir.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- Sorgu, seçilen her kampanyadan kampanya özelliklerini ve ilgili özellikleri seçer.
- Döndürülen her
SearchAds360Row
, seçilen kampanya özelliklerinin yanı sıra seçilenbidding_strategy.name
teklif stratejisi özelliğiyle doldurulan bircampaign
nesnesini temsil eder.
Kampanya sorgularıyla ilişkilendirilmiş kaynakların hangileri olduğunu öğrenmek için campaign
bölümüne bakın.
Alan meta verileri için sorgu
Alan meta verilerini almak için SearchAds360FieldService
kullanabilirsiniz.
Bu, alan meta verileri için temel bir sorgudur:
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- KAYNAK VEYA ALAN değerini bir kaynak (
customer
veyacampaign
gibi) ya da bir alan (campaign.id
,metrics.impressions
veyaad_group.id
gibi) ile değiştirin.
Alan meta verilerini alma hakkında daha fazla bilgi için Kaynak meta verilerini alma bölümüne bakın.
Daha fazla bilgi
Search Ads 360 Reporting API'de sorgu oluşturma hakkında daha fazla bilgi edinin: