Google Ads Sorgu Dili

Google Ads Query Language, Google Ads API'yi

Kaynaklar ve bunların ilgili özellikleri, segmentleri, metrikleri
GoogleAdsService Arama veya SearchStream
Bir GoogleAdsService sorgusundan elde edilen sonuç, GoogleAdsRow örneklerinden oluşan bir listedir. Her GoogleAdsRow örneği bir kaynağı temsil eder. Herhangi bir özellik veya metrik istenirse satırda bu alanlar da yer alır. Herhangi bir segment istenirse yanıtta her segment-kaynak grubu için ek bir satır da gösterilir.
Şu kaynaktaki kullanılabilir alanlar ve kaynaklarla ilgili meta veriler:
GoogleAdsFieldService

Bu hizmet, uyumlulukları ve türleriyle ilgili ayrıntıları içeren, sorgulanabilir alanlardan oluşan bir katalog sunar.

Bir GoogleAdsFieldService sorgusunun sonucu, her biri istenen alanla ilgili ayrıntıları içeren GoogleAdsField örneklerin GoogleAdsField bir listesidir.

Bir kaynağın özelliklerini sorgulama

Aşağıda, kampanya kaynağının özellikleri için temel bir sorgu verilmiştir. Kampanya kimliği, adı ve durumunun nasıl döndürüleceği gösterilmektedir:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

Bu sorgu, siparişleri kampanya kimliğine göre sorgular. Ortaya çıkan her GoogleAdsRow, seçilen alanlarla (söz konusu kampanyanın resource_name dahil) doldurulan bir campaign nesnesini temsil eder.

Kampanya sorgularında başka hangi alanların kullanılabildiğini öğrenmek için Campaign referans belgelerini inceleyin.

Metrikler için sorgulama

Belirli bir kaynak için seçilen özelliklerin yanı sıra ilgili metrikleri de sorgulayabilirsiniz:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

Bu sorgu, kampanya kimliğine göre sıralama yaparken yalnızca PAUSED durumuna sahip ve 1.000'den fazla gösterime sahip kampanyaları filtreler. Sonuçta ortaya çıkan her GoogleAdsRow, seçilen metriklerle doldurulmuş bir metrics alanına sahip olur.

Sorgulanabilir metriklerin listesi için Metrics belgelerini inceleyin.

Segmentler için sorgulama

Belirli bir kaynak için seçilen özelliklerin yanı sıra ilgili segmentleri de sorgulayabilirsiniz:

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

Metrik sorgulamaya benzer şekilde, bu sorgu da yalnızca PAUSED durumuna sahip ve 1.000'den fazla gösterime sahip kampanyaları filtreler. Ancak bu sorgu, verileri tarihe göre segmentlere ayırır. Böylece, kampanya grubunu ve Segment tarihini temsil eden her bir GoogleAdsRow elde edilir. Segmentlere ayırmanın, seçilen metrikleri SELECT ifadesindeki her bir segmente göre gruplandırarak böldüğünü unutmayın.

Sorgulanabilir segmentlerin listesi için Segments belgelerine bakın.

Belirli bir kaynak için yapılan sorguda, varsa diğer ilgili kaynaklarla birleştirme yapabilirsiniz. Bu ilgili kaynaklar "ilişkilendirilmiş kaynaklar" olarak bilinir. Sorgunuzdan bir özellik seçerek ilişkilendirilen kaynaklarla dolaylı yoldan birleştirme yapabilirsiniz.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

Bu sorgu yalnızca kampanya özelliklerini seçmekle kalmaz, seçilen her kampanyadan ilgili özellikleri de alır. Sonuçta elde edilen her GoogleAdsRow, seçilen kampanya özelliklerinin yanı sıra seçilen teklif stratejisi bidding_strategy.name ile doldurulan bir campaign nesnesini temsil eder.

Kampanya sorguları için hangi ilişkilendirilen kaynakların kullanılabileceğini öğrenmek üzere Campaign referans belgelerine bakın.

Sorgu sonuçlarına göre değişiklik yapma

Belirli bir kaynak için sorgu oluştururken, döndürülen sonuçları hemen nesne olarak alabilir, değiştirebilir ve söz konusu kaynağın hizmetindeki mutate yöntemine geri gönderebilirsiniz. Aşağıda örnek bir iş akışı verilmiştir:

  1. Hâlihazırda PAUSED olan ve 1.000'den fazla gösterime sahip tüm kampanyalar için bir sorgu yürütün.
  2. Yanıttaki her GoogleAdsRow öğesinin campaign alanından Campaign nesnesini alın.
  3. Her kampanyanın PAUSED olan durumunu ENABLED olarak değiştirin.
  4. Değiştirilen kampanyaları güncellemek için CampaignService.MutateCampaigns numaralı telefonu arayın.

Alan meta verisi

GoogleAdsFieldService hizmetine gönderilen sorgular, alan meta verilerini almak içindir. Bu bilgiler, alanların bir sorguda birlikte nasıl kullanılabileceğini anlamak için kullanılabilir. Veriler API'den kullanılabildiği ve bir sorguyu doğrulamak veya oluşturmak için gereken meta verileri sağladığı için geliştiricilerin bunu programatik olarak yapmasına olanak tanır. Meta veri için tipik bir sorgu aşağıda verilmiştir:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Bu sorgudaki <INSERT_RESOURCE_OR_FIELD> öğesini bir kaynak (customer veya campaign gibi) ya da alan (campaign.id, metrics.impressions veya ad_group.id gibi) ile değiştirebilirsiniz.

Sorgulanabilir alanların listesi için GoogleAdsField belgelerini inceleyin.

Kod örnekleri

İstemci kitaplıklarında, GoogleAdsService ürününde Google Ads Sorgu Dili'nin kullanımıyla ilgili örnekler bulunur. Temel işlemler klasöründe GetCampaigns, GetKeywords ve SearchForGoogleAdsFields gibi örnekler bulunur. Reporting klasörünün GetKeywordStats örneği vardır.

Sonraki
Sorgu dil bilgisi