Menarik data geografis untuk eksperimen

Untuk penarikan data otomatis atau skala besar untuk eksperimen GeoX, Anda harus menggunakan Google Ads API untuk menarik data biaya dan pembelanjaan. Anda harus menggabungkan data ini dengan data konversi atau pendapatan mentah, tidak difilter, dan tidak diatribusikan dari CRM internal, Tempat Penjualan (POS), atau database penjualan internal.

Arsitektur alur kerja API yang direkomendasikan

Untuk menarik data kampanye dan biaya secara akurat berdasarkan segmen geografis, ikuti arsitektur ini:

• Layanan: Gunakan GoogleAdsService, khususnya metode Search atau SearchStream.

• Resource: Buat kueri geographic_view untuk melihat lokasi fisik atau minat pengguna, yang biasanya merupakan standar untuk eksperimen GeoX. Atau, buat kueri location_view untuk melihat performa berdasarkan lokasi tertentu yang ditargetkan oleh kampanye.

  Catatan: Jangan gunakan campaign_location_target_report, karena laporan AdWords API lama ini telah dihentikan.

• Kolom yang akan disertakan:

  • campaign.id
  • segments.date
  • segments.geo_target_city (atau wilayah atau negara, bergantung pada granularitas GeoX)
  • metrics.cost_micros

• Contoh kueri GAQL: Untuk GeoX, pengiklan diharapkan menarik metrik biaya menggunakan Google Ads API, bukan konversi yang diatribusikan (yang harus berasal dari CRM internal atau sistem pihak ketiga). Anda dapat menggunakan kueri berikut:

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

Catatan: Jika Anda menarik metrik konversi dari Google Ads, Anda menarik konversi yang diatribusikan—artinya Anda hanya melihat penjualan yang kreditnya telah diklaim oleh algoritma Google. Penggunaan data yang diatribusikan sangat tidak disarankan di GeoX karena logika atribusi akan memengaruhi pengukuran kausalitas yang sebenarnya.

Pasca-pemrosesan dan ekstraksi data

• Pemetaan segmen geografis: API tidak menampilkan nama teks biasa (seperti "New York") atau kode singkat (seperti "501" atau "ES") dalam tampilan pelaporan. Kolom seperti segments.geo_target_city atau segments.geo_target_country menampilkan string nama resource yang mengarah ke GeoTargetConstant (misalnya, geoTargetConstants/1023191). Developer dapat membuat kueri tabel geo_target_constant secara langsung:

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

  Atau, untuk melakukan gabungan secara lokal dalam kode, download CSV target geografis statis di Target geografis.

• Konversi biaya: API menampilkan nilai biaya dalam mikro. Anda harus membagi metrics.cost_micros dengan 1.000.000 untuk menampilkan nilai mata uang standar yang diperlukan dalam file upload Anda.

Kode penargetan (DMA dan negara)

Saat menjalankan mutasi penargetan, pengiklan harus mencari dan meneruskan ID GeoTargetConstant yang tepat untuk wilayah yang dipilih. Anda tidak dapat meneruskan kode ISO atau Nielsen mentah.

Jenis Wilayah	ID API yang Diperlukan (GeoTargetConstant)	Format Lama (Jangan Gunakan)
Wilayah DMA	ID 200501 (untuk New York)	Kode Nielsen (misalnya, 501 untuk New York)
Negara	ID 2724 (untuk Spanyol)	Kode ISO (misalnya, "ES" untuk Spanyol)

Praktik terbaik dan error pemformatan umum

• Pemformatan tanggal: Kolom segments.date menampilkan data dalam format YYYY-MM-DD. Aplikasi spreadsheet seperti Excel sering kali mengubah format tanggal secara otomatis. Upload file Anda ke Google Spreadsheet terlebih dahulu untuk memastikan rentang tanggal dibaca secara akurat dalam format YYYY-MM-DD yang diperlukan.
• Angka nol di awal: Pastikan angka nol di awal kode pos (misalnya, 01234) tidak dihapus. Gunakan "Format angka kustom" di Google Spreadsheet untuk memaksa string 5 digit.
• Agregasi: Jika menjalankan studi multi-sel, Anda harus memberikan metrik pembelanjaan terpisah untuk setiap grup perlakuan.
• Menggabungkan data konversi: Saat menggabungkan dengan data konversi dari sistem CRM internal atau database penjualan internal, pastikan data konversi memiliki properti berikut untuk memastikan pemrosesan data yang lancar dengan data Google Ads API dan GeoX:
  • Deret waktu harian: Data harus diagregasi berdasarkan hari.
  • Tingkat geografis: Setiap konversi harus dipetakan ke unit geografis yang tepat yang Anda uji (misalnya, mencocokkan kode pos pengiriman pelanggan dengan DMA atau cluster pos yang digunakan dalam desain).
  • Nilai bruto: Data harus berupa nilai absolut non-negatif seperti Pendapatan Bruto atau Jumlah Konversi Bruto. Jika CRM Anda melacak Pendapatan Bersih dengan nilai negatif untuk pengembalian dana, Anda harus menggunakan angka bruto untuk eksperimen dan menerapkan rasio pengembalian dana nanti.