Google Ads kullanıcı arayüzünde ayrı bir menü olarak bulunan segmentasyon,
Google Ads API'de uygulanmasını sağlamak için bir sorguya uygun alanı eklemeniz yeterlidir. Örneğin,
Örneğin, segments.device
sorgusu sonucunda, her cihaz ve cihaz kombinasyonu için bir satır içeren
FROM
ifadesinde belirtilen kaynak ve
istatistiksel değerlerin (gösterimler, tıklamalar, dönüşümler vb.) nasıl bölündüğünü.
Google Ads kullanıcı arayüzünde aynı anda yalnızca bir segment kullanılabilir. API'den yararlanarak aynı sorguda birden fazla segment belirtebilirsiniz.
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions
FROM campaign
Bu sorgunun
GoogleAdsService.SearchStream
şu JSON dizesine benzer bir görünümde olacaktır:
{
"results":[
{
"campaign":{
"resourceName":"customers/1234567890/campaigns/111111111",
"name":"Test campaign",
"status":"ENABLED"
},
"metrics":{
"impressions":"10922"
},
"segments":{
"device":"MOBILE"
}
},
{
"campaign":{
"resourceName":"customers/1234567890/campaigns/111111111",
"name":"Test campaign",
"status":"ENABLED"
},
"metrics":{
"impressions":"28297"
},
"segments":{
"device":"DESKTOP"
}
},
...
]
}
Yukarıdaki örnek sonuçta, birinci ve ikinci kaynak adını içeren nesnelerin aynı olduğundan emin olun. Gösterimler segmentlere ayrılır. device değerine göre belirlenir ve dolayısıyla aynı kampanya için iki veya daha fazla nesne döndürülebilir.
Dolaylı segmentasyon
Her rapor başlangıçta FROM
sütununda belirtilen kaynağa göre segmentlere ayrılır.
ifadesini ekleyin. FROM
yan tümcesindeki kaynağın resource_name alanı
kaynak_adı alanı seçili olduğunda dahi, veriler kendisine göre segmentlere ayrılır.
sorguya açıkça dahil edilmez. Örneğin,
FROM
yan tümcesinde kaynak olarak ad_group
, ardından
ad_group.resource_name
şunu yapacak:
döner ve metrikler dolaylı olarak buna göre segmentlere ayrılır.
ad_group düzeyi [reklam grubu] düzeyidir.
Yani bu sorgu için
SELECT metrics.impressions
FROM ad_group
şuna benzer bir JSON dizesi elde edersiniz:
{
"results":[
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/2222222222"
},
"metrics":{
"impressions":"237"
}
},
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/33333333333"
},
"metrics":{
"impressions":"15"
}
},
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/44444444444"
},
"metrics":{
"impressions":"0"
}
}
]
}
adGroup
öğesinin resource_name
alanının her zaman döndürüldüğünü unutmayın. Bunun nedeni:
FROM
yan tümcesinde kaynak olarak ad_group
belirtildi.
Seçilebilir segment alanları
FROM
yan tümcesindeki belirli bir kaynak için tüm segment alanları seçilemez.
Örneğin, ad_group
üzerinden sorgulama yapmaya devam edeceğiz.
gösterir. Bir segment alanının ad_group kaynağından seçilebilmesi için
bu alanın ad_group için Segments
listesinde olması gerekir. Segments
liste, kullanılabilir alanlar tablosunun sarı renkli kısmıdır
ad_group
kaynağının meta veri sayfası.
Kaynakları segmentlere ayırın
Bazı kaynaklar arasından seçim yaparken dolaylı olarak katılma
alanları arasından seçim yaparak ilgili kaynaklarda
FROM
ifadesindeki kaynak kodunu girin. Bu ilgili kaynaklar
FROM
yan tümcesinin meta verilerindeki kaynakta Attributed Resources
listesi
sayfasını ziyaret edin. ad_group
kaynağı için bir panel görürsünüz.
Ayrıca, campaign
gösterir. En az şu değere sahip herhangi bir Attributed Resources
öğesinin resource_name alanı
SELECT
yan tümcesindeki 1 alan,
source_name alanı sorguya açıkça dahil edilmedi.
Attributed Resource
alanlarını seçmeye benzer şekilde, aynı zamanda
Segmenting Resource
alanları. Belirli bir kaynakta Segmenting Resources
varsa
listeleyip ardından listelenen bu kaynaklardan birindeki alanları seçerek
bu, sorgunun, söz konusu kaynağın döndürülen resource_name değerine göre daha fazla segmentlere ayrılmasına neden olur.
Segmenting Resource
. Örneğin,
campaign
kaynağı, Segmenting Resource
olarak listeleniyor
campaign_budget
kaynağı için. Herhangi biri seçiliyor
kampanya alanına (ör. campaign.name
)
campaign_budget kaynağı yalnızca campaign.name alanının
ancak
campaign.resource_name
alanı kullanılacak
ve segmentlere ayrılmış bir liste görürsünüz.
Segmentler ve metrikler arasında seçilebilirlik
Belirli bir segment alanı diğer segmentlerden bazılarıyla uyumlu olmayabilir
ya da metrik alanlarından bazılarıyla
karşılaştırabilirsiniz. Segment alanlarının
uyumlu olması için selectable_with
listesini inceleyebilirsiniz.
segmentlerinin SELECT
Belgenin
ad_group
kaynağı varsa, toplam 50'den fazla kullanılabilir
seçim yapabilirsiniz. Ancak selectable_with
listesi için
segments.hotel_check_in_date
uyumlu segmentlerden oluşan çok daha küçük bir gruptur. Yani, bir açıklama alanına
segments.hotel_check_in_date
alanına SELECT
ifadesini eklerseniz
bu iki segmentin kesişimine seçmek için elinizde bulunan mevcut segmentler
listeler.
- Bazı segmentler eklerken özet satırındaki metrikler azalabilir
- Sorguya
segments.keyword.info.match_type
eklendiğindeFROM ad_group_ad
içeriyorsa bu segment, sorguya yalnızca şu satırların anahtar kelime içeren verileri bulun ve anahtar kelime. Bu durumda metrikler daha düşük olur, çünkü yalnızca Anahtar kelime olmayan metrikler.
WHERE yan tümcesindeki segmentler için kurallar
WHERE
yan tümcesinde bir segment varsa SELECT
içinde de olmalıdır
ifadesini ekleyin. Bu kuralın bir istisnası vardır:
temel tarih segmentleri olarak adlandırılır:
segments.date
segments.week
segments.month
segments.quarter
segments.year
Temel tarih segmenti alanlarıyla ilgili kurallar
segments.date
, segments.week
, segments.month
,
segments.quarter
ve segments.year
aşağıdaki gibi çalışır:
Bu segmentler,
WHERE
yan tümcesinde görünmeden filtrelenebilir (SELECT
deyimi)Bu segmentlerden herhangi biri
SELECT
yan tümcesinde ise sınırlı bir tarih aralığı temel tarih segmentlerinden oluşan kısımWHERE
ifadesinde belirtilmelidir (Söz konusu tarih segmentlerinin,SELECT
) bilgileri gösterilir.
Örnekler
Geçersiz: segments.date olduğundan
SELECT yan tümcesinde, sonlu bir tarih aralığı belirtmeniz
segments.date için WHERE ifadesini,
segments.week , segments.month ,
segments.quarter veya segments.year .
|
SELECT campaign.name, metrics.clicks, segments.date FROM campaign |
Geçerli: Bu sorgu, kampanya adlarını ve
Tıklama sayısı (tıklama başına maliyet). Unutmayın: segments.date
SELECT yan tümcesinde görünmesi gerekmez.
|
SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
Geçerli: Bu sorgu, kampanya adlarını ve tarih aralığındaki tüm günler için tarihe göre segmentlere ayrılmış tıklamalar |
SELECT campaign.name, metrics.clicks, segments.date FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
Geçerli: Bu sorgu, kampanya adlarını ve tarih aralığındaki tüm günler için aya göre segmentlere ayrılmış tıklamalar |
SELECT campaign.name, metrics.clicks, segments.month FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
Geçerli: Bu sorgu, kampanya adlarını ve Tıklama sayısı çeyreğe ve ardından yıl aralığındaki tüm aylar için aya göre segmentlere ayrılır. |
SELECT campaign.name, metrics.clicks, segments.quarter, segments.month FROM campaign WHERE segments.year > 2015 AND segments.year < 2020 |
search_term_view
Not:
search_term_view
kaynağı, aynı zamanda
doğrudan bir arama terimine göre değil, doğrudan reklam grubuna göre
kaynağının yapısı
adı,
reklam grubunu da içerir. Bu nedenle, görünüşte aynı olan bazı
Arama terimleriniz, arama terimleriniz
listelenen satırlarda,
satırlar farklı bir reklam grubuna ait olurdu:
{
"results":[
{
"searchTermView":{
"resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
"searchTerm":"google photos"
},
"metrics":{
"impressions":"3"
},
"segments":{
"date":"2015-06-15"
}
},
{
"searchTermView":{
"resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
"searchTerm":"google photos"
},
"metrics":{
"impressions":"2"
},
"segments":{
"date":"2015-06-15"
}
}
]
}
Bu örnekte döndürülen iki nesne birbirinin aynısı gibi görünse de,
kaynak adları, özellikle "reklam grubu"nda, farklı olduğunda
bölümü. Yani, "google fotoğraflar" arama terimi her zaman
aynı tarihteki (15.06.2015) reklam grupları (kimlik: 2222222222
ve 33333333333
).
Bu nedenle, API'nin amaçlandığı gibi çalıştığı ve
yinelenen nesne olacaktır.