Denemeler için coğrafi verileri çekme

GeoX denemeleri için otomatik veya büyük ölçekli veri çekme işlemleri söz konusu olduğunda 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.

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, kampanyanın hedeflediği belirli konumlara göre performansı görmek için location_view sorgusunu kullanabilirsiniz.

  • Dahil edilecek alanlar:

  • Ö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 çeker. 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

İşlem sonrası 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, GeoTargetConstant öğesini (örneğin, geoTargetConstants/1023191) işaret eden bir kaynak adı dizesi döndürür. Sayısal kimliği (1023191) ayıklayı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ştirme işlemini kodda yerel olarak gerçekleştirmek için Coğrafi hedefler bölümünden statik coğrafi hedefler CSV'sini indirin.

  • Maliyet dönüşümü: API, maliyet değerlerini mikro birim cinsinden döndürür. Yükleme dosyanızda gerekli olan 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

Kampanya veya reklam grubu konum hedefleme değişikliklerini uygularken reklamverenler, seçtikleri bölgeler için tam GeoTargetConstant kimliğini (geoTargetConstants/ID) aramalı ve iletmelidir. Ham ISO veya Nielsen kodları 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 (örneğin, New York için 501)
Ülke ID 2724 (İspanya için) ISO kodu (örneğin, İspanya için "ES")

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

  • Tarih biçimlendirmesi: segments.date alanı, YYYY-MM-DD biçiminde ISO-8601 tarih dizeleri döndürür. ETL işlem hattınızda tarih alanlarını açıkça YYYY-MM-DD dizeleri 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çmaktan kaçının.
  • Posta kodlarının başındaki sıfırlar: Veri ardışık düzeninizde posta kodlarını (ör. 01234) tam sayı yerine dize türleri (VARCHAR veya STRING) olarak değerlendirin. 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 deneme 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 gelen 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 rakamları kullanmanız ve daha sonra bir geri ödeme oranı uygulamanız gerekir.
Önceki
Raporlama
Sonraki
Eşzamansız hatalar