Search Ads 360 Sorgu Dili

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.

Arama hizmetleri

API'yi sorgulamak için Search Ads 360 sorgu dilini kullanabilirsiniz:

SearchAds360Service

Kaynakları ve ilgili özelliklerini, segmentlerini ve metriklerini sorgulamak için bu hizmeti kullanın. İki yöntem vardır: Search ve SearchStream.

SearchAds360Service sorguları, SearchAds360Row örnekleri listesini döndürür:

  • Her satır bir kaynağı temsil eder.
  • İstenirse satırlar özellikleri ve metrik alanlarını içerir.
  • Segment isteğinde bulunursanız her segment-kaynak ikilisi için ek satırlar eklenir.

Daha fazla bilgi için Arama raporları oluşturma bölümüne bakın.

SearchAds360FieldService

Mevcut alanlar ve kaynaklarla ilgili meta verileri sorgulamak için bu hizmeti kullanın. Hizmet, uyumluluk ve türleriyle ilgili ayrıntıları içeren sorgulanabilir alanların bir kataloğunu sağlar.

SearchAds360FieldService, SearchAds360Field örneklerinin listesini döndürür:

  • Her alanda, istenen alanla ilgili ayrıntılar bulunur.

Daha fazla bilgi için Kaynak meta verilerini alma başlıklı makaleyi inceleyin.

Temel sorgu örnekleri

Aşağıdaki bölümlerde, kendi sorgularınızı oluşturmak için uyarlayabileceğiniz temel sorgu örnekleri verilmektedir.

Bir kaynağın özelliklerini sorgulayın

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, bir campaign nesnesini temsil eder.
  • Satırlar, seçilen alanlarla (belirtilen kampanyanın resource_name dahil) doldurulur.
  • Sorgu, kampanya kimliğine göre sıralanır.

Sorgularınızda kullanabileceğiniz diğer kullanılabilir alanlar için campaign adresine 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 öğesinde, seçilen metriklerle doldurulmuş bir metrics alanı bulunur.
  • Sorgu, kampanya kimliğine göre sıralanır.

Sorgularınızda kullanabileceğiniz diğer metrikler için metrics bölümüne bakın.

Segment sorgusu

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 durumu ve 1.000'den fazla gösterimi olan kampanyaları döndürür.
  • Verileri tarihe göre segmentlere ayırır.
  • Segmentasyon sonucunda her SearchAds360Row, bir kampanya ve tarih segmentinin bir tuple'ini temsil eder.
  • Sorgu, kampanya kimliğine göre sıralanır.

Sorgularınızda kullanabileceğiniz segmentlerin listesi için segments, raporlarınızı segmentlere ayırma hakkında daha fazla bilgi için Segmentasyon bölümüne bakın.

Bu, varsa bidding_strategy kaynağının özelliklerini birleştiren campaign kaynağıyla ilgili temel bir sorgudur. Bu tür ilgili kaynak, ilişkilendirilmiş 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çilen teklif stratejisi özelliği bidding_strategy.name ile doldurulmuş bir campaign nesnesini temsil eder.

Kampanya sorguları için hangi ilişkilendirilmiş kaynakların kullanılabildiğini öğrenmek üzere campaign bölümüne bakın.

Alan meta verilerini sorgulayın

Alan meta verilerini almak için SearchAds360FieldService kullanabilirsiniz.

Aşağıda, alan meta verileri için temel bir sorgu verilmiştir:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • KAYNAK VEYA ALAN'ı bir kaynak (customer veya campaign gibi) ya da bir alanla (ör. campaign.id, metrics.impressions veya ad_group.id) değiştirin.

Alan meta verilerini alma hakkında daha fazla bilgi için Kaynak meta verilerini alma başlıklı makaleyi inceleyin.

Daha fazla bilgi

Search Ads 360 Reporting API'de sorgu oluşturma hakkında daha fazla bilgi edinin: