Mapowanie pól

Skorzystaj z mapowań w tabelach, aby przypisać metody zarządzania odbiorcami kierowania na listę klientów i pola w interfejsie Display & Video 360 API do ich odpowiedników w interfejsie Data Manager API.

Mapowanie metod

W tej tabeli znajdziesz metody interfejsu Display & Video 360 API i ich odpowiedniki w interfejsie Data Manager API:

Metody interfejsu Display & Video 360 API	Metody interfejsu Data Manager API	Uwagi
firstPartyAndPartnerAudiences.get	userLists.get	Interfejs Data Manager API może pobierać tylko listy odbiorców kierowania na listę klientów.
firstPartyAndPartnerAudiences.list	userLists.list	Interfejs Data Manager API będzie zwracać tylko listy klientów.
firstPartyAndPartnerAudiences.create	userLists.create	Dane użytkowników muszą być przesyłane w kolejnym żądaniu w interfejsie Data Manager API.
Brak odpowiednika	userLists.delete	Niedostępne w interfejsie Display & Video 360 API.
firstPartyAndPartnerAudiences.patch	userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.ingest	Do dodawania i usuwania członków z grup odbiorców z kierowania na listę klientów używa się osobnych metod interfejsu Data Manager API.
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.remove	Do dodawania i usuwania członków z grup odbiorców z kierowania na listę klientów używa się osobnych metod interfejsu Data Manager API.

Mapowanie żądań

Poniższe tabele zawierają mapowanie pól żądań metod interfejsu Display & Video 360 API na ich odpowiedniki w interfejsie Data Manager API.

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API)	userLists.get (Data Manager API)	Uwagi
advertiserId partnerId firstPartyAndPartnerAudienceId	name	UserList Nazwa zawiera zarówno identyfikator reklamodawcy nadrzędnego lub partnera, jak i identyfikator odbiorców. Więcej informacji znajdziesz w sekcji Nazwy zasobów.

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API)	userLists.list (Data Manager API)	Uwagi
advertiserId partnerId	parent	parent zawiera identyfikator reklamodawcy nadrzędnego lub partnera.
pageSize	pageSize	Maksymalny rozmiar strony w interfejsie Data Manager API to 1000.
pageToken	pageToken
filter	filter
orderBy	Brak odpowiednika

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API)	userLists.create (Data Manager API)	Uwagi
advertiserId partnerId	parent	parent zawiera identyfikator reklamodawcy nadrzędnego lub partnera nowej listy odbiorców.
Brak odpowiednika	validateOnly
FirstPartyAndPartnerAudience treść żądania	UserList treść żądania	Mapowanie treści żądania znajdziesz w sekcji UserList.

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API)	userLists.patch (Data Manager API)	Uwagi
advertiserId firstPartyAndPartnerAudienceId	Parametr userList.name	Nazwa zasobu UserList, który ma zostać zaktualizowany.
updateMask	updateMask	To pole jest zalecane, ale nie wymagane w interfejsie Data Manager API. Jeśli pozostawisz je puste, wszystkie uwzględnione pola zostaną zastąpione.
Brak odpowiednika	validateOnly
FirstPartyAndPartnerAudience treść żądania	UserList treść żądania	Mapowanie treści żądania znajdziesz w sekcji UserList.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.ingest (Data Manager API)	Uwagi
advertiserId firstPartyAndPartnerAudienceId	destinations	Więcej informacji znajdziesz w artykule Konfigurowanie miejsc docelowych.
addedContactInfoList.contactInfos	audienceMembers	Poszczególne identyfikatory użytkowników można ustawić w polu compositeData.userData w obiektach AudienceMember. Więcej informacji znajdziesz w sekcji Identyfikatory użytkowników.
addedContactInfoList.consent	consent	Zgodę można też ustawić w poszczególnych obiektach AudienceMember.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	Poszczególne identyfikatory urządzeń mobilnych są ustawiane w polu mobileData w obiektach AudienceMember.
addedMobileDeviceIdList.consent	consent	Zgodę można też ustawić w poszczególnych obiektach AudienceMember.
Brak odpowiednika	validateOnly
Brak odpowiednika	encoding	Wymagane. Ustaw na Encoding używany w przypadku wartości UserIdentifier.
Brak odpowiednika	encryptionInfo	Ustaw, jeśli żądanie zawiera zaszyfrowane wartości. Więcej informacji znajdziesz w sekcji Szyfrowanie.
Brak odpowiednika	termsOfService	Wymagany. Ustaw, aby wskazać, że użytkownik zaakceptował lub odrzucił warunki korzystania z usługi kierowania na listę klientów.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.remove (Data Manager API)	Uwagi
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	Poszczególne identyfikatory użytkowników można ustawić w polu compositeData.userData w obiektach AudienceMember. Więcej informacji znajdziesz w sekcji Identyfikatory użytkowników.
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	Poszczególne identyfikatory urządzeń mobilnych są ustawiane w polu mobileData w obiektach AudienceMember.
Brak odpowiednika	validateOnly
Brak odpowiednika	encoding	Wymagany. Ustaw na Encoding używany w przypadku wartości UserIdentifier.
Brak odpowiednika	encryptionInfo	Ustaw, jeśli żądanie zawiera zaszyfrowane wartości. Więcej informacji znajdziesz w sekcji Szyfrowanie.

Mapowania pól obiektów

Poniżej znajdziesz mapowania obiektów interfejsu Display & Video 360 API na równoważne obiekty interfejsu Data Manager API.

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API)	UserList (Data Manager API)	Uwagi
name	name	Używa innego formatu nazwy zasobu. Szczegółowe informacje znajdziesz w sekcji Nazwy zasobów.
firstPartyAndPartnerAudienceId	id
Brak odpowiednika	readOnly
displayName	displayName
description	description
Brak odpowiednika	membershipStatus
Brak odpowiednika	integrationCode
membershipDurationDays	membershipDuration
Brak odpowiednika	closingReason
Brak odpowiednika	accessReason
Brak odpowiednika	accountAccessStatus
displayAudienceSize	sizeInfo.displayNetworkMembersCount
Brak odpowiednika	sizeInfo.searchNetworkMembersCount
Brak odpowiednika	targetNetworkInfo
Brak odpowiednika	ingestedUserListInfo
firstPartyAndPartnerAudienceType	Brak odpowiednika
audienceType	Brak odpowiednika
audienceSource	Brak odpowiednika
activeDisplayAudienceSize	Brak odpowiednika
youtubeAudienceSize	Brak odpowiednika
gmailAudienceSize	Brak odpowiednika
displayMobileAppAudienceSize	Brak odpowiednika
displayMobileWebAudienceSize	Brak odpowiednika
displayDesktopAudienceSize	Brak odpowiednika
appId	ingestedUserListInfo.mobileIdInfo.appId
contactInfoList	audienceMembers metody,	W interfejsie Data Manager API dodawaj i usuwaj członków za pomocą metod ingest i remove obiektu audienceMembers.
mobileDeviceIdList	audienceMembers metody,	W interfejsie Data Manager API dodawaj i usuwaj członków za pomocą metod ingest i remove obiektu audienceMembers.

Nazwy zasobów

Interfejs Data Manager API używa innego formatu nazwy zasobu niż interfejs Display & Video 360 API.

Display & Video 360 API

W interfejsie Display & Video 360 API nazwa zasobu UserList ma format, który zawiera tylko identyfikator odbiorców:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

W interfejsie Data Manager API nazwa zasobu UserList ma format, który zawiera identyfikator odbiorców, a także AccountType i identyfikator konta partnera lub reklamodawcy, który jest właścicielem odbiorców:

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

Identyfikatory użytkowników

Chociaż znacznik userData jest nadal obsługiwany, zalecamy używanie znacznika compositeData, aby mieć pewność, że Twoja integracja jest przygotowana na przyszłe ulepszenia. Więcej informacji znajdziesz w sekcji Dane złożone.

ContactInfo (Display & Video 360 API)	CompositeData (Data Manager API)	Uwagi
hashedEmails	userData.userIdentifiers.emailAddress	Ustaw na sformatowany i zahaszowany adres e-mail. Możesz też zaszyfrować zahaszowany adres e-mail. Aby dopasować pojedynczego użytkownika za pomocą kilku adresów e-mail, użyj wielu obiektów UserIdentifier.
hashedPhoneNumbers	userData.userIdentifiers.phoneNumber	Ustaw na sformatowany i zaszyfrowany numer telefonu. Możesz też zaszyfrować zaszyfrowany numer telefonu. Aby dopasować wiele numerów telefonu do jednego użytkownika, możesz użyć wielu obiektów UserIdentifier.
hashedFirstName	userData.userIdentifiers.address.givenName	Ustaw na sformatowane i zaszyfrowane imię. Możesz też zaszyfrować zahaszowane imię.
hashedLastName	userData.userIdentifiers.address.familyName	Ustaw na sformatowane i zahaszowane nazwisko. Możesz też zaszyfrować zahaszowaną nazwę rodziny.
countryCode	userData.userIdentifiers.address.regionCode
zipCodes	userData.userIdentifiers.address.postalCode	Aby dopasować jednego użytkownika do wielu kodów pocztowych, możesz użyć wielu obiektów UserIdentifier.

Miejsce docelowe

Display & Video 360 API	Destination (Data Manager API)	Uwagi
Identyfikator reklamodawcy lub partnera, do którego użytkownik Display & Video 360 ma dostęp.	loginAccount	To ustawienie jest wymagane tylko w scenariuszu dostępu partnera Display & Video 360, w którym lista odbiorców należy do reklamodawcy, ale użytkownik Display & Video 360 ma dostęp do partnera nadrzędnego reklamodawcy. W przeciwnym razie można pozostawić to pole bez ustawienia.
Identyfikator reklamodawcy nadrzędnego lub partnera, do którego należy lista odbiorców.	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
Brak odpowiednika	reference