Sử dụng mối liên kết trong bảng để liên kết một
conversions.batchinsert trong Campaign Manager 360 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 Campaign Manager 360 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
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Ghi chú |
|---|---|---|
Tham số đường dẫn URL profileId |
Không có phiên bản mới | |
kind |
Không có phiên bản mới | Trường siêu dữ liệu; không được Data Manager API sử dụng. |
conversions |
events |
Bắt buộc. 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. |
encryptionInfo |
Đã chuyển vào events.adIdentifiers.encryptedUserIds |
Được xác định ở cấp sự kiện. Thông tin mã hoá của Campaign Manager 360 hiện được chỉ định trong mỗi mã nhận dạng người dùng đã mã hoá. Xem mục Trường chuyển đổi. |
| Không có phiên bản mới | encryptionInfo |
encryptionInfo ở cấp yêu cầu là thông tin mã hoá cho giá trị nhận dạng người dùng UserData đã mã hoá. Hãy xem phần Mã hoá để biết thông tin chi tiết. |
| Không có phiên bản mới | destinations |
Bắt buộc. Danh sách các đối tượng Destination xác định tài khoản mục tiêu và hoạt động Floodlight cho các sự kiện. Xem Hướng dẫn về đích đến để biết thông tin chi tiết. Liên kết từng trường như trong mục Trườ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 nếu gửi giá trị nhận dạng người dùng: Đặt thành Encoding dùng cho các giá trị UserIdentifier. Nếu bạn không sử dụng giá trị nhận dạng người dùng, thì trường này sẽ bị bỏ qua. |
| Không có phiên bản mới | validateOnly |
Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi. |
Trường lượt chuyển đổi
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
Ghi chú |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Được xác định ở cấp yêu cầu. Đặt thành mã cấu hình Floodlight. |
| Không có phiên bản mới | destinations[].operatingAccount.accountType |
Được xác định ở cấp yêu cầu. Thiết lập thành FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Được xác định ở cấp yêu cầu. Đặt thành mã hoạt động Floodlight. |
kind |
Không có phiên bản mới | Trường siêu dữ liệu; không được Data Manager API sử dụng. |
| Không có phiên bản mới | destinations[].reference |
Được xác định ở cấp yêu cầu. Giá trị nhận dạng do người dùng xác định cho đích đến. Đặt trường này nếu bạn đang gửi sự kiện đến nhiều đích đến trong một yêu cầu. |
adUserDataConsent |
consent.adUserData |
Hãy xem Consent để biết thêm thông tin chi tiết. |
nonPersonalizedAd |
consent.adPersonalization |
Hãy xem Consent để biết thêm thông tin chi tiết. |
| Không có phiên bản mới | destinationReferences |
Nếu bạn gửi sự kiện đến nhiều đích đến trong một yêu cầu, hãy đặt trường này thành reference tương ứng của đích đến. |
timestampMicros |
eventTimestamp |
Hãy xem phần Định dạng dấu thời gian để biết thông tin chi tiết. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Không có phiên bản mới |
Trường ordinal trong Campaign Manager 360 API không có trong Data Manager API.
Thay vào đó, Data Manager API sử dụng transactionId để loại bỏ các sự kiện trùng lặp được gửi đến cùng một mã hoạt động Floodlight.
Trong Campaign Manager 360 API, bạn có thể đảm bảo các sự kiện sẽ được loại bỏ trùng lặp bằng cách đặt ordinal thành một giá trị cố định, không đổi, chẳng hạn như 1. Trong Data Manager API,
transactionId phải được đặt thành một giá trị nhận dạng riêng biệt cho mỗi sự kiện.
|
| Không có phiên bản mới | transactionId |
Data Manager API sử dụng kết hợp mã hoạt động Floodlight và
transactionId để loại bỏ sự kiện trùng lặp. Trường transactionId phải được đặt thành một giá trị nhận dạng riêng biệt cho mỗi sự kiện.
Bắt buộc nếu gửi sự kiện cho lượt chuyển đổi nhiều nguồn. Hãy xem phần Chuyển đổi dữ liệu thành đối tượng Event để biết thêm thông tin chi tiết.
|
customVariables |
customVariables |
Danh sách các đối tượng CustomVariable. Data Manager API sử dụng chuỗi làm khoá thay vì enum. Sử dụng các khoá như U1, U2 cho trường variable. |
limitAdTracking |
consent.adPersonalization |
Hãy xem Consent để biết thêm thông tin chi tiết. |
childDirectedTreatment |
consent.adPersonalization |
Hãy xem Consent để biết thêm thông tin chi tiết. |
treatmentForUnderage |
consent.adPersonalization |
Hãy xem Consent để biết thêm thông tin chi tiết. |
gclid |
adIdentifiers.gclid |
Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
dclid |
adIdentifiers.dclid |
Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
matchId |
adIdentifiers.matchId |
Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
mobileDeviceId |
adIdentifiers.mobileId |
Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
impressionId |
adIdentifiers.impressionId |
Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
Data Manager API hỗ trợ nhiều mã nhận dạng người dùng đã mã hoá. Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Mỗi mã ứng viên liên kết với một đối tượng EncryptedUserId trong danh sách. |
encryptionInfo.kind |
Không có phiên bản mới | Trường siêu dữ liệu; không được Data Manager API sử dụng. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Thay vì chỉ định thông tin mã hoá một lần cho mỗi yêu cầu, thông tin này được chỉ định cho mỗi mã nhận dạng người dùng đã mã hoá. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Thay vì chỉ định thông tin mã hoá một lần cho mỗi yêu cầu, thông tin này được chỉ định cho mỗi mã nhận dạng người dùng đã mã hoá. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Thay vì chỉ định thông tin mã hoá một lần cho mỗi yêu cầu, thông tin này được chỉ định cho mỗi mã nhận dạng người dùng đã mã hoá. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
cartData |
cartData |
Hãy xem Trường dữ liệu giỏ hàng để biết thông tin chi tiết. |
userIdentifiers |
userData.userIdentifiers |
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. |
Trường giá trị nhận dạng người dùng
Trong Data Manager API, giá trị nhận dạng người dùng được nhóm trong một đối tượng UserData trong trường userData của Event. Điều này khác với Campaign Manager 360 API, nơi giá trị nhận dạng được đính kèm trực tiếp vào đối tượng Conversion.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
Ghi chú |
|---|---|---|
hashedEmail |
emailAddress |
Đặ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. |
hashedPhoneNumber |
phoneNumber |
Đặ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. |
addressInfo |
address |
Đặt thành đối tượng AddressInfo. 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ỉ. |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
Không có phiên bản mới | Không hỗ trợ cho đích đến Campaign Manager 360. |
addressInfo.state |
Không có phiên bản mới | Không hỗ trợ cho đích đến Campaign Manager 360. |
addressInfo.hashedStreetAddress |
Không có phiên bản mới | Không được hỗ trợ cho đích đến Campaign Manager 360. |
Trường dữ liệu giỏ hàng
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
Ghi chú |
|---|---|---|
kind |
Không có phiên bản mới | Trường siêu dữ liệu; không được Data Manager API sử dụng. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Danh sách các đối tượng Item. Hãy xem Trường mục để biết thêm thông tin chi tiết. |
Trường mặt hàng cho dữ liệu giỏ hàng
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
Ghi chú |
|---|---|---|
kind |
Không có phiên bản mới | Trường siêu dữ liệu; không được Data Manager API sử dụng. |
| Không có phiên bản mới | itemId |
Không bắt buộc. Giá trị nhận dạng riêng biệt của mặt hàng. |
itemId |
merchantProductId |
Bắt buộc. Đặt thành mã sản phẩm trong Merchant Center cho mặt hàng. |
quantity |
quantity |
Bắt buộc. |
unitPrice |
unitPrice |
Bắt buộc. |