Upgrade dari Google Ads API

Upgrade upload konversi Anda dari Google Ads API ke Data Manager API untuk mendapatkan akses ke beberapa peningkatan dan fitur.

Berikut perbandingan antara penggunaan Data Manager API dan Google Ads API untuk mengelola konversi.

	Data Manager API	Google Ads API
Dukungan untuk mengirim konversi offline dan konversi yang disempurnakan untuk lead	Didukung.	Didukung.
Dukungan untuk mengirim konversi tag Google Ads sebagai sumber data tambahan untuk konversi tag Anda, guna memaksimalkan sinyal interaksi iklan serta memperkuat data dan performa secara keseluruhan	Didukung.	Tidak didukung.
Model data	Model data terpadu di semua kasus penggunaan konversi Google Ads dan semua produk iklan Google.	Model data hanya untuk kasus penggunaan Google Ads, dan berbeda untuk setiap kasus penggunaan.
Enkripsi	Mendukung enkripsi.	Tidak didukung.
Token Developer	Tidak diperlukan.	Wajib.
Dukungan untuk mengupload atribut sesi dan alamat IP untuk peristiwa	Tersedia untuk semua pengguna API.	Hanya tersedia untuk pengguna API tertentu.
Penyesuaian konversi	Didukung dalam metode IngestEvents terpadu.	Memerlukan ConversionAdjustmentUploadService terpisah.
Kuota dan batas	Kuota dan batas per permintaan berbasis project.	Kuota berbasis token developer dan batas per permintaan.
Model error	Menggunakan model gagal cepat.	Menggunakan model kegagalan parsial.

Perbedaan persyaratan akun tujuan

Di Data Manager API, operating_account dari tujuan harus berupa pelanggan konversi Google Ads. Hal ini berbeda dengan Google Ads API.

Istilah Utama: Pelanggan konversi Google Ads adalah akun Google Ads yang memiliki tindakan konversi yang diidentifikasi oleh product_destination_id dari tujuan.

Google Ads API mendukung pengiriman konversi untuk akun Google Ads menggunakan customer_id dari salah satu opsi berikut:

1. Pelanggan konversi Google Ads.

   Data Manager API mendukung pendekatan ini.

2. Akun apa pun yang merupakan induk atau turunan dari pelanggan konversi Google Ads.

   API Pengelola Data tidak mendukung pendekatan ini. Jika Anda memanfaatkan perilaku ini di Google Ads API, ubah operating_account setiap tujuan ke pemilik tindakan konversi. Nilai ini mungkin berbeda dengan customer_id yang Anda gunakan dalam permintaan Google Ads API.

Penyesuaian konversi

Data Manager API menyatukan upload konversi awal dan penyesuaian konversi berikutnya ke dalam satu metode.

Di Google Ads API:

• Penyesuaian konversi memerlukan penggunaan metode UploadConversionAdjustments terpisah di ConversionAdjustmentUploadService.
• Jika Anda mencoba mengupload beberapa konversi menggunakan metode UploadClickConversions standar untuk tindakan konversi yang sama dengan ID transaksi yang sama (order_id), permintaan akan gagal.
• Anda harus menentukan ConversionAdjustmentType dalam permintaan.

Di Data Manager API:

• Upload dan penyesuaian konversi menggunakan endpoint IngestEvents terpadu.
• Mengupload peristiwa dengan transaction_id yang ada untuk tindakan konversi yang sama dengan nilai konversi atau data pengguna yang diperbarui akan ditangani secara otomatis sebagai penyesuaian. API tidak akan menampilkan error ID transaksi duplikat.
• Jenis penyesuaian tidak diperlukan dalam permintaan. Data Manager API menyimpulkan cara memproses penyesuaian berdasarkan kolom yang diberikan dalam peristiwa.
• Tidak seperti Google Ads API, Data Manager API tidak mendukung pembatalan konversi, yang menghapus konversi yang sebelumnya dicatat sepenuhnya dengan menyetel nilai dan jumlah konversinya ke 0. Anda dapat menyatakan ulang nilai konversi, tetapi jumlah konversi akan tetap sama.

Untuk mengetahui detail selengkapnya, lihat Penyesuaian konversi.