Sử dụng các 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.
Trường yêu cầu
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Ghi chú |
|---|---|---|
profileId Tham số đường dẫn URL |
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; Data Manager API không 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. Giờ đây, thông tin mã hoá Campaign Manager 360 được chỉ định trong mỗi mã nhận dạng người dùng được 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. Một 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. Hãy xem Hướng dẫn về đích đến để biết thông tin chi tiết. Ghép từng trường riêng lẻ như minh hoạ 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 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 nếu gửi mã nhận dạng người dùng: Đặt thành Encoding được dùng cho các giá trị UserIdentifier. Nếu không sử dụng giá trị nhận dạng người dùng, 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 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 (trước đây gọi là mã hoạt động Floodlight). |
kind |
Không có phiên bản mới | Trường siêu dữ liệu; Data Manager API không 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 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 đó, bạn có thể sử dụng transactionId để kiểm soát cách loại bỏ lượt chuyển đổi trùng lặp từ cùng một người dùng và ngày.
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, hằng số như 1. Trong Data Manager API, transactionId phải được đặt thành một giá trị nhận dạng duy nhất cho mỗi sự kiện.
|
| Không có phiên bản mới | transactionId |
Trong Data Manager API, transactionId được dùng để kiểm soát cách loại bỏ lượt chuyển đổi trùng lặp từ cùng một người dùng và ngày. Bạn phải đặt trường này thành một giá trị nhận dạng duy nhất cho mỗi sự kiện.
Trường này không bắt buộc khi gửi lượt chuyển đổi ngoại tuyến trên Floodlight. Xem phần Chuyển đổi dữ liệu thành các đố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 các chuỗi làm khoá thay vì các enum. Sử dụng các phím 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 được mã hoá. Hãy xem AdIdentifiers để biết thêm thông tin chi tiết. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Mỗi mã nhận dạng đề xuất ánh xạ đến 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; Data Manager API không 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 được 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 được 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 được 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, trong đó 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 đã đị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 được hỗ trợ trong phiên bản hiện tại của Data Manager API. |
addressInfo.state |
Không có phiên bản mới | Không được hỗ trợ trong phiên bản hiện tại của Data Manager API. |
addressInfo.hashedStreetAddress |
Không có phiên bản mới | Không được hỗ trợ trong phiên bản hiện tại của Data Manager API. |
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; Data Manager API không sử dụng. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Danh sách các đối tượng Item. Hãy xem Các trường của mặt hàng để biết thêm thông tin chi tiết. |
Các 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; Data Manager API không 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. |