Segmentasyon

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ğinde FROM 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ım WHERE ifadesinde belirtilmelidir (Söz konusu tarih segmentlerinin, SELECT) bilgileri gösterilir.

Örnekler

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

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.