Pemetaan kolom

Gunakan pemetaan dalam tabel untuk memetakan UploadClickConversionRequest di Google Ads API ke IngestEventsRequest yang setara di Data Manager API.

Kolom permintaan

`UploadClickConversionRequest` (Google Ads API)	`IngestEventsRequest` (Data Manager API)	Catatan
`customer_id` Header permintaan `developer-token` Header permintaan `login-customer_id` Header permintaan `linked-customer-id` `conversion_action`	`destinations`	Lihat Kolom tindakan konversi dan pelanggan.
Tidak ada ekuivalen	`consent`	Setelan izin default opsional untuk peristiwa dalam permintaan. Anda dapat mengganti nilai ini untuk setiap peristiwa dengan menyetel kolom `consent` dari `Event`.
Tidak ada ekuivalen	`encoding`	Wajib: Ditetapkan ke `Encoding` yang digunakan untuk nilai `UserIdentifier`.
Tidak ada ekuivalen	`encryption_info`	Tetapkan apakah permintaan berisi nilai terenkripsi. Lihat Enkripsi untuk mengetahui detailnya.
`job_id`	Tidak ada ekuivalen	Gunakan `request_id` yang ditampilkan dalam respons untuk mengambil diagnostik.
`partial_failure`	Tidak ada ekuivalen	API Pengelola Data tidak mendukung kegagalan sebagian. Jika ada kolom `IngestEventsRequest` yang gagal divalidasi, Data Manager API akan menolak seluruh permintaan.
`validate_only`	`validate_only`
`conversions`	`events`	Daftar konversi atau peristiwa. Lihat bagian Kolom konversi untuk mengetahui detailnya.

Kolom tindakan konversi dan pelanggan

Google Ads API memerlukan header permintaan developer-token, dan Anda menetapkan login-customer-id dan linked-customer-id header permintaan untuk berbagai skenario autentikasi.

Data Manager API tidak memerlukan token developer, dan Anda menentukan informasi login dan pelanggan tertaut menggunakan kolom Destination, bukan header permintaan. Lihat Mengonfigurasi tujuan untuk mengetahui informasi selengkapnya tentang tujuan.

Berikut cara memetakan kolom Google Ads API untuk satu conversion_action ke kolom yang setara dalam Destination:

Google Ads API	`Destination` (Data Manager API)	Catatan
`customer_id` permintaan	`operating_account`	Tetapkan `account_id` ke ID pelanggan akun konversi Google Ads. Tetapkan `account_type` dari `operating_account` ke `GOOGLE_ADS`. Data Manager API mungkin memerlukan ID pelanggan yang berbeda dengan yang Anda gunakan untuk Google Ads API. Lihat Perbedaan persyaratan akun tujuan untuk mengetahui detailnya.
Header permintaan `developer-token`	Tidak ada ekuivalen	Token developer tidak diperlukan untuk Data Manager API.
Header permintaan `login-customer-id`	`login_account`	Tetapkan `account_id` ke ID pelanggan akun login. Tetapkan `account_type` ke `GOOGLE_ADS` jika akun login adalah akun Google Ads, atau `DATA_PARTNER` jika akun login adalah akun partner data.
Header permintaan `linked-customer-id`	`linked_account`	Setel `account_id` ke ID pelanggan akun tertaut. Setel `account_type` ke `DATA_PARTNER`.
`conversion_action` dari `ClickConversion`	`product_destination_id`	Disetel ke ID numerik tindakan konversi. Jangan gunakan nama resource `ConversionAction`.
Tidak ada ekuivalen	`reference`	ID yang ditentukan pengguna untuk `Destination`. Tetapkan kolom ini jika Anda mengirim konversi untuk beberapa tindakan konversi dalam satu permintaan.

Kolom konversi

`ClickConversion` (Google Ads API)	`Event` (Data Manager API)	Catatan
`cart_data`	`cart_data`	Lihat Kolom data keranjang untuk mengetahui detailnya.
`consent`	`consent`	Kedua API menggunakan objek `Consent` yang serupa (`ad_user_data`, `ad_personalization`). Untuk Data Manager API, Anda juga dapat menetapkan izin untuk semua peristiwa dalam permintaan dengan menetapkan kolom `consent` tingkat permintaan.
`conversion_action`	`destination_references`	Jika mengirim konversi untuk beberapa tindakan konversi dalam satu permintaan, tetapkan kolom ini ke `reference` yang sesuai dari tujuan.
`conversion_date_time`	`event_timestamp`	Jika menggunakan format JSON, tetapkan ke nilai dalam format RFC 3339, yang sedikit berbeda dari format tanggal dan waktu Google Ads API. Jika menggunakan buffer protokol, gunakan `Timestamp` dan tetapkan kolom `seconds` dan (opsional) `nanoseconds`. Lihat Format stempel waktu untuk mengetahui detailnya.
`conversion_environment`	Tidak ada ekuivalen
`conversion_value`	`conversion_value`	Tetapkan ke nilai mata uang, bukan nilai dalam mikro. Misalnya, untuk nilai konversi sebesar Rp5.230, gunakan nilai `5.23`.
`currency_code`	`currency`
`custom_variables`	`custom_variables`	Lihat Kolom variabel kustom untuk mengetahui detailnya.
`customer_type`
Tidak ada ekuivalen	`event_source`
Tidak ada ekuivalen	`event_device_info`
`external_attribution_data`	Tidak ada ekuivalen
`gbraid`	`ad_identifiers.gbraid`
`gclid`	`ad_identifiers.gclid`
Tidak ada ekuivalen	`last_updated_timestamp`
`order_id`	`transaction_id`
`session_attributes_encoded`	`ad_identifiers.session_attributes`	Lihat Menambahkan atribut sesi untuk mengetahui detailnya.
`session_attributes_key_value_pairs`	`experimental_fields`	Lihat Menambahkan atribut sesi untuk mengetahui detailnya.
`user_identifiers`	`user_data.user_identifiers`	Lihat Kolom ID pengguna untuk mengetahui detailnya.
`user_ip_address`	`landing_page_device_info.ip_address`
`wbraid`	`ad_identifiers.wbraid`

Kolom data keranjang

`CartData` (Google Ads API)	`CartData` (Data Manager API)	Catatan
`feed_country_code`	`merchant_feed_label`	Ditetapkan ke label feed.
`feed_language_code`	`merchant_feed_language_code`
`items`	`items`
`local_transaction_cost`	`transaction_discount`
`merchant_id`	`merchant_id`

Kolom item untuk data keranjang

`Item` (Google Ads API)	`Item` (Data Manager API)	Catatan
`product_id`	`merchant_product_id`
`quantity`	`quantity`
`unit_price`	`unit_price`
Tidak ada ekuivalen	`item_id`
Tidak ada ekuivalen	`additional_item_parameters`

Kolom variabel kustom

`CustomVariable` (Google Ads API)	`CustomVariable` (Data Manager API)	Catatan
Tidak ada ekuivalen	`destination_references`	Google Ads API memerlukan permintaan terpisah per tindakan konversi. Data Manager API mendukung pengiriman konversi untuk beberapa tindakan konversi dalam satu permintaan, serta penggunaan kolom `destination_references` ini untuk menunjukkan tujuan mana yang harus menerima variabel kustom tertentu.
`conversion_custom_variable`	`variable`	Ditetapkan ke nama variabel, bukan nama resource.
`value`	`value`

Kolom ID pengguna

`UserIdentifier` (Google Ads API)	`UserIdentifier` (Data Manager API)
`address_info`	`address`	Ikuti panduan pemformatan dan hashing. Anda juga dapat mengenkripsi atribut alamat yang di-hash.
`hashed_email`	`email_address`	Disetel ke alamat email yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat email yang di-hash.
`hashed_phone_number`	`phone_number`	Disetel ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenkripsi nomor telepon yang di-hash.
Kolom lainnya: `mobile_id` `third_party_user_id` `user_identifier_source`	Tidak relevan	Kedua API tidak mendukung ID ini untuk konversi offline atau konversi yang disempurnakan untuk lead, dan Data Manager API tidak mendukung ID ini saat mengirim peristiwa konversi sebagai sumber data tambahan.

Kolom respons

`UploadClickConversionResponse` (Google Ads API)	`IngestEventsResponse` (Data Manager API)	Catatan
`job_id`	Tidak ada ekuivalen	Gunakan `request_id` yang ditampilkan dalam respons untuk mengambil diagnostik.
`partial_failure_error`	Tidak ada ekuivalen	API Pengelola Data tidak mendukung kegagalan sebagian. Jika ada kolom `IngestEventsRequest` yang gagal divalidasi, Data Manager API akan menolak seluruh permintaan.
`request-id` header respons	`request_id`	ID permintaan ditampilkan sebagai kolom respons di Data Manager API, bukan sebagai header respons.
`results`	Tidak ada ekuivalen	Data Manager API memproses peristiwa secara asinkron. Periksa hasil pemrosesan menggunakan diagnostik.

Sebelumnya

Langkah-langkah untuk mengupgrade