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, IP-Adressdaten oder beides enthält, legen Sie für das Feld compositeData ein CompositeData-Objekt fest. Legen Sie für Kontaktdaten das Feld userData auf ein UserData-Objekt fest und fügen Sie für jede Kennung des Zielgruppenmitglieds einen separaten Eintrag in die Liste userIdentifiers ein. Fügen Sie für IP-Adressdaten für jede IP-Adresse des Zielgruppenmitglieds einen IpData-Eintrag in die Liste ipData ein.

     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.

   • Wenn der Upload Nutzer-IDs enthält, legen Sie für das Feld userIdData eine UserIdData-Nachricht fest und setzen Sie das Feld userId auf die Nutzer-ID für das Zielgruppenmitglied.

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

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

{
  "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"
      }
    ]
  }
}

{
  "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"
      }
    ]
  }
}

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

{
  "userIdData": {
    "userId": "user_987654321"
  }
}