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 Mengupgrade dari Google Ads API untuk membandingkan cara penyesuaian ditangani di setiap API.
Jenis konversi yang didukung
Anda dapat menyesuaikan jenis konversi Google Ads berikut:
- Konversi multi-sumber: Konversi yang dicatat oleh tag Google situs Anda untuk tindakan konversi
WEBSITE. - Konversi offline dan konversi yang disempurnakan untuk lead:
Peristiwa offline yang sebelumnya diupload untuk tindakan konversi
UPLOAD_CLICKS.
Cara kerja penyesuaian
Dalam tindakan konversi yang sama, Google Ads mencocokkan peristiwa menggunakan
transactionId:
- Jika
transactionIdcocok dengan konversi yang ada untuk tindakan konversi yang sama, Data Manager API akan memperlakukan permintaan tersebut sebagai penyesuaian konversi. - Jika
transactionIdtidak 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:
transactionIdyang sama dengan acara asli.- Tujuan dan tindakan konversi yang sama dengan peristiwa asli.
- Nilai yang diperbarui untuk kolom yang ingin Anda sesuaikan.
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 cara mengirim permintaan penyerapan, lihat Mengirim peristiwa.
Kolom yang didukung
Tabel berikut mencantumkan kolom yang dapat Anda sesuaikan dan cara penerapan pembaruan:
| Kolom | Perilaku |
|---|---|
conversionValue, currency |
Ditimpa. Nilai baru akan menggantikan nilai yang tercatat. |
userData |
Ditambahkan jika peristiwa asli tidak memiliki data pengguna, jika tidak, diabaikan. |
Semua kolom lainnya, seperti adIdentifiers.gclid |
Diabaikan |
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 diambil 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
mengabaikan kolom ini dan mempertahankan nilai yang dicatat dengan peristiwa asli.
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.