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, 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 in der Liste userIdentifiers für jede Kennung des Zielgruppenmitglieds einen separaten Eintrag hinzu. 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, 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.

    • 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 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"
  }
}