Kaynak veya meta veri bilgileri için sorgu
Google Ads Sorgu Dili, Google Ads API'ye aşağıdaki bilgi türleri için sorgu gönderebilir:
GoogleAdsService
kullanarak kaynaklar ve ilgili özellikler, segmentler ve metrikler Search veya SearchStream: GoogleAdsService sorgusunun sonucu, her biri bir kaynağı temsil edenGoogleAdsRow
örneklerinin bir listesidir.GoogleAdsRow
Herhangi bir özellik veya metrik istenirse satır bu alanları da içerir. Herhangi bir segment istenirse yanıtta her segment-kaynak grubu için ek bir satır da gösterilir.
GoogleAdsFieldService
'daki kullanılabilir alanlar ve kaynaklarla ilgili meta veriler: Bu hizmet, sorgulanabilir alanların uyumlulukları ve türleriyle ilgili ayrıntıları içeren bir kataloğunu sağlar.GoogleAdsFieldService
sorgusunun sonucu,GoogleAdsField
örneklerinin bir listesidir. HerGoogleAdsField
, istenen alanla ilgili ayrıntıları içerir.
Kaynak özelliklerini sorgulama
Kampanya kaynağının özellikleriyle ilgili temel bir sorgu örneği aşağıda verilmiştir. Bu örnekte, kampanya kimliğinin, adının 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, kampanya kimliğine göre sıralama yapar. Elde edilen her GoogleAdsRow
, kampanyanın resource_name
dahil olmak üzere seçilen alanlarla doldurulmuş bir campaign
nesnesini temsil eder.
Kampanya sorgularında hangi alanların kullanılabildiğini öğrenmek için Campaign
referans belgelerine bakın.
Metrikler için sorgu oluşturma
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, yalnızca PAUSED
durumuna sahip olan ve 1.000'den fazla gösterim alan kampanyaları filtrelerken kampanya kimliğine göre sıralama yapar. Elde edilen her GoogleAdsRow
, seçilen metriklerle doldurulmuş bir metrics
alanına sahip olur.
Sorgulanabilir metriklerin listesi için Metrics
dokümanlarına bakın.
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
Metrikler için sorgu oluşturmaya benzer şekilde, bu sorgu yalnızca durumu PAUSED
olan ve 1.000'den fazla gösterim alan kampanyaları filtreler. Ancak bu sorgu, verileri tarihe göre segmentlere ayırır. Bu, sonuçta elde edilen her bir GoogleAdsRow
değerinin bir kampanya ve tarih demetini Segment
temsil etmesine yol açar.
Segmentlere ayırma, seçilen metrikleri SELECT ifadesindeki her segmente göre gruplandırarak böler.
Sorgulanabilir segmentlerin listesi için Segments
belgelerine bakın.
İlgili bir kaynağın özellikleriyle ilgili sorgu
Belirli bir kaynağa yönelik sorguda, varsa diğer ilgili kaynaklara göre birleştirme işlemi yapabilirsiniz. Bu ilgili kaynaklar "atfedilen kaynaklar" olarak bilinir. Sorgunuzda bir özellik seçerek ilişkilendirilmiş kaynaklara karşı örtülü olarak birleştirme işlemi 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, aynı zamanda seçilen her kampanyadan ilgili özellikleri de getirir. Elde edilen her GoogleAdsRow
, seçilen kampanya özelliklerinin yanı sıra seçilen teklif stratejisi özelliği bidding_strategy.name
ile doldurulmuş bir campaign
nesnesini temsil eder.
Kampanya sorguları için hangi ilişkilendirilmiş kaynakların kullanılabildiğini öğrenmek üzere Campaign
referans belgelerine bakın.
Sorgu sonuçlarına göre değiştirme
Belirli bir kaynak için sorgu oluştururken döndürülen sonuçları hemen nesne olarak alabilir, bunları değiştirebilir ve söz konusu kaynağın hizmetindeki mutate yöntemine geri gönderebilirsiniz. Örnek bir iş akışı:
1. Şu anda PAUSED
olan ve 1.000'den fazla gösterime sahip tüm kampanyalar için bir sorgu yürütün.
1. Yanıtın campaign
alanındaki her GoogleAdsRow
öğesinden Campaign
nesnesini alın.
1. Her kampanyanın durumunu PAUSED
'dan ENABLED
'a değiştirin.
1. Değiştirilen kampanyaları kullanarak CampaignService.MutateCampaigns
işlevini çağırın.
Alan meta verileri
GoogleAdsFieldService
adresine gönderilen sorgular, alan meta verilerini almak için kullanılır.
Bu bilgiler, alanların bir sorguda birlikte nasıl kullanılabileceğini anlamak için kullanılabilir. Veriler API'den alınabildiğinden ve sorguyu doğrulamak ya da oluşturmak için gerekli meta veriler sağlandığından geliştiriciler bu işlemleri programatik olarak yapabilir. Meta veriler için tipik bir sorguyu aşağıda bulabilirsiniz:
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
Bu sorgudaki <INSERT_RESOURCE_OR_FIELD>
yerine bir kaynak (ör. customer
veya campaign
) ya da alan (ör. campaign.id
, metrics.impressions
veya ad_group.id
) kullanabilirsiniz.
Sorgulanabilir alanların listesi için GoogleAdsField
dokümanlarına bakın.
Kod örnekleri
İstemci kitaplıklarında, GoogleAdsService
dilinde Google Ads Sorgu Dili'nin kullanımına ilişkin örnekler bulunur. Temel işlemler klasöründe GetCampaigns
, GetKeywords
ve SearchForGoogleAdsFields
gibi örnekler bulunur.