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.

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 ve SearchStream 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, bir campaign 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ş bir metrics 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.

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çilen bidding_strategy.name teklif stratejisi özelliğiyle doldurulan bir campaign 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 veya campaign gibi) ya da bir alan (campaign.id, metrics.impressions veya ad_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: