Chế độ cài đặt mặc định không bắt buộc về sự đồng ý 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 được 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ị được 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 thông tin chẩn đoán.
partial_failure
Không có phiên bản mới
API Trình quản lý dữ liệu không hỗ trợ lỗi một phần. Nếu bất kỳ trường nào của IngestEventsRequest không xác thực được, Data Manager API 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.
Các trường khách hàng và hành động chuyển đổi
Google Ads API yêu cầu tiêu đề yêu cầu developer-token và bạn đặt login-customer-id và linked-customer-idtiêu đề yêu cầu 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 và thông tin khách hàng được liên kết bằng cách sử dụng các trường của Destination thay vì tiêu đề yêu cầu. Hãy xem bài viết Định cấu hình vị trí xuất hiện để biết thêm thông tin về vị trí xuất hiện.
Sau đây là cách liên kết các trường API Google Ads cho một conversion_action với các trường tương đương trong một Destination:
Bạn không cần mã của nhà phát triển cho 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
Đặt account_id thành mã khách hàng của tài khoản được liên kết. Đặt account_type thành DATA_PARTNER.
conversion_action của ClickConversion
product_destination_id
Đặt thành mã nhận dạng dạng số của hành động chuyển đổi. Đừng sử dụng tên tài nguyên của ConversionAction.
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 sự đồng ý cho tất cả cá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.
Đặt thành giá trị tiền tệ, không phải giá trị tính bằng phần triệu. Ví dụ: đối với giá trị lượt chuyển đổi là 5, 23 đô la Mỹ, hãy sử dụng giá trị 5.23.
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, đồng thời Data Manager API cũng 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.
Sử dụng request_id được trả về trong phản hồi để truy xuất thông tin chẩn đoán.
partial_failure_error
Không có phiên bản mới
API Trình quản lý dữ liệu không hỗ trợ lỗi một phần. Nếu bất kỳ trường nào của IngestEventsRequest không xác thực được, Data Manager API sẽ từ chối toàn bộ yêu cầu.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2026-02-17 UTC."],[],[]]