Ánh xạ trường

Sử dụng mối liên kết trong bảng để liên kết một UploadClickConversionRequest trong Google Ads API với IngestEventsRequest tương đương trong Data Manager API.

Xác thực

Data Manager API yêu cầu thông tin xác thực có phạm vi khác với Google Ads API. Làm theo các bước trong phần Thiết lập quyền truy cập API để tạo thông tin xác thực mới, bao gồm cả phạm vi của Data Manager API.

Trường yêu cầu

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (Data Manager API)	Ghi chú
customer_id tiêu đề của yêu cầu developer-token tiêu đề của yêu cầu login-customer_id tiêu đề của yêu cầu linked-customer-id conversion_action	destinations	Xem Trường khách hàng và hành động chuyển đổi.
Không có phiên bản mới	consent	Chế độ cài đặt mặc định về sự đồng ý (không bắt buộc) cho các sự kiện trong yêu cầu. Bạn có thể ghi đè giá trị này cho một sự kiện riêng lẻ bằng cách đặt trường consent của Event.
Không có phiên bản mới	encoding	Bắt buộc: Đặt thành Encoding dùng cho các giá trị UserIdentifier.
Không có phiên bản mới	encryption_info	Đặt nếu yêu cầu chứa các giá trị đã mã hoá. Hãy xem phần Mã hoá để biết thông tin chi tiết.
job_id	Không có phiên bản mới	Sử dụng request_id được trả về trong phản hồi để truy xuất diagnostics.
partial_failure	Không có phiên bản mới	Data Manager API sử dụng mô hình lỗi không thành công nhanh. Nếu bất kỳ trường nào của IngestEventsRequest không được xác thực, thì API Trình quản lý dữ liệu sẽ từ chối toàn bộ yêu cầu.
validate_only	validate_only
conversions	events	Danh sách lượt chuyển đổi hoặc sự kiện. Hãy xem mục Trường chuyển đổi để biết thông tin chi tiết.

Trường khách hàng và hành động chuyển đổi

Google Ads API yêu cầu tiêu đề của yêu cầu developer-token, đồng thời bạn phải đặt tiêu đề của yêu cầu login-customer-id và linked-customer-id cho các trường hợp xác thực khác nhau.

Data Manager API không yêu cầu mã của nhà phát triển và bạn chỉ định thông tin đăng nhập cũng như thông tin khách hàng được liên kết bằng các trường của Destination thay vì tiêu đề của yêu cầu. Hãy xem bài viết Định cấu hình đích đến để biết thêm thông tin về đích đến.

Sau đây là cách liên kết các trường của Google Ads API cho một conversion_action với các trường tương đương trong Destination:

API Google Ads	Destination (Data Manager API)	Ghi chú
customer_id của yêu cầu	operating_account	Đặt account_id thành mã khách hàng của tài khoản lượt chuyển đổi từ quảng cáo Google Ads. Giá trị này có thể khác với customer_id trong yêu cầu Google Ads API của bạn. Đặt account_type của operating_account thành GOOGLE_ADS.
tiêu đề của yêu cầu developer-token	Không có phiên bản mới	Bạn không cần phải có mã của nhà phát triển để sử dụng Data Manager API.
tiêu đề của yêu cầu login-customer-id	login_account	Đặt account_id thành mã khách hàng của tài khoản đăng nhập. Đặt account_type thành GOOGLE_ADS nếu tài khoản đăng nhập là tài khoản Google Ads hoặc DATA_PARTNER nếu tài khoản đăng nhập là tài khoản đối tác dữ liệu.
tiêu đề của yêu cầu linked-customer-id	linked_account	Nếu bạn đang truy cập vào operating_account bằng đường liên kết của đối tác, hãy đặt account_id thành mã khách hàng của tài khoản được liên kết và đặt account_type thành DATA_PARTNER. Nếu không, đừng đặt trường linked_account.
conversion_action/ClickConversion	product_destination_id	Đặt thành mã dạng số của hành động chuyển đổi. Đừng sử dụng tên tài nguyên của ConversionAction.
Không có phiên bản mới	reference	Giá trị nhận dạng do người dùng xác định cho Destination. Hãy đặt trường này nếu bạn đang gửi lượt chuyển đổi cho nhiều hành động chuyển đổi trong một yêu cầu.

Trường lượt chuyển đổi

ClickConversion (Google Ads API)	Event (Data Manager API)	Ghi chú
cart_data	cart_data	Hãy xem Trường dữ liệu giỏ hàng để biết thông tin chi tiết.
consent	consent	Cả hai API đều sử dụng một đối tượng Consent tương tự (ad_user_data, ad_personalization). Đối với Data Manager API, bạn cũng có thể đặt trạng thái đồng ý cho tất cả sự kiện trong một yêu cầu bằng cách đặt trường consent ở cấp yêu cầu.
conversion_action	destination_references	Nếu bạn gửi lượt chuyển đổi cho nhiều hành động chuyển đổi trong một yêu cầu, hãy đặt trường này thành reference tương ứng của đích đến.
conversion_date_time	event_timestamp	Nếu bạn sử dụng định dạng JSON, hãy đặt thành một giá trị ở định dạng RFC 3339. Định dạng này hơi khác so với định dạng ngày và giờ của Google Ads API. Nếu bạn sử dụng vùng đệm giao thức, hãy dùng Timestamp và đặt các trường seconds và nanoseconds (không bắt buộc). Hãy xem phần Định dạng dấu thời gian để biết thông tin chi tiết.
conversion_environment	Không có phiên bản mới
conversion_value	conversion_value	Đặt thành giá trị tiền tệ, không phải giá trị tính bằng micro. Ví dụ: đối với giá trị lượt chuyển đổi là 5, 23 đô la, hãy sử dụng giá trị 5.23.
currency_code	currency
custom_variables	custom_variables	Hãy xem phần Trường biến tuỳ chỉnh để biết thông tin chi tiết.
customer_type	user_properties.customer_type	Đặt thành một giá trị trong enum CustomerType.
Không có phiên bản mới	event_source
Không có phiên bản mới	event_device_info
external_attribution_data	Không có phiên bản mới
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
Không có phiên bản mới	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	Hãy xem phần Thêm thuộc tính của phiên để biết thông tin chi tiết.
session_attributes_key_value_pairs	experimental_fields	Hãy xem phần Thêm thuộc tính của phiên để biết thông tin chi tiết.
user_identifiers	user_data.user_identifiers	Hãy xem phần Trường giá trị nhận dạng người dùng để biết thông tin chi tiết.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

Trường dữ liệu giỏ hàng

CartData (Google Ads API)	CartData (Data Manager API)	Ghi chú
feed_country_code	merchant_feed_label	Đặt thành nhãn nguồn cấp dữ liệu.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

Trường mặt hàng cho dữ liệu giỏ hàng

Item (Google Ads API)	Item (Data Manager API)	Ghi chú
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
Không có phiên bản mới	item_id
Không có phiên bản mới	additional_item_parameters

Trường biến tuỳ chỉnh

CustomVariable (Google Ads API)	CustomVariable (Data Manager API)	Ghi chú
Không có phiên bản mới	destination_references	Google Ads API yêu cầu các yêu cầu riêng biệt cho mỗi hành động chuyển đổi. Data Manager API hỗ trợ gửi lượt chuyển đổi cho nhiều hành động chuyển đổi trong một yêu cầu, cũng như sử dụng trường destination_references này để cho biết những đích đến nào sẽ nhận được một biến tuỳ chỉnh cụ thể.
conversion_custom_variable	variable	Đặt thành tên của biến thay vì tên tài nguyên.
value	value

Trường giá trị nhận dạng người dùng

Mẹo: Trong Data Manager API, hãy thêm giá trị nhận dạng người dùng vào đối tượng UserData, sau đó đặt trường user_data của Event. Trong API Google Ads, giá trị nhận dạng người dùng được thêm trực tiếp vào ClickConversion trong trường user_identifiers.

UserIdentifier (Google Ads API)	UserIdentifier (Data Manager API)
address_info	address	Tuân thủ nguyên tắc định dạng và băm. Bạn cũng có thể mã hoá các thuộc tính đã băm của một địa chỉ.
hashed_email	email_address	Đặt thành địa chỉ email đã định dạng và băm. Bạn cũng có thể mã hoá địa chỉ email đã băm.
hashed_phone_number	phone_number	Đặt thành số điện thoại đã được định dạng và băm. Bạn cũng có thể mã hoá số điện thoại đã băm.
Các trường khác: mobile_id third_party_user_id user_identifier_source	Không liên quan	Cả hai API đều không hỗ trợ các giá trị nhận dạng này cho lượt chuyển đổi ngoại tuyến hoặc lượt chuyển đổi nâng cao cho khách hàng tiềm năng, và Data Manager API không hỗ trợ các giá trị nhận dạng này khi gửi sự kiện chuyển đổi dưới dạng một nguồn dữ liệu bổ sung.

Trường phản hồi

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (Data Manager API)	Ghi chú
job_id	Không có phiên bản mới	Sử dụng request_id được trả về trong phản hồi để truy xuất diagnostics.
partial_failure_error	Không có phiên bản mới	Data Manager API sử dụng mô hình lỗi không thành công nhanh. Nếu bất kỳ trường nào của IngestEventsRequest không được xác thực, thì API Trình quản lý dữ liệu sẽ từ chối toàn bộ yêu cầu.
request-id tiêu đề phản hồi	request_id	Mã yêu cầu được trả về dưới dạng trường phản hồi trong API Trình quản lý dữ liệu thay vì dưới dạng tiêu đề phản hồi.
results	Không có phiên bản mới	Data Manager API xử lý các sự kiện không đồng bộ. Kiểm tra kết quả xử lý bằng công cụ chẩn đoán.