Alle Mitglieder aus einer Zielgruppe entfernen

In diesem Leitfaden wird beschrieben, wie Sie alle Mitglieder aus einer Zielgruppe zum Kundenabgleich entfernen, indem Sie eine RemoveAllAudienceMembersRequest senden.

Diese Methode ist nützlich, wenn Sie eine Nutzerliste mit einer einzigen Anfrage löschen oder alle Zielgruppenmitglieder einer Liste ersetzen möchten.

Zielgruppe löschen

Wenn Sie alle Mitglieder aus einer Zielgruppe entfernen möchten, senden Sie eine RemoveAllAudienceMembersRequest und lassen Sie das Feld removeAsOfTime weg. Dadurch wird die Entfernungszeit standardmäßig auf die aktuelle Zeit festgelegt und alle aktuellen Mitglieder werden aus der Liste entfernt.

Alle Mitglieder ersetzen

So ersetzen Sie alle Mitglieder in einer Zielgruppe zum Kundenabgleich, ohne dass eine leere Nutzerliste entsteht:

1. Notieren Sie die aktuelle Uhrzeit als T.
2. Beginnen Sie mit dem Hochladen der neuen Mitglieder, indem Sie eine IngestAudienceMembersRequest senden. Sie können bei Bedarf mehrere Aufnahmeanträge stellen.

3. Warten Sie, bis alle Aufnahme-Anfragen verarbeitet wurden. Sie können den Status Ihrer Anfragen unter Diagnose prüfen.

4. Senden Sie einen RemoveAllAudienceMembersRequest, wobei removeAsOfTime auf den Zeitstempel T festgelegt ist, der in Schritt 1 aufgezeichnet wurde. Dadurch werden nur die Mitglieder entfernt, die vor dem Hochladen der neuen Mitglieder hinzugefügt wurden. Es bleiben also nur die neu hinzugefügten Mitglieder übrig.

Erstellen Sie die Anfrage

Legen Sie im Text von RemoveAllAudienceMembersRequest die folgenden Felder fest:

destinations

Erforderlich. Die Liste der Ziele. Das Feld productDestinationId in jedem Ziel gibt die Zielgruppe an, aus der Sie Mitglieder entfernen möchten. Weitere Informationen finden Sie unter Ziele konfigurieren.

removeAsOfTime

Optional. Es werden nur Mitglieder entfernt, die vor diesem Zeitpunkt hinzugefügt wurden. Weitere Informationen zur Formatierung finden Sie unter Zeitstempelformat. Wenn nicht festgelegt, wird dieser Wert standardmäßig auf die aktuelle Zeit gesetzt.

validateOnly

Optional. Legen Sie true fest, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, legen Sie false fest.

Beispielanforderungen

Hier ist eine Beispielanfrage, mit der alle Mitglieder aus einer Liste zum Kundenabgleich entfernt werden.

1. Klicken Sie auf Im API Explorer öffnen, um den API Explorer in einem neuen Tab oder Fenster zu öffnen.
2. Ersetzen Sie im Anfragetext im API Explorer jeden String, der mit REPLACE_WITH beginnt, z. B. REPLACE_WITH_OPERATING_ACCOUNT_TYPE, durch den entsprechenden Wert.
3. Klicken Sie unten auf der API Explorer-Seite auf Ausführen und folgen Sie den Autorisierungsaufforderungen, um die Anfrage zu senden.
4. Setzen Sie validateOnly auf true, um die Anfrage zu validieren, ohne die Änderungen zu übernehmen. Wenn Sie die Änderungen anwenden möchten, setzen Sie validateOnly auf false.

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "LOGIN_ACCOUNT_TYPE",
                "accountId": "LOGIN_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "DATA_PARTNER",
                "accountId": "DATA_PARTNER_ACCOUNT_ID"
            },
            "linkedAccount": {
                "accountType": "LINKED_ACCOUNT_TYPE",
                "accountId": "LINKED_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

Anfrage senden

Senden Sie die Anfrage an den Endpunkt removeAll.

Wenn die Anfrage erfolgreich ist, enthält die Antwort einen requestId, mit dem Sie den Status des Vorgangs verfolgen können.

{
  "requestId": "REQUEST_ID"
}

Wenn die Anfrage fehlschlägt, prüfen Sie die Fehler, um die Ursache des Fehlers zu ermitteln.