Penyesuaian konversi

Gunakan metode IngestEvents untuk melakukan penyesuaian pada konversi Google Ads yang direkam sebelumnya. Di Data Manager API, penyesuaian dapat mengubah nilai konversi atau melengkapi data pengguna.

Jika Anda bermigrasi dari Google Ads API, lihat bagian Upgrade dari Google Ads API untuk membandingkan cara penyesuaian ditangani di setiap API.

Jenis konversi yang didukung

Anda dapat menyesuaikan jenis konversi Google Ads berikut:

Cara kerja penyesuaian

Dalam tindakan konversi yang sama, Google Ads mencocokkan peristiwa menggunakan transactionId:

  • Jika transactionId cocok dengan konversi yang ada untuk tindakan konversi yang sama, Data Manager API akan memperlakukan permintaan tersebut sebagai penyesuaian konversi.
  • Jika transactionId tidak cocok dengan konversi yang ada, Google Ads akan membuat konversi baru. Lihat Peristiwa yang tidak cocok.

Mengirim penyesuaian

Untuk menyesuaikan konversi yang ada, kirim permintaan IngestEvents yang mencakup:

  • transactionId yang sama dengan acara asli.
  • Tujuan dan tindakan konversi yang sama dengan peristiwa asli.
  • Nilai yang diperbarui untuk kolom yang ingin Anda sesuaikan.
  • Semua kolom yang diperlukan untuk peristiwa, termasuk setidaknya satu ID, seperti adIdentifiers atau userData. Lihat persyaratan peristiwa dan ID untuk konversi offline atau konversi multi-sumber.

Sebaiknya kirimkan ID yang sama dengan yang Anda kirimkan atau ambil dengan peristiwa asli. Jika transactionId tidak cocok dengan konversi yang ada, Google Ads akan menggunakan ID ini untuk mengatribusikan konversi baru.

Anda tidak perlu menentukan jenis penyesuaian. Data Manager API menyimpulkan cara memproses permintaan berdasarkan transactionId dan kolom yang Anda berikan.

Untuk mengetahui informasi selengkapnya tentang pengiriman permintaan penyerapan, lihat panduan untuk mengirim peristiwa untuk konversi offline atau konversi multi-sumber.

Kolom yang didukung

Tabel berikut mencantumkan cara Google Ads menerapkan setiap kolom saat peristiwa cocok dengan konversi yang ada:

Kolom Perilaku
conversionValue, currency Ditimpa. Nilai baru menggantikan nilai yang dicatat.
userData Ditambahkan jika peristiwa asli tidak memiliki data pengguna, jika tidak, diabaikan.
Semua kolom lainnya, seperti adIdentifiers.gclid Tidak diperbarui. Google Ads menyimpan nilai yang dicatat dengan peristiwa asli. Kolom wajib diisi harus tetap ada.

Nilai konversi

Kirim conversionValue dan currency baru untuk menyatakan ulang nilai konversi yang direkam. Nilai baru menggantikan nilai yang sebelumnya dicatat dalam pelaporan dan bidding, tanpa menambah jumlah konversi.

Data pengguna

Berikut cara Google Ads menangani userData, seperti alamat email atau nomor telepon:

  • Dilengkapi jika tidak ada: Jika peristiwa asli dicatat tanpa data pengguna, penyesuaian akan melampirkan data pengguna untuk meningkatkan atribusi.

  • Diabaikan jika ada: Jika tag Google atau upload sebelumnya telah mengambil data pengguna, data pengguna baru akan diabaikan. Data pengguna yang ada tidak ditimpa atau ditambahkan.

Kolom lainnya

ID dan metadata selain nilai konversi, mata uang, dan data pengguna, seperti adIdentifiers.gclid, tidak dapat diperbarui untuk peristiwa yang cocok. Google Ads mempertahankan nilai yang dicatat dengan peristiwa asli.

Anda tetap harus menyertakan kolom yang wajib diisi, seperti setidaknya satu ID. Data Manager API memvalidasinya untuk setiap peristiwa.

Peristiwa yang tidak cocok

Jika transactionId tidak cocok dengan peristiwa yang ada, permintaan akan diperlakukan sebagai upload konversi baru, bukan penyesuaian.

Google Ads mencoba mengatribusikan konversi baru ke klik iklan menggunakan ID yang Anda berikan, seperti adIdentifiers.gclid atau userData.