Mithilfe der Zuordnungen in den Tabellen können Sie 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 zuordnen.
Authentifizierung
Für die Data Manager API sind Anmeldedaten mit einem anderen Umfang als für die Display & Video 360 API erforderlich. Folgen Sie der Anleitung unter API-Zugriff einrichten, um neue Anmeldedaten zu generieren, die den Data Manager API-Bereich enthalten.
Methodenzuordnung
In der folgenden Tabelle werden Display & Video 360 API-Methoden den entsprechenden Data Manager API-Methoden zugeordnet:
| Display & Video 360 API-Methoden | Data Manager API-Methoden | Hinweise |
|---|---|---|
firstPartyAndPartnerAudiences.get |
userLists.get |
Mit der 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 |
Nicht in der Display & Video 360 API 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. |
Zuordnung von Anfragen
In den folgenden Tabellen werden die Anfragefelder der Display & Video 360 API-Methoden ihren Entsprechungen in der Data Manager API zugeordnet.
userLists.get
firstPartyAndPartnerAudiences.get (Display & Video 360 API) |
userLists.get (Data Manager API) |
Hinweise |
|---|---|---|
|
name |
Der Name 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 gelassen wird, 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 Wert auf Encoding fest, der für UserIdentifier-Werte verwendet wird. |
| Kein Äquivalent | encryptionInfo |
Gibt an, ob die Anfrage verschlüsselte Werte enthält. Weitere Informationen finden Sie unter Verschlüsselung. |
| Kein Äquivalent | termsOfService |
Erforderlich. Wird festgelegt, um anzugeben, 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 Wert auf Encoding fest, der für UserIdentifier-Werte verwendet wird. |
| Kein Äquivalent | encryptionInfo |
Gibt an, ob 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 Format für den Ressourcennamen. 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 und remove von audienceMembers hinzufügen und entfernen.
|
mobileDeviceIdList |
audienceMembers-Methoden |
In der Data Manager API können Sie Mitglieder mit den Methoden ingest und remove von audienceMembers hinzufügen und entfernen.
|
Ressourcennamen
Die Data Manager API verwendet ein anderes Format für Ressourcennamen als die Display & Video 360 API.
- Display & Video 360 API
In der Display & Video 360 API wird für einen
UserList-Ressourcennamen ein Format verwendet, das nur die Zielgruppen-ID enthält:firstAndThirdPartyAudiences/{first_and_third_party_audience_id}- Data Manager API
In der Data Manager API verwendet ein
UserList-Ressourcenname ein Format, das die Zielgruppen-ID sowie dieAccountType- und Konto-ID des Partners oder Werbetreibenden enthält, dem die Zielgruppe gehört:accountTypes/{accountType}/accounts/{account}/userLists/{userList}
Nutzerkennungen
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 |
Auf die formatierte und gehashte E-Mail-Adresse festgelegt. Sie können die gehashte E‑Mail-Adresse auch verschlüsseln. Mehrere E-Mail-Adressen können verwendet werden, um einen einzelnen Nutzer abzugleichen. Dazu sind mehrere UserIdentifier-Objekte erforderlich. |
hashedPhoneNumbers |
userData.userIdentifiers.phoneNumber |
Auf die formatierte und gehashte Telefonnummer festgelegt. Sie können die gehashte Telefonnummer auch verschlüsseln. Mithilfe mehrerer UserIdentifier-Objekte können mehrere Telefonnummern verwendet werden, um einen einzelnen Nutzer abzugleichen. |
hashedFirstName |
userData.userIdentifiers.address.givenName |
Auf den formatierten und gehashten Vornamen festgelegt. Sie können auch den gehashten Vornamen verschlüsseln. |
hashedLastName |
userData.userIdentifiers.address.familyName |
Auf den formatierten und gehashten Familiennamen festgelegt. Sie können auch den gehashten Familiennamen verschlüsseln. |
countryCode |
userData.userIdentifiers.address.regionCode |
|
zipCodes |
userData.userIdentifiers.address.postalCode |
Mehrere Postleitzahlen können verwendet werden, um einen einzelnen Nutzer abzugleichen, indem mehrere UserIdentifier-Objekte verwendet 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 hat. | loginAccount |
Diese Einstellung ist nur in einem Display & Video 360-Partnerzugriffsszenario erforderlich, in dem sich die Zielgruppe unter einem Werbetreibenden befindet, der zugreifende Display & Video 360-Nutzer jedoch Zugriff auf den übergeordneten Partner des Werbetreibenden hat. Andernfalls kann sie nicht festgelegt werden. |
| Die ID des übergeordneten Werbetreibenden oder Partners der Zielgruppe. | operatingAccount |
|
firstPartyAndPartnerAudienceId |
productDestinationId |
|
| Kein Äquivalent | reference |