Pemetaan kolom

Gunakan pemetaan dalam tabel untuk memetakan an UploadClickConversionRequest di Google Ads API ke its 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 pelanggan dan tindakan konversi.
Tidak ada ekuivalen	consent	Setelan izin default opsional untuk peristiwa dalam permintaan. Anda dapat mengganti nilai ini untuk setiap peristiwa dengan menetapkan kolom consent dari Event.
Tidak ada ekuivalen	encoding	Wajib: Tetapkan ke Encoding yang digunakan untuk nilai UserIdentifier.
Tidak ada ekuivalen	encryption_info	Tetapkan jika 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	Data Manager API tidak mendukung kegagalan sebagian. Jika ada kolom IngestEventsRequest yang gagal validasi, 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 pelanggan dan tindakan konversi

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

Data Manager API tidak memerlukan token developer, dan Anda menentukan informasi pelanggan login dan 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 di 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.
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	Jika Anda mengakses operating_account menggunakan link partner, tetapkan account_id ke ID pelanggan akun tertaut dan tetapkan account_type ke DATA_PARTNER. Jika tidak, jangan tetapkan kolom linked_account.
conversion_action dari ClickConversion	product_destination_id	Tetapkan 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 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 $5,23, 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	Tetapkan 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 menggunakan kolom destination_references ini untuk menunjukkan tujuan mana yang harus menerima variabel kustom tertentu.
conversion_custom_variable	variable	Tetapkan 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 mengenktipsi atribut alamat yang di-hash.
hashed_email	email_address	Tetapkan ke alamat email yang diformat dan di-hash. Anda juga dapat mengenktipsi alamat email yang di-hash.
hashed_phone_number	phone_number	Tetapkan ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenktipsi nomor telepon yang di-hash.
Kolom lainnya: mobile_id third_party_user_id user_identifier_source	Tidak relevan	Tidak ada API yang mendukung ID ini untuk konversi offline atau konversi yang ditingkatkan untuk prospek, 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	Data Manager API tidak mendukung kegagalan sebagian. Jika ada kolom IngestEventsRequest yang gagal validasi, 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.