Verwenden Sie die Zuordnungen in den Tabellen, um die Methoden und Felder für die Verwaltung von Zielgruppen zum Kundenabgleich in der Display & Video 360 API den entsprechenden Methoden und Feldern in der Data Manager API zuzuordnen.
Authentifizierung
Für die Data Manager API sind Anmeldedaten mit einem anderen Bereich als für die Display & Video 360 API erforderlich. Folgen Sie der Anleitung unter API-Zugriff einrichten, um neue Anmeldedaten zu generieren, die den Bereich der Data Manager API enthalten.
Methodenzuordnung
In der folgenden Tabelle werden die Methoden der Display & Video 360 API den entsprechenden Methoden der Data Manager API zugeordnet:
| Display & Video 360 API-Methoden | Data Manager API-Methoden | Hinweise |
|---|---|---|
firstPartyAndPartnerAudiences.get |
userLists.get |
Über die Data Manager API können nur Zielgruppen zum Kundenabgleich abgerufen werden. |
firstPartyAndPartnerAudiences.list |
userLists.list |
Die Data Manager API gibt nur Zielgruppen zum Kundenabgleich zurück. |
firstPartyAndPartnerAudiences.create |
userLists.create |
Nutzerdaten müssen in einer nachfolgenden Anfrage in der Data Manager API hochgeladen werden. |
| Kein Äquivalent | userLists.delete |
In der Display & Video 360 API nicht verfügbar. |
firstPartyAndPartnerAudiences.patch |
userLists.patch |
|
firstPartyAndPartnerAudiences.editCustomerMatchMembers |
audienceMembers.ingest |
Zum Hinzufügen und Entfernen von Mitgliedern aus Zielgruppen zum Kundenabgleich werden separate Data Manager API-Methoden verwendet. |
firstPartyAndPartnerAudiences.editCustomerMatchMembers |
audienceMembers.remove |
Zum Hinzufügen und Entfernen von Mitgliedern aus Zielgruppen zum Kundenabgleich werden separate Data Manager API-Methoden verwendet. |
| Kein Äquivalent. | audienceMembers.removeAll |
Die Data Manager API unterstützt das Entfernen aller Mitglieder einer Zielgruppe mit einer einzigen Anfrage. |
Anfragezuordnung
In den folgenden Tabellen werden Anfragefelder von Display & Video 360 API-Methoden den entsprechenden Feldern in der Data Manager API zugeordnet.
userLists.get
firstPartyAndPartnerAudiences.get (Display & Video 360 API) |
userLists.get (Data Manager API) |
Hinweise |
|---|---|---|
|
name |
Der Name der UserList enthält sowohl die ID des übergeordneten Werbetreibenden oder Partners als auch die Zielgruppen-ID. Weitere Informationen finden Sie unter Ressourcennamen. |
userLists.list
firstPartyAndPartnerAudiences.list (Display & Video 360 API) |
userLists.list (Data Manager API) |
Hinweise |
|---|---|---|
|
parent |
parent enthält die ID des übergeordneten Werbetreibenden oder Partners. |
pageSize |
pageSize |
Die maximale Seitengröße in der Data Manager API beträgt 1000. |
pageToken |
pageToken |
|
filter |
filter |
|
orderBy |
Kein Äquivalent |
userLists.create
firstPartyAndPartnerAudiences.create (Display & Video 360 API) |
userLists.create (Data Manager API) |
Hinweise |
|---|---|---|
|
parent |
parent enthält die ID des übergeordneten Werbetreibenden oder Partners der neuen Zielgruppe. |
| Kein Äquivalent | validateOnly |
|
FirstPartyAndPartnerAudience-Anfragetext |
UserList-Anfragetext |
Informationen zur Zuordnung des Anfragetexts finden Sie unter UserList. |
userLists.update
firstPartyAndPartnerAudiences.patch (Display & Video 360 API) |
userLists.patch (Data Manager API) |
Hinweise |
|---|---|---|
|
userList.name-Parameter |
Der Ressourcenname des zu aktualisierenden UserList. |
updateMask |
updateMask |
Dieses Feld wird in der Data Manager API empfohlen, ist aber nicht erforderlich. Wenn es leer bleibt, werden alle enthaltenen Felder vollständig ersetzt. |
| Kein Äquivalent | validateOnly |
|
FirstPartyAndPartnerAudience-Anfragetext |
UserList-Anfragetext |
Informationen zur Zuordnung des Anfragetexts finden Sie unter UserList. |
audienceMembers.ingest
firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) |
audienceMembers.ingest (Data Manager API) |
Hinweise |
|---|---|---|
|
destinations |
Weitere Informationen finden Sie unter Ziele konfigurieren. |
addedContactInfoList.contactInfos |
audienceMembers |
Einzelne Nutzer-IDs können im Feld compositeData.userData in AudienceMember-Objekten festgelegt werden. Weitere Informationen finden Sie unter Nutzer-IDs. |
addedContactInfoList.consent |
consent |
Die Einwilligung kann auch in einzelnen AudienceMember-Objekten festgelegt werden. |
addedMobileDeviceIdList.mobileDeviceIds |
audienceMembers |
Einzelne Mobilgeräte-IDs werden im Feld mobileData in AudienceMember-Objekten festgelegt. |
addedMobileDeviceIdList.consent |
consent |
Die Einwilligung kann auch in einzelnen AudienceMember-Objekten festgelegt werden. |
| Kein Äquivalent | validateOnly |
|
| Kein Äquivalent | encoding |
Erforderlich. Legen Sie den Encoding fest, der für UserIdentifier-Werte verwendet wird. |
| Kein Äquivalent | encryptionInfo |
Wird festgelegt, wenn die Anfrage verschlüsselte Werte enthält. Weitere Informationen finden Sie unter Verschlüsselung. |
| Kein Äquivalent | termsOfService |
Erforderlich. Gibt an, ob der Nutzer die Nutzungsbedingungen für den Kundenabgleich akzeptiert oder abgelehnt hat. |
audienceMembers.remove
firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) |
audienceMembers.remove (Data Manager API) |
Hinweise |
|---|---|---|
|
destinations |
|
removedContactInfoList.contactInfos |
audienceMembers |
Einzelne Nutzer-IDs können im Feld compositeData.userData in AudienceMember-Objekten festgelegt werden. Weitere Informationen finden Sie unter Nutzer-IDs. |
removedMobileDeviceIdList.mobileDeviceIds |
audienceMembers |
Einzelne Mobilgeräte-IDs werden im Feld mobileData in AudienceMember-Objekten festgelegt. |
| Kein Äquivalent | validateOnly |
|
| Kein Äquivalent | encoding |
Erforderlich. Legen Sie den Encoding fest, der für UserIdentifier-Werte verwendet wird. |
| Kein Äquivalent | encryptionInfo |
Wird festgelegt, wenn die Anfrage verschlüsselte Werte enthält. Weitere Informationen finden Sie unter Verschlüsselung. |
Objektfeldzuordnungen
Hier finden Sie die Zuordnungen von Display & Video 360 API-Objekten zu den entsprechenden Objekten in der Data Manager API.
UserList
FirstPartyAndPartnerAudience (Display & Video 360 API) |
UserList (Data Manager API) |
Hinweise |
|---|---|---|
name |
name |
Verwendet ein anderes Ressourcennamenformat. Weitere Informationen finden Sie unter Ressourcennamen. |
firstPartyAndPartnerAudienceId |
id |
|
| Kein Äquivalent | readOnly |
|
displayName |
displayName |
|
description |
description |
|
| Kein Äquivalent | membershipStatus |
|
| Kein Äquivalent | integrationCode |
|
membershipDurationDays |
membershipDuration |
|
| Kein Äquivalent | closingReason |
|
| Kein Äquivalent | accessReason |
|
| Kein Äquivalent | accountAccessStatus |
|
displayAudienceSize |
sizeInfo.displayNetworkMembersCount |
|
| Kein Äquivalent | sizeInfo.searchNetworkMembersCount |
|
| Kein Äquivalent | targetNetworkInfo |
|
| Kein Äquivalent | ingestedUserListInfo |
|
firstPartyAndPartnerAudienceType |
Kein Äquivalent | |
audienceType |
Kein Äquivalent | |
audienceSource |
Kein Äquivalent | |
activeDisplayAudienceSize |
Kein Äquivalent | |
youtubeAudienceSize |
Kein Äquivalent | |
gmailAudienceSize |
Kein Äquivalent | |
displayMobileAppAudienceSize |
Kein Äquivalent | |
displayMobileWebAudienceSize |
Kein Äquivalent | |
displayDesktopAudienceSize |
Kein Äquivalent | |
appId |
ingestedUserListInfo.mobileIdInfo.appId |
|
contactInfoList |
audienceMembers-Methoden |
In der Data Manager API können Sie Mitglieder mit den Methoden ingest, remove und removeAll von audienceMembers hinzufügen und entfernen.
|
mobileDeviceIdList |
audienceMembers-Methoden |
In der Data Manager API können Sie Mitglieder mit den Methoden ingest, remove und removeAll von audienceMembers hinzufügen und entfernen.
|
Ressourcennamen
Die Data Manager API verwendet ein anderes Ressourcennamenformat als die Display & Video 360 API.
- Display & Video 360 API
In der Display & Video 360 API wird für den Ressourcennamen
UserListein Format verwendet, das nur die Zielgruppen-ID enthält:firstAndThirdPartyAudiences/{first_and_third_party_audience_id}- Data Manager API
In der Data Manager API hat der Ressourcenname einer
UserListein Format, das die Zielgruppen-ID sowie dieAccountTypeund die Konto-ID des Partners oder Werbetreibenden enthält, dem die Zielgruppe gehört:accountTypes/{accountType}/accounts/{account}/userLists/{userList}
Nutzer-IDs
userData wird zwar weiterhin unterstützt, wir empfehlen jedoch die Verwendung von compositeData, damit Ihre Integration für zukünftige Verbesserungen gerüstet ist. Weitere Informationen finden Sie unter Zusammengesetzte Daten.
ContactInfo (Display & Video 360 API) |
CompositeData (Data Manager API) |
Hinweise |
|---|---|---|
hashedEmails |
userData.userIdentifiers.emailAddress |
Legen Sie die formatierte und gehashte E-Mail-Adresse fest. Sie können die gehashte E-Mail-Adresse auch verschlüsseln. Wenn Sie mehrere UserIdentifier-Objekte verwenden, können Sie mehrere E-Mail-Adressen mit einem einzelnen Nutzer abgleichen. |
hashedPhoneNumbers |
userData.userIdentifiers.phoneNumber |
Legen Sie die formatierte und gehashte Telefonnummer fest. Sie können die gehashte Telefonnummer auch verschlüsseln. Wenn Sie mehrere UserIdentifier-Objekte verwenden, können Sie mehrere Telefonnummern einem einzelnen Nutzer zuordnen. |
hashedFirstName |
userData.userIdentifiers.address.givenName |
Legen Sie den formatierten und gehashten Vornamen fest. Sie können den gehashten Vornamen auch verschlüsseln. |
hashedLastName |
userData.userIdentifiers.address.familyName |
Legen Sie den formatierten und gehashten Nachnamen fest. Sie können den gehashten Nachnamen auch verschlüsseln. |
countryCode |
userData.userIdentifiers.address.regionCode |
|
zipCodes |
userData.userIdentifiers.address.postalCode |
Mehrere Postleitzahlen können mithilfe mehrerer UserIdentifier-Objekte einem einzelnen Nutzer zugeordnet werden. |
Ziel
| Display & Video 360 API | Destination (Data Manager API) |
Hinweise |
|---|---|---|
| Die ID des Werbetreibenden oder Partners, auf den der Display & Video 360-Nutzer Zugriff erhalten hat. | loginAccount |
Dies muss nur in einem Display & Video 360-Partnerzugriffsszenario festgelegt werden, in dem die Zielgruppe einem Werbetreibenden zugeordnet ist, der zugreifende Display & Video 360-Nutzer aber Zugriff auf den übergeordneten Partner des Werbetreibenden hat. Andernfalls kann es leer bleiben. |
| Die ID des übergeordneten Werbetreibenden oder Partners der Zielgruppe. | operatingAccount |
|
firstPartyAndPartnerAudienceId |
productDestinationId |
|
| Kein Äquivalent | reference |