Denemeler için coğrafi verileri çekme

GeoX denemeleri için otomatik veya büyük ölçekli veri çekme işlemleri için maliyet ve harcama verilerini çekmek üzere Google Ads API'yi kullanmanız gerekir. Bu verileri, dahili CRM'nizden, bir satış noktasından (POS) veya dahili satış veritabanlarından alınan ham, filtrelenmemiş ve ilişkilendirilmemiş dönüşüm ya da gelir verileriyle birleştirmeniz gerekir.

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

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

  • Kaynak: Kullanıcının fiziksel olarak bulunduğu veya ilgilendiği yeri görmek için geographic_view sorgusunu gönderin. 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 kullanın.

  • Dahil edilecek alanlar:

  • Örnek GAQL sorgusu: GeoX için reklamverenlerin, ilişkilendirilmiş dönüşümler (dahili CRM veya üçüncü taraf sistemlerinden gelmesi gerekir) yerine Google Ads API'yi kullanarak maliyet metriklerini çekmesi beklenir. 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

İşleme 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" ya da "ES" gibi) döndürmez. segments.geo_target_city veya segments.geo_target_country gibi alanlar, GeoTargetConstant'ı (örneğin, geoTargetConstants/1023191) işaret eden bir kaynak adı dizesi döndürür. Geliştiriciler, geo_target_constant tablosunu doğrudan sorgulayabilir:

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

    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 mikrosaniye 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.

Hedefleme kodları (TPA ve ülke)

Hedefleme mutasyonları yürütülürken reklamverenler, seçtikleri bölgeler için tam GeoTargetConstant kimliği aramalı ve iletmelidir. Ham ISO veya Nielsen kodlarını iletemezsiniz.

Bölge Türü Gerekli API kimliği (GeoTargetConstant) Eski Biçim (Kullanmayın)
TPA 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ı, verileri YYYY-MM-DD biçiminde döndürür. Excel gibi e-tablo uygulamaları, tarih biçimlerini genellikle otomatik olarak değiştirir. Tarih aralığının gerekli YYYY-MM-DD biçimde doğru şekilde okunmasını sağlamak için dosyanızı önce Google E-Tablolar'a yükleyin.
  • Baştaki sıfırlar: Posta kodlarındaki baştaki sıfırların (örneğin, 01234) kaldırılmadığından emin olun. 5 haneli bir dizeyi zorunlu kılmak için Google E-Tablolar'da "Özel sayı biçimi"ni kullanın.
  • 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şlenmelidir (örneğin, müşterinin kargo posta kodunu tasarımda kullanılan TPA veya posta kümesiyle eşleştirme).
    • Brüt değerler: Veriler, negatif olmayan mutlak değerler olmalıdır (ör. brüt gelir veya brüt dönüşüm sayısı). CRM'niz, geri ödemeler için negatif değerlerle net geliri izliyorsa deneme için brüt sayıları kullanmanız ve daha sonra geri ödeme oranı uygulamanız gerekir.