Feldzuordnungen

Verwenden Sie die Zuordnungen in den Tabellen, um 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.

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 Anforderungsfelder 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
advertiserId partnerId firstPartyAndPartnerAudienceId	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
advertiserId partnerId	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
advertiserId partnerId	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
advertiserId firstPartyAndPartnerAudienceId	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
advertiserId firstPartyAndPartnerAudienceId	destinations	Weitere Informationen finden Sie unter Ziele konfigurieren.
addedContactInfoList.contactInfos	audienceMembers	Kennungen für einzelne Nutzer können im Feld compositeData.userData von 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
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	Kennungen für einzelne Nutzer können im Feld compositeData.userData von 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	Fügen Sie in der Data Manager API Mitglieder mit den Methoden ingest und remove von audienceMembers hinzu und entfernen Sie sie.

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 die AccountType- 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 die Zielgruppe zu einem Werbetreibenden gehört, 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