Menarik data geografis untuk eksperimen

Untuk pengambilan data otomatis atau berskala besar untuk eksperimen GeoX, Anda harus menggunakan Google Ads API untuk mengambil data biaya dan pembelanjaan. Kemudian, gabungkan data ini dengan data konversi atau pendapatan mentah, tidak difilter, dan tidak diatribusikan dari CRM internal, Sistem Titik 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 berikut:

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

• Sumber Daya: Kueri geographic_view untuk melihat lokasi fisik atau minat pengguna, yang biasanya merupakan standar untuk eksperimen GeoX. Atau, kueri location_view untuk melihat performa berdasarkan lokasi spesifik yang ditargetkan oleh kampanye.

• Kolom yang akan disertakan:

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

• Contoh kueri GAQL: Untuk GeoX, pengiklan menarik metrik biaya menggunakan Google Ads API, bukan konversi yang diatribusikan (yang harus berasal dari sistem CRM internal atau 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
  

Pascapemrosesan 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). Ekstrak ID numerik (1023191) dan buat kueri resource geo_target_constant:

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

  Atau, untuk melakukan penggabungan 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 menghasilkan nilai mata uang standar yang diperlukan dalam file upload Anda.

ID lokasi geografis untuk mutasi penargetan

Saat menjalankan mutasi penargetan lokasi kampanye atau grup iklan, pengiklan harus mencari dan meneruskan ID GeoTargetConstant (geoTargetConstants/ID) 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 string tanggal ISO-8601 dalam format YYYY-MM-DD. Di pipeline ETL, serialisasikan kolom tanggal secara eksplisit sebagai string YYYY-MM-DD dan hindari membuka file CSV yang diekspor di aplikasi spreadsheet yang secara otomatis memformat ulang kolom tanggal.
• Angka nol di awal kode pos: Perlakukan kode pos (misalnya, 01234) sebagai jenis string (VARCHAR atau STRING) di seluruh pipeline data Anda, bukan bilangan bulat, sehingga angka nol di awal tidak akan pernah dihapus.
• Penggabungan: 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 menurut 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 kotor: Data harus berupa nilai absolut non-negatif seperti Pendapatan Kotor atau Jumlah Konversi Kotor. Jika CRM Anda melacak Pendapatan Bersih dengan nilai negatif untuk pengembalian dana, Anda harus menggunakan angka kotor untuk eksperimen dan menerapkan rasio pengembalian dana nanti.