Search Ads 360 Sorgu Dili

Search Ads 360 Sorgu Dili, Search Ads 360 Raporlama API'sini kullanarak raporlama verilerini ve kaynak meta verilerini almak için arama sorguları oluşturmanıza olanak tanır.

Arama hizmetleri

Aşağıdaki yöntemleri kullanarak API'yi sorgulamak için Search Ads 360 sorgu dilini kullanabilirsiniz:

SearchAds360Service

Kaynakları ve bunlarla ilişkili özellikleri, segmentleri ve metrikleri sorgulamak için bu hizmeti kullanın. Search ve SearchStream olmak üzere iki yöntem vardır.

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

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

Daha fazla bilgi için Arama raporları oluşturma başlıklı makaleyi inceleyin.

SearchAds360FieldService

Kullanılabilir alanlar ve kaynaklarla ilgili meta verileri sorgulamak için bu hizmeti kullanın. Hizmet, uyumlulukları ve türleriyle ilgili ayrıntıların yer aldığı, sorgulanabilir alanların kataloğunu sağlar.

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

  • Her alan, istenen alanla ilgili ayrıntıları içerir.

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 verilmiştir.

Bir kaynağın özelliklerini sorgulama

Bu, campaign kaynağının özellikleriyle ilgili temel bir sorgudur ve kampanya kimliğini, adını ve durumunu döndürür:

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, kampanyaları kampanya kimliğine göre sıralar.

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

Metrikler için sorgu oluşturma

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, durumu PAUSED olan ve 1.000'den fazla gösterime sahip kampanyaları döndürür.

  • Döndürülen her SearchAds360Row, seçilen metriklerle doldurulmuş bir metrics alanına sahiptir.

  • Sorgu, kampanyaları kampanya kimliğine göre sıralar.

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

Segmentler için sorgu oluşturma

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, durumu PAUSED olan ve 1.000'den fazla gösterime sahip kampanyaları döndürür.

  • Verileri tarihe göre segmentlere ayırır.

  • Segmentasyon sonucunda her SearchAds360Row, bir kampanya ve tarih segmentinin sıralı ikilisini temsil eder.

  • Sorgu, kampanyaları kampanya kimliğine göre sıralar.

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 campaign kaynağının özelliklerini bidding_strategy kaynağının özellikleriyle birleştiren temel bir sorgudur. Bu türdeki ilgili kaynaklar, atfedilmiş 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ında hangi ilişkilendirilmiş kaynakların kullanılabildiğini öğ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
  • RESOURCE OR FIELD yerine bir kaynak (ör. customer veya campaign) ya da bir alan (ör. campaign.id, metrics.impressions veya ad_group.id) yazın.

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: