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
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.