Mitglieder in eine Zielgruppe hochladen

Senden Sie eine IngestAudienceMembersRequest, um Mitglieder in eine Zielgruppe zum Kundenabgleich hochzuladen.

So konfigurieren und senden Sie die Anfrage:

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

2. Legen Sie für jedes AudienceMember in der audienceMembers Liste das Datenfeld basierend auf dem Typ der Daten fest, die im Upload enthalten sind:

   • Wenn der Upload Kontaktdaten enthält, legen Sie für das compositeData Feld ein CompositeData Objekt und für das userData Feld ein UserData Objekt fest. Fügen Sie in der Liste userIdentifiers für jede ID 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 bereit ist. Weitere Informationen finden Sie unter Zusammengesetzte Daten.

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

3. Folgen Sie der Anleitung unter Zielgruppenmitglieder senden, um Daten zum Kundenabgleich zu senden.

Beispielhafte Zielgruppenmitglieder

Die folgenden Beispiele zeigen, wie Sie ein AudienceMember-Objekt für jeden Typ von Mitglieds daten strukturieren. Für jedes AudienceMember in einer einzelnen Anfrage muss derselbe Typ von ID-Datensatz (compositeData, mobileData) verwendet werden:

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

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