Google Ads Sorgu Dili

Google Ads Query Language, Google Ads API'yi

Kaynaklar ve bunların ilgili özellikleri, segmentleri, metrikleri
GoogleAdsService Arama veya SearchStream
GoogleAdsService sorgusunun sonucu, Her GoogleAdsRow ile GoogleAdsRow örnek temsil eder. Herhangi bir özellik veya metrik istenirse satırı da bu alanları içerir. Herhangi bir segment istenirse yanıtında her segment-kaynak türü için ek bir satır da gösterilir.
Şu kaynaktaki kullanılabilir alanlar ve kaynaklarla ilgili meta veriler:
GoogleAdsFieldService

Bu hizmet, aşağıdakilerle ilgili özellikleri içeren sorgulanabilir alanlar içeren bir katalog sunar: ve türlerine yer verirler.

GoogleAdsFieldService sorgusunun sonucu, Her biri ile GoogleAdsField örnek İstenen alanla ilgili ayrıntıları içeren GoogleAdsField.

Bir kaynağın özelliklerini sorgulama

Aşağıda, kampanya kaynağının özellikleri için temel bir sorgu verilmiştir. Bu sorguda kampanya kimliğini, adını ve durumunu döndürmek için:

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, değeri temsil eder Seçilen alanlarla (verilenler de dahil olmak üzere) doldurulmuş bir campaign nesnesi kampanyanın resource_name).

Kampanya sorguları için başka hangi alanların kullanılabildiğini öğrenmek üzere Campaign referans belgeleri.

Metrikler için sorgulama

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

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 yalnızca durumu PAUSED ve kampanya kimliğine göre sıralama yaparken 1.000'den fazla gösterim almış olmalıdır. Her biri Bunun sonucunda GoogleAdsRow, metrics alanı seçili metrikler.

Sorgulanabilir metriklerin listesi için Metrics bölümüne bakın. dokümanlarına göz atın.

Segmentler için sorgulama

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

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 durumunda ve 1.000'den fazla gösterim almış; ancak, bu sorgu, verileri tarihe göre segmentlere ayırır. Bu da sonuçta ortaya çıkan Bir kampanyanın grubunu ve Segment tarihini temsil eden GoogleAdsRow. İnsanların Segmentlere ayırmanın, seçilen metrikleri her birine göre gruplandırarak böldüğünü unutmayın. segmenti ekleyin.

Sorgulanabilir segmentlerin listesi için Segments bölümüne bakın dokümanlarına göz atın.

Belirli bir kaynak için yapılan sorguda, sorgularınızı bir araya getiren diğer kaynaklara göz atmanızı öneririm. Bu ilgili kaynaklar "ilişkilendirilmiş kaynakları". Bir özelliği ekleyin.

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, aynı zamanda alakalı özellikleri kullanın. Sonuçta elde edilen her GoogleAdsRow, seçili kampanya özellikleriyle doldurulan bir campaign nesnesinin yanı sıra seçilen teklif stratejisi özelliği bidding_strategy.name.

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

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

Belirli bir kaynak için sorgu oluştururken, döndürülen bu kaynakları hemen alabilirsiniz nesne olarak göstermeli, onları değiştirmeli ve bu komuttaki kaynağın hizmeti. Aşağıda örnek bir iş akışı verilmiştir:

  1. Şu anda PAUSED olan ve 1000'den fazla gösterim sayısı.
  2. Campaign nesnesini, içindeki her GoogleAdsRow öğesinin campaign alanından alın yanıt verelim.
  3. Her kampanyanın PAUSED olan durumunu ENABLED olarak değiştirin.
  4. CampaignService.MutateCampaigns numaralı telefonu arayın bu değişikliklerle güncelleyin.

Alan meta verisi

GoogleAdsFieldService hizmetine gönderilen sorgular, alan meta verilerini almak içindir. Bu bilgiler, alanların birlikte nasıl kullanılabileceğini anlamak için kullanılabilir. belirtir. Veriler API'den kullanılabildiği ve API'de gereken bilgilerin sağlandığı için bir sorguyu doğrulamak veya oluşturmak için gereken meta veriler. Bu, geliştiricilerin iş birliği içinde çalışalım. Buradan meta veriler için tipik sorgu:

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 kaynak (customer veya campaign) veya alan (campaign.id gibi) metrics.impressions veya ad_group.id).

Sorgulanabilir alanların listesi için şu sayfaya bakın: GoogleAdsField dokümanlarına göz atın.

Kod örnekleri

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

Sonraki
Sorgu dil bilgisi