Ánh xạ trường

Sử dụng các mối liên kết trong bảng để liên kết các phương thức và trường quản lý đối tượng So khớp khách hàng trong Display & Video 360 API với các phương thức và trường tương đương trong Data Manager API.

Xác thực

Data Manager API yêu cầu thông tin đăng nhập có phạm vi khác với Display & Video 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 đăng nhập mới bao gồm phạm vi Data Manager API.

Ánh xạ phương thức

Bảng sau đây liên kết các phương thức Display & Video 360 API với các phương thức Data Manager API tương đương:

Các phương thức Display & Video 360 API Các phương thức Data Manager API Ghi chú
firstPartyAndPartnerAudiences.get userLists.get Data Manager API chỉ có thể truy xuất đối tượng So khớp khách hàng.
firstPartyAndPartnerAudiences.list userLists.list Data Manager API sẽ chỉ trả về đối tượng So khớp khách hàng.
firstPartyAndPartnerAudiences.create userLists.create Bạn phải tải dữ liệu người dùng lên trong một yêu cầu tiếp theo trong Data Manager API.
Không có phiên bản mới userLists.delete Không có trong Display & Video 360 API.
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest Các phương thức Data Manager API riêng biệt được dùng để thêm và xoá thành viên khỏi đối tượng So khớp khách hàng.
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove Các phương thức Data Manager API riêng biệt được dùng để thêm và xoá thành viên khỏi đối tượng So khớp khách hàng.

Ánh xạ yêu cầu

Các bảng sau đây liên kết các trường yêu cầu của phương thức Display & Video 360 API với các trường tương đương trong Data Manager API.

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API) userLists.get (Data Manager API) Ghi chú
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name Tên UserList chứa cả mã nhận dạng của nhà quảng cáo hoặc đối tác chính cũng như mã nhận dạng đối tượng. Hãy xem phần Tên tài nguyên để biết thông tin chi tiết.

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API) userLists.list (Data Manager API) Ghi chú
  • advertiserId
  • partnerId
 parent parent chứa mã nhận dạng của nhà quảng cáo hoặc đối tác chính.
pageSize pageSize Kích thước trang tối đa trong Data Manager API là 1000.
pageToken pageToken
filter filter
orderBy Không có phiên bản mới

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API) userLists.create (Data Manager API) Ghi chú
  • advertiserId
  • partnerId
 parent parent chứa mã nhận dạng của nhà quảng cáo chính hoặc đối tác của đối tượng mới.
Không có phiên bản mới validateOnly
Nội dung yêu cầu FirstPartyAndPartnerAudience Nội dung yêu cầu UserList Hãy xem UserList để biết thông tin liên kết nội dung yêu cầu.

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API) userLists.patch (Data Manager API) Ghi chú
  • advertiserId
  • firstPartyAndPartnerAudienceId
 Tham số userList.name Tên tài nguyên của UserList cần cập nhật.
updateMask updateMask Đây là trường được đề xuất nhưng không bắt buộc trong Data Manager API và sẽ dẫn đến việc thay thế hoàn toàn tất cả các trường được đưa vào nếu bạn để trống.
Không có phiên bản mới validateOnly
Nội dung yêu cầu FirstPartyAndPartnerAudience Nội dung yêu cầu UserList Hãy xem UserList để biết thông tin liên kết nội dung yêu cầu.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.ingest (Data Manager API) Ghi chú
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations Hãy xem bài viết Định cấu hình điểm đến để biết thông tin chi tiết.
addedContactInfoList.contactInfos audienceMembers Bạn có thể đặt giá trị nhận dạng người dùng riêng lẻ trong trường compositeData.userData trong các đối tượng AudienceMember. Hãy xem phần Giá trị nhận dạng người dùng để biết thông tin chi tiết.
addedContactInfoList.consent consent Bạn cũng có thể đặt sự đồng ý trong từng đối tượng AudienceMember.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers Mã thiết bị di động riêng lẻ được đặt trong trường mobileData trong các đối tượng AudienceMember.
addedMobileDeviceIdList.consent consent Bạn cũng có thể đặt sự đồng ý trong từng đối tượng AudienceMember.
Không có phiên bản mới validateOnly
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 encryptionInfo Đặ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.
Không có phiên bản mới termsOfService Bắt buộc. Đặt để cho biết rằng người dùng đã chấp nhận hoặc từ chối điều khoản dịch vụ cho tính năng So khớp khách hàng.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.remove (Data Manager API) Ghi chú
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers Bạn có thể đặt giá trị nhận dạng người dùng riêng lẻ trong trường compositeData.userData trong các đối tượng AudienceMember. Hãy xem phần Giá trị nhận dạng người dùng để biết thông tin chi tiết.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers Mã thiết bị di động riêng lẻ được đặt trong trường mobileData trong các đối tượng AudienceMember.
Không có phiên bản mới validateOnly
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 encryptionInfo Đặ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.

Mối liên kết trường đối tượng

Sau đây là các mối liên kết từ các đối tượng Display & Video 360 API đến các đối tượng tương đương trong Data Manager API.

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API) UserList (Data Manager API) Ghi chú
name name Sử dụng một định dạng tên tài nguyên khác. Hãy xem phần Tên tài nguyên để biết thông tin chi tiết.
firstPartyAndPartnerAudienceId id
Không có phiên bản mới readOnly
displayName displayName
description description
Không có phiên bản mới membershipStatus
Không có phiên bản mới integrationCode
membershipDurationDays membershipDuration
Không có phiên bản mới closingReason
Không có phiên bản mới accessReason
Không có phiên bản mới accountAccessStatus
displayAudienceSize sizeInfo.displayNetworkMembersCount
Không có phiên bản mới sizeInfo.searchNetworkMembersCount
Không có phiên bản mới targetNetworkInfo
Không có phiên bản mới ingestedUserListInfo
firstPartyAndPartnerAudienceType Không có phiên bản mới
audienceType Không có phiên bản mới
audienceSource Không có phiên bản mới
activeDisplayAudienceSize Không có phiên bản mới
youtubeAudienceSize Không có phiên bản mới
gmailAudienceSize Không có phiên bản mới
displayMobileAppAudienceSize Không có phiên bản mới
displayMobileWebAudienceSize Không có phiên bản mới
displayDesktopAudienceSize Không có phiên bản mới
appId ingestedUserListInfo.mobileIdInfo.appId
contactInfoList audienceMembers phương thức Trong Data Manager API, hãy thêm và xoá thành viên bằng cách sử dụng các phương thức ingest và remove của audienceMembers.
mobileDeviceIdList audienceMembers phương thức Trong Data Manager API, hãy thêm và xoá thành viên bằng cách sử dụng các phương thức ingest và remove của audienceMembers.

Tên tài nguyên

API Trình quản lý dữ liệu sử dụng một định dạng tên tài nguyên khác với API Display & Video 360.

Display & Video 360 API

Trong API Display & Video 360, tên tài nguyên UserList sử dụng một định dạng chỉ chứa mã nhận dạng đối tượng:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

Trong Data Manager API, tên tài nguyên UserList sử dụng một định dạng chứa mã nhận dạng đối tượng cũng như AccountType và mã nhận dạng tài khoản của đối tác hoặc nhà quảng cáo sở hữu đối tượng:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

Danh tính người dùng

Mặc dù userData vẫn được hỗ trợ, nhưng bạn nên sử dụng compositeData để đảm bảo chế độ tích hợp của bạn đã sẵn sàng cho những điểm cải tiến trong tương lai. Hãy xem Dữ liệu tổng hợp để biết thông tin chi tiết.

ContactInfo (Display & Video 360 API) CompositeData (Data Manager API) Ghi chú
hashedEmails userData.userIdentifiers.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. Bạn có thể dùng nhiều email để so khớp một người dùng bằng cách sử dụng nhiều đối tượng UserIdentifier.
hashedPhoneNumbers userData.userIdentifiers.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. Bạn có thể dùng nhiều số điện thoại để so khớp một người dùng bằng cách sử dụng nhiều đối tượng UserIdentifier.
hashedFirstName userData.userIdentifiers.address.givenName Đặt thành tên đã định dạng và băm. Bạn cũng có thể mã hoá tên được băm.
hashedLastName userData.userIdentifiers.address.familyName Đặt thành tên gia đình đã định dạng và băm. Bạn cũng có thể mã hoá tên gia đình đã băm.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode Bạn có thể dùng nhiều mã bưu chính để so khớp một người dùng bằng cách sử dụng nhiều đối tượng UserIdentifier.

Đích đến

Display & Video 360 API Destination (Data Manager API) Ghi chú
Mã nhận dạng của nhà quảng cáo hoặc đối tác mà người dùng Display & Video 360 được cấp quyền truy cập. loginAccount Bạn chỉ cần đặt thông số này trong trường hợp truy cập của đối tác Display & Video 360, trong đó đối tượng nằm trong một nhà quảng cáo nhưng người dùng Display & Video 360 truy cập đã được cấp quyền truy cập vào đối tác mẹ của nhà quảng cáo. Nếu không, bạn có thể không đặt giá trị này.
Mã nhận dạng của nhà quảng cáo chính hoặc đối tác của đối tượng. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
Không có phiên bản mới reference
Trước
Các bước nâng cấp