Google Ads Sorgu Dili

Google Ads Query Language, Google Ads API'yi

Kaynaklar ve bunlarla ilişkili özellikler, segmentler ve metrikler
GoogleAdsService Arama veya SearchStream
Google AdsService sorgusundan elde edilen sonuç, her GoogleAdsRow bir kaynağı temsil eden GoogleAdsRow örneklerinden oluşan bir listedir. Herhangi bir özellik veya metrik istenirse satırda bu alanlar da bulunur. Herhangi bir segment istenirse yanıtta her segment kaynağı demeti için ek bir satır da gösterilir.
Şurada bulunan alanlar ve kaynaklarla ilgili meta veriler:
GoogleAdsFieldService

Bu hizmet, sorgulanabilir alanların, uyumlulukları ve türleriyle ilgili ayrıntıların yer aldığı bir katalog sunar.

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

Bir kaynağın özelliklerini sorgulama

Aşağıda, kampanya kaynağının özelliklerine ilişkin temel bir sorgu bulunmaktadır. Bu sorguda, kampanya kimliği, ad ve durumun nasıl döndürüleceği gösterilmektedir:

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

Bu sorgu, kampanya kimliğine göre sıralar. Sonuçta ortaya çıkan her GoogleAdsRow, seçilen alanlarla (söz konusu kampanyanın resource_name değeri dahil) doldurulan bir campaign nesnesini temsil eder.

Kampanya sorguları için kullanılabilecek diğer alanları öğrenmek üzere Campaign referans belgelerini inceleyin.

Metrikler için sorgulama

Belirli bir kaynak için seçili ö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ıralanırken, yalnızca durumu PAUSED olan ve 1.000'den fazla gösterime sahip olan kampanyalar için filtre uygular. 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çili ö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

Metrikleri sorgulamaya benzer şekilde, bu sorgu yalnızca durumu PAUSED olan ve 1.000'den fazla gösterime sahip olan kampanyalar için filtre uygular. Ancak bu sorgu, verileri tarihe göre segmentlere ayırır. Bu da bir kampanyanın birkaç unsurunu ve Segment tarihini temsil eden her bir GoogleAdsRow sonucunu verir. Segmentasyonun seçili metrikleri böldüğünü ve SELECT ifadesindeki her bir segmente göre gruplandırdığı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ştirebilirsiniz. Bu ilgili kaynaklar "ilişkilendirilmiş kaynaklar" olarak bilinir. Sorgunuzda bir özellik seçerek ilişkilendirilen kaynaklarla dolaylı olarak birleştirebilirsiniz.

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 seçilen her bir kampanyadan ilgili özellikleri de çeker. Sonuçta ortaya çıkan her GoogleAdsRow, seçilen kampanya özelliklerinin yanı sıra seçilen teklif stratejisi özelliği bidding_strategy.name ile doldurulan bir campaign nesnesini temsil eder.

Kampanya sorguları için ilişkilendirilmiş kaynakların hangileri olduğunu öğrenmek istiyorsanız Campaign referans belgelerini inceleyin.

Sorgu sonuçlarına göre dönüştürme

Belirli bir kaynağı sorguladığınızda, döndürülen sonuçları hemen nesne olarak alabilir, değiştirebilir ve kaynağın hizmetindeki değiştirme yöntemine geri gönderebilirsiniz. Aşağıda örnek bir iş akışı verilmiştir:

  1. Şu anda PAUSED olan ve gösterim sayısı 1.000'den fazla olan 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. PAUSED olan her kampanyanın durumunu ENABLED olarak değiştirin.
  4. Değiştirilen kampanyaları güncellemek için CampaignService.MutateCampaigns numaralı telefonu arayın.

Alan meta verileri

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

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

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

Sorgulanabilir alanların listesi için GoogleAdsField belgelerine bakın.

Kod örnekleri

İstemci kitaplıklarında, GoogleAdsService ürününde Google Ads Sorgu Dili'nin kullanımına ilişkin örnekler vardır. basic actions (temel işlemler) klasöründe GetCampaigns, GetKeywords ve SearchForGoogleAdsFields gibi örnekler bulunur. reporting klasörüne GetKeywordStats bir örnek verilmiştir.

Sonraki
Sorgu dil bilgisi