Mitglieder in eine Zielgruppe hochladen

Sie können Mitglieder in eine Zielgruppe zum Kundenabgleich hochladen, 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 das 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 Datentyp des Uploads fest:

    • Wenn der Upload Kontaktdaten enthält, legen Sie für das Feld compositeData ein CompositeData-Objekt und für das Feld userData ein UserData-Objekt fest. 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, compositeData zu 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 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"
        }
      ]
    }
  }
}

Mobile IDs

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