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.

Uwierzytelnianie

Interfejs Data Manager API wymaga danych logowania o zakresie innym niż interfejs Display & Video 360 API. Aby wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API, wykonaj czynności opisane w sekcji Konfigurowanie dostępu do interfejsu 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 Nazwa UserList zawiera zarówno identyfikator reklamodawcy nadrzędnego lub partnera, jak i identyfikator odbiorców. Szczegółowe informacje 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 jest wymagane w interfejsie Data Manager API. Jeśli pozostawisz je puste, spowoduje to pełne zastąpienie wszystkich uwzględnionych pól.
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 Identyfikatory poszczególnych 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 Określa, czy żą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 Identyfikatory poszczególnych 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 Określa, czy żą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 Twoja integracja była 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 zahaszowany numer telefonu. Możesz też zaszyfrować zahaszowany numer telefonu. Aby dopasować pojedynczego użytkownika za pomocą wielu numerów telefonów, możesz użyć wielu obiektów UserIdentifier.
hashedFirstName userData.userIdentifiers.address.givenName Ustaw na sformatowane i zahaszowane 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
Wstecz
Przejście na nową wersję