Mitglieder in eine Zielgruppe hochladen

Laden Sie Mitglieder in eine Zielgruppe zum Kundenabgleich hoch, indem Sie eine IngestAudienceMembersRequest senden.

So konfigurieren und senden Sie die Anfrage:

1. Legen Sie für das Feld termsOfService eine TermsOfService-Nachricht fest, wobei customerMatchTermsOfServiceStatus auf ACCEPTED gesetzt ist, um zu bestätigen, dass operatingAccount die Nutzungsbedingungen für den Kundenabgleich akzeptiert hat.

2. Legen Sie für jeden AudienceMember in der Liste audienceMembers das Datenfeld basierend auf dem Typ der im Upload enthaltenen Daten fest:

   • Wenn der Upload Kontaktdaten enthält, setzen Sie das Feld compositeData auf ein CompositeData-Objekt und das Feld userData auf ein UserData-Objekt. Fügen Sie in der Liste userIdentifiers für jede Kennung des Zielgruppenmitglieds einen separaten Eintrag hinzu.

     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.

   • Wenn der Upload mobile IDs enthält, legen Sie für das Feld mobileData eine MobileData-Nachricht fest. Fügen Sie für jede mobile ID des Zielgruppenmitglieds einen separaten Eintrag in der Liste mobileIds hinzu.

3. 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 jeden AudienceMember in einer einzelnen Anfrage muss der gleiche Typ von ID-Daten festgelegt sein (compositeData, mobileData):

Kontaktdaten

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

Digitale Ausweise

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}