Denemeler için coğrafi verileri çekme

GeoX denemeleri için otomatik veya büyük ölçekli veri çekme işlemlerinde maliyet ve harcama verilerini çekmek için Google Ads API'yi kullanmanız gerekir. Ardından bu verileri dahili CRM'nizden, satış noktanızdan (POS) veya dahili satış veritabanlarınızdan gelen ham, filtrelenmemiş ve ilişkilendirilmemiş dönüşüm ya da gelir verileriyle birleştirirsiniz.

Önerilen API iş akışı mimarisi

Kampanya ve maliyet verilerini coğrafi segmentlere göre doğru şekilde almak için şu mimariyi kullanın:

• Hizmet: GoogleAdsService, özellikle Search veya SearchStream yöntemlerini kullanın.

• Kaynak: Kullanıcının fiziksel olarak nerede bulunduğunu veya neresiyle ilgilendiğini görmek için geographic_view sorgusunu kullanın. Bu, genellikle GeoX denemeleri için standarttır. Alternatif olarak, kampanya tarafından hedeflenen belirli konumlara göre performansı görmek için location_view sorgusunu kullanabilirsiniz.

  Not: Bu eski AdWords API raporu kullanımdan kaldırıldığı için campaign_location_target_report kullanmayın.

• Dahil edilecek alanlar:

  • campaign.id
  • segments.date
  • segments.geo_target_city (veya GeoX ayrıntı düzeyine bağlı olarak bölge ya da ülke)
  • metrics.cost_micros

• Örnek GAQL sorgusu: GeoX için reklamverenler, ilişkilendirilmiş dönüşümler (dahili CRM veya üçüncü taraf sistemlerinden gelmelidir) yerine Google Ads API'yi kullanarak maliyet metriklerini alır. Aşağıdaki sorguyu kullanabilirsiniz:

  SELECT
    campaign.id,
    segments.date,
    segments.geo_target_city,
    metrics.cost_micros
  FROM geographic_view
  WHERE segments.date DURING LAST_30_DAYS
  

  Not: geographic_view, yalnızca belirli bir tarihte gösterim veya harcama kaydeden coğrafi segmentler için satır döndürür. Harcama yapılmayan günleri ve bölgeleri GeoX zaman serinize dahil etmek için veri ardışık düzeninizde, tarihlerin ve hedef bölgelerin tam kartezyen ürününe karşı bir sol dış birleştirme gerçekleştirin.

Not: Dönüşüm metriklerini Google Ads'den alıyorsanız ilişkilendirilmiş dönüşümleri alıyorsunuz demektir. Yani yalnızca Google'ın algoritmasının kredi aldığı satışlara bakıyorsunuz. İlişkilendirme mantığı nedensel ölçümü saptırdığı için GeoX'te ilişkilendirilmiş verilerin kullanılması kesinlikle önerilmez.

Son işleme ve veri ayıklama

• Coğrafi segment eşleme: API, raporlama görünümlerinde düz metin adları ("New York" gibi) veya kısa kodlar ("501" veya "ES" gibi) döndürmez. segments.geo_target_city veya segments.geo_target_country gibi alanlar, bir GeoTargetConstant öğesine işaret eden kaynak adı dizesi döndürür (ör. geoTargetConstants/1023191). Sayısal kimliği (1023191) çıkarın ve geo_target_constant kaynağını sorgulayın:

  SELECT
    geo_target_constant.id,
    geo_target_constant.name,
    geo_target_constant.canonical_name
  FROM geo_target_constant
  WHERE geo_target_constant.id = 1023191
  

  Alternatif olarak, birleştirmeyi kodda yerel olarak gerçekleştirmek için Coğrafi hedefler sayfasından statik coğrafi hedefler CSV dosyasını indirin.

• Maliyet dönüşümü: API, maliyet değerlerini mikro birim cinsinden döndürür. Yükleme dosyanızda gereken standart para birimi değerini elde etmek için metrics.cost_micros değerini 1.000.000'a bölmeniz gerekir.

Değişiklikleri hedeflemek için coğrafi konum kimlikleri

Reklamverenler, kampanya veya reklam grubu konum hedefleme mutasyonlarını uygularken seçtikleri bölgeler için tam GeoTargetConstant kimliğini (geoTargetConstants/ID) bulup iletmelidir. Ham ISO veya Nielsen kodlarını iletemezsiniz.

Bölge Türü	Gerekli API kimliği (GeoTargetConstant)	Eski Biçim (Kullanmayın)
DMA Bölgesi	Kimlik 200501 (New York için)	Nielsen Kodu (ör. New York için 501)
Ülke	Kimlik 2724 (İspanya için)	ISO kodu (ör. İspanya için "ES")

En iyi uygulamalar ve yaygın biçimlendirme hataları

• Tarih biçimlendirme: segments.date alanı, YYYY-MM-DD biçiminde ISO-8601 tarih dizeleri döndürür. ETL ardışık düzeninizde tarih alanlarını açıkça YYYY-MM-DD dizesi olarak serileştirin ve dışa aktarılan CSV dosyalarını, tarih sütunlarını otomatik olarak yeniden biçimlendiren e-tablo uygulamalarında açmayın.
• Posta kodlarının başındaki sıfırlar: Posta kodlarını (ör. 01234) veri ardışık düzeninizde tam sayı yerine dize türleri (VARCHAR veya STRING) olarak ele alın. Böylece baştaki sıfırlar hiçbir zaman kaldırılmaz.
• Toplama: Çok hücreli bir çalışma yürütüyorsanız her bir deney kolu için ayrı harcama metrikleri sağlamanız gerekir.
• Dönüşüm verilerini birleştirme: Dahili bir CRM sisteminden veya dahili satış veritabanlarından alınan dönüşüm verileriyle birleştirme yaparken, Google Ads API verileri ve GeoX ile sorunsuz veri işleme sağlamak için dönüşüm verilerinin aşağıdaki özelliklere sahip olduğundan emin olun:
  • Günlük zaman serisi: Veriler güne göre toplanmalıdır.
  • Coğrafi düzey: Her dönüşüm, test ettiğiniz coğrafi birimlerle tam olarak eşleştirilmelidir (örneğin, müşterinin kargo posta kodunun tasarımda kullanılan TPA veya posta kümesiyle eşleştirilmesi).
  • Brüt değerler: Veriler, brüt gelir veya brüt dönüşüm sayıları gibi negatif olmayan mutlak değerler olmalıdır. CRM'niz net geliri geri ödemeler için negatif değerlerle izliyorsa deneme için brüt sayıları kullanmanız ve daha sonra bir geri ödeme oranı uygulamanız gerekir.