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

     userData wird zwar weiterhin unterstützt, wir empfehlen jedoch, compositeData zu verwenden, damit Ihre Integration für zukünftige Verbesserungen vorbereitet 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 für jede Mobilgeräte-ID des Zielgruppenmitglieds einen separaten Eintrag in der Liste mobileIds hinzu.

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

3. Senden Sie Kundendaten zum Kundenabgleich anhand der Schritte unter Zielgruppenmitglieder senden.

Beispiel für Zielgruppenmitglieder

Die folgenden Beispiele zeigen, wie Sie ein AudienceMember-Objekt für die einzelnen Arten von Mitglieds daten strukturieren. Für jedes AudienceMember in einer einzelnen Anfrage muss derselbe Typ von ID-Datensatz 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"
  }
}