Ánh xạ trường

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ú
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. Xem phần Trường lượt 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á Campaign Manager 360 hiện được chỉ định trong từng mã người dùng được mã hoá. Xem phần Trường lượt 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 các giá trị nhận dạng người dùng UserData được mã hoá. 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 đích và hoạt động Floodlight cho các sự kiện. Xem hướng dẫn về Điểm đến để biết thông tin chi tiết. Liên kết các trường riêng lẻ như trong phần Trường lượt 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 giá trị nhận dạng người dùng: Đặt thành Encoding 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 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. Đặt 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; 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 điểm đến. Đặt trường này nếu bạn đang gửi sự kiện đến nhiều điểm đến trong một yêu cầu.
adUserDataConsent consent.adUserData Xem phần Consent để biết thêm thông tin.
nonPersonalizedAd consent.adPersonalization Xem phần Consent để biết thêm thông tin.
Không có phiên bản mới destinationReferences Nếu gửi sự kiện đến nhiều điểm đến trong một yêu cầu, hãy đặt trường này thành reference tương ứng của điểm đến.
timestampMicros eventTimestamp
  • Nếu 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 Campaign Manager 360 API (API này dự kiến timestampMicros ở đơn vị micro giây kể từ kỷ nguyên Unix).
  • Nếu sử dụng bộ đệm giao thức, hãy sử dụng Timestamp và đặt các trường seconds và (không bắt buộc) nanoseconds.

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, không đổi, chẳng hạn như 1. Trong Data Manager API, bạn phải đặt transactionId thành một giá trị nhận dạng riêng biệt cho từng 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 riêng biệt cho từng sự kiện.

Trường này là không bắt buộc khi gửi lượt chuyển đổi ngoại tuyến Floodlight. Xem Chuyển đổi dữ liệu thành đối tượng Event để biết thêm thông tin.
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 Xem phần Consent để biết thêm thông tin.
childDirectedTreatment consent.adPersonalization Xem phần Consent để biết thêm thông tin.
treatmentForUnderage consent.adPersonalization Xem phần Consent để biết thêm thông tin.
gclid adIdentifiers.gclid Xem phần AdIdentifiers để biết thêm thông tin.
dclid adIdentifiers.dclid Xem phần AdIdentifiers để biết thêm thông tin.
matchId adIdentifiers.matchId Xem phần AdIdentifiers để biết thêm thông tin.
mobileDeviceId adIdentifiers.mobileId Xem phần AdIdentifiers để biết thêm thông tin.
impressionId adIdentifiers.impressionId Xem phần AdIdentifiers để biết thêm thông tin.
encryptedUserId adIdentifiers.encryptedUserIds Data Manager API hỗ trợ nhiều mã người dùng được mã hoá. Xem phần AdIdentifiers để biết thêm thông tin.
encryptedUserIdCandidates adIdentifiers.encryptedUserIds Mỗi mã ứng viên liên kết với một EncryptedUserId đối tượng 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ã 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ã 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ã người dùng được mã hoá.
sessionAttributesEncoded adIdentifiers.sessionAttributes Xem phần AdIdentifiers để biết thêm thông tin.
cartData cartData Xem phần Trường dữ liệu giỏ hàng để biết thông tin chi tiết.
userIdentifiers userData.userIdentifiers 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, các giá trị nhận dạng người dùng được nhóm trong một UserData đối tượng trong trường userData của Event. Điều này khác với Campaign Manager 360 API, trong đó các 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 theo 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 đị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; 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. Xem phần Trường mặt hàng để biết thêm thông tin.

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 cho 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.
Trước
Các bước nâng cấp