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 edenGoogleAdsRow
ö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 biriGoogleAdsField
istenen alanla ilgili ayrıntıları içerenGoogleAdsField
ö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.
İlişkili bir kaynağın özelliklerini sorgulama
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:
- Ş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. - Yanıttaki her
GoogleAdsRow
öğesinincampaign
alanındanCampaign
nesnesini alın. PAUSED
olan her kampanyanın durumunuENABLED
olarak değiştirin.- 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.