Sie können Mitglieder in eine Zielgruppe zum Kundenabgleich hochladen, indem Sie eine IngestAudienceMembersRequest senden.
So konfigurieren und senden Sie die Anfrage:
Legen Sie für das Feld
termsOfServiceeineTermsOfService-Nachricht fest, wobeicustomerMatchTermsOfServiceStatusaufACCEPTEDgesetzt ist, um zu bestätigen, dass dasoperatingAccountdie Nutzungsbedingungen für den Kundenabgleich akzeptiert hat.Legen Sie für jeden
AudienceMemberin der ListeaudienceMembersdas Datenfeld basierend auf dem Datentyp des Uploads fest:Wenn der Upload Kontaktdaten, IP-Adressdaten oder beides enthält, legen Sie für das Feld
compositeDataeinCompositeData-Objekt fest. Legen Sie für Kontaktdaten das FelduserDataauf einUserData-Objekt fest und fügen Sie in der ListeuserIdentifiersfür jede Kennung des Zielgruppenmitglieds einen separaten Eintrag hinzu. Fügen Sie für IP-Adressdaten für jede IP-Adresse des Zielgruppenmitglieds einenIpData-Eintrag in die ListeipDataein.userDatawird zwar weiterhin unterstützt, wir empfehlen jedoch,compositeDatazu verwenden, damit Ihre Integration für zukünftige Verbesserungen gerüstet ist. Weitere Informationen finden Sie unter Zusammengesetzte Daten.Wenn der Upload mobile IDs enthält, legen Sie für das Feld
mobileDataeineMobileData-Nachricht fest. Fügen Sie für jede mobile ID des Zielgruppenmitglieds einen separaten Eintrag in der ListemobileIdshinzu.Wenn der Upload Nutzer-IDs enthält, legen Sie für das Feld
userIdDataeineUserIdData-Nachricht fest und setzen Sie das FelduserIdauf die Nutzer-ID für das Zielgruppenmitglied.
Senden Sie Kundenabgleichsdaten, indem Sie die Schritte unter Zielgruppenmitglieder senden ausführen.
Beispiel für Zielgruppenmitglieder
Die folgenden Beispiele zeigen, wie ein AudienceMember-Objekt für jeden Typ von Mitgliedsdaten strukturiert wird. Für alle AudienceMember in einer einzelnen Anfrage muss der gleiche ID-Datentyp festgelegt sein (compositeData, mobileData oder userIdData):
Kontaktdaten
{
"compositeData": {
"userData": {
"userIdentifiers": [
{
"emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
},
{
"phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
}
]
}
}
}
IP-Adressdaten
{
"compositeData": {
"ipData": [
{
"ipAddress": "203.0.113.98",
"observeStartTime": "2026-06-10T20:17:52.0-04:00",
"observeEndTime": "2026-06-17T04:02:04.123-04:00"
}
]
}
}
Kontakt- und IP-Daten
{
"compositeData": {
"userData": {
"userIdentifiers": [
{
"emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
},
{
"phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
}
]
},
"ipData": [
{
"ipAddress": "203.0.113.98",
"observeStartTime": "2026-06-10T20:17:52.0-04:00",
"observeEndTime": "2026-06-17T04:02:04.123-04:00"
}
]
}
}
Mobile IDs
{
"mobileData": {
"mobileIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}
Nutzer-IDs
{
"userIdData": {
"userId": "user_987654321"
}
}