Ánh xạ trường

Sử dụng thông tin 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 xác thực 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 xác thực mới, bao gồm cả phạm vi của Data Manager API.

Ánh xạ phương thức

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

Các phương thức của Display & Video 360 API Các phương thức của 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 riêng biệt của Data Manager API đượ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 riêng biệt của Data Manager API được dùng để thêm và xoá thành viên khỏi đối tượng So khớp khách hàng.
Không có thành phần tương đương. audienceMembers.removeAll API Trình quản lý dữ liệu hỗ trợ xoá tất cả thành viên của một đối tượng bằng một yêu cầu duy nhất.

Yêu cầu liên kết

Các bảng sau đây liên kết các trường yêu cầu của phương thức API Display & Video 360 với các trường tương đương trong API Trình quản lý dữ liệu.

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
FirstPartyAndPartnerAudience nội dung yêu cầu UserList nội dung yêu cầu 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 Trường này được đề xuất nhưng không bắt buộc trong Data Manager API và sẽ thay thế hoàn toàn tất cả các trường có trong đó nếu bạn để trống.
Không có phiên bản mới validateOnly
FirstPartyAndPartnerAudience nội dung yêu cầu UserList nội dung yêu cầu 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 đích đế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 đố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 trạng thái đồ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 đối tượng AudienceMember.
addedMobileDeviceIdList.consent consent Bạn cũng có thể đặt trạng thái đồ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ị đã 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 đố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 đố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ị đã mã hoá. Hãy xem phần Mã hoá để biết thông tin chi tiết.

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

Dưới đây là mối liên kết giữa các đối tượng trong Display & Video 360 API với 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ác phương thức ingest, remove và removeAll 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ác phương thức ingest, remove và removeAll của audienceMembers.

Tên tài nguyên

Data Manager API sử dụng định dạng tên tài nguyên khác với Display & Video 360 API.

Display & Video 360 API

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

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

Trong API Trình quản lý dữ liệu, tên tài nguyên UserList sử dụng định dạng chứa mã đối tượng cũng như AccountType và mã 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}

Giá trị nhận dạng 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 quá trình 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 phần 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 đã được đị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ể sử 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 riêng đã định dạng và băm. Bạn cũng có thể mã hoá tên đã băm.
hashedLastName userData.userIdentifiers.address.familyName Đặt thành họ đã được định dạng và băm. Bạn cũng có thể mã hoá họ đã băm.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode Bạn có thể dùng nhiều mã ZIP để 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 giá trị này trong trường hợp truy cập của đối tác Display & Video 360, trong đó đối tượng thuộc về 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 mẹ 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