Search Ads 360 Sorgu Dili

Search Ads 360 Sorgu Dili, raporlama verilerini ve kaynak meta verilerini kullanabilirsiniz.

Hizmet arayın

Aşağıdakileri kullanarak API'yi sorgulamak için Search Ads 360 Sorgu Dili'ni kullanabilirsiniz:

SearchAds360Service

Kaynakları ve bunlarla ilgili özelliklerini, segmentlerini, kullanabilirsiniz. İki yöntem vardır: Search ve SearchStream.

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

  • Her satır bir kaynağı temsil eder.
  • İstenirse satırlar özellikleri ve metrik alanlarını içerir.
  • Segment isterseniz her bir segment için ek satırlar eklenir segment-kaynak tuple'ıdır.

Aşağıdakiler için Arama raporları oluşturma konusuna bakın daha fazla bilgi edinin.

SearchAds360FieldService

Kullanılabilir alanlar ve kaynaklarla ilgili meta verileri sorgulamak için bu hizmeti kullanın. Hizmet, sorgulanabilir alanlarla ilgili spesifik bilgiler içeren bir katalog sunar. uyumluluk ve tür.

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

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

Daha fazla bilgi edinmek için Kaynak meta verilerini alma başlıklı makaleye bakın.

Temel sorgu örnekleri

Aşağıdaki bölümlerde, derleme işlemi için uyarlayabileceğiniz temel sorgu örnekleri oluşturmanız önerilir.

Bir kaynağın özellikleri için sorgu

Bu, şu sonucu döndüren campaign kaynağının özellikleri için temel bir sorgudur: kampanya kimliği, adı ve durumu:

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) bilgileri gösterilir.
  • Kampanya kimliğine göre sorgu siparişi.

Ayrıntılı bilgi için campaign adresini ziyaret edin. kullanabilirsiniz.

Metrikler için sorgu

Bu, campaign özellikleriyle ilgili metrikler için temel bir sorgudur kaynak:

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 durumunda ve 1.000'den fazla durumda olan kampanyaları döndürür gösterim sayısı.
  • Döndürülen her SearchAds360Row öğesinin metrics alanı seçili metrikler.
  • Kampanya kimliğine göre sorgu siparişi.

Diğer ayrıntılar için metrics sayfasına göz atın kullanabilirsiniz.

Segmentlerle ilgili sorgu

Bu, campaign özellikleri ile ilgili segmentler için temel bir sorgudur kaynak:

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 durumunda ve 1.000'den fazla durumda olan kampanyaları döndürür gösterim sayısı.
  • Verileri tarihe göre segmentlere ayırır.
  • Segmentasyonun sonucu olarak, her SearchAds360Row bir grubu temsil eder seçeceğim.
  • Kampanya kimliğine göre sorgu siparişi.

Ayrıntılı bilgi için segments adresini ziyaret edin. daha fazlası için sorgularınızda ve Segmentasyon'da kullanabileceğiniz segmentlerin listesi Raporlarınızı segmentlere ayırma hakkında bilgi edinin.

Bu, campaign kaynağında bulunan ve bidding_strategy kaynak (varsa). Bu alakalı kaynak türü ilişkilendirilen bir kaynak olarak bilinir.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • Sorgu, kampanya özelliklerini ve her kampanya için seçili.
  • Döndürülen her SearchAds360Row, doldurulan bir campaign nesnesini temsil eder seçilen kampanya özelliklerinin yanı sıra belirlenen teklif stratejisiyle özelliği, bidding_strategy.name.

Bkz. campaign inceleyerek kampanya sorguları için hangi ilişkilendirilen kaynakların kullanılabilir olduğunu öğrenebilirsiniz.

Alan meta verisi sorgusu

Şunu kullanabilirsiniz: SearchAds360FieldService kullanabilirsiniz.

Bu, alan meta verisi için temel bir sorgudur:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • KAYNAK VEYA ALAN'ı bir kaynakla (ör. customer veya campaign) ya da bir alan (ör. campaign.id, metrics.impressions veya ad_group.id).
ziyaret edin.

Alan alma hakkında daha fazla bilgi için Kaynak meta verilerini alma bölümüne bakın meta verilerdir.

Daha fazla bilgi

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