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üssen.

Zielgruppe entfernen

Wenn Sie alle Mitglieder aus einer Zielgruppe entfernen möchten, senden Sie einen RemoveAllAudienceMembersRequest-Aufruf und lassen Sie das Feld removeAsOfTime weg. Dadurch wird die Entfernung auf die aktuelle Uhrzeit festgelegt und alle aktuellen Mitglieder werden aus der Liste entfernt.

Alle Mitglieder ersetzen

So ersetzen Sie alle Mitglieder einer Zielgruppe zum Kundenabgleich, ohne eine leere Nutzerliste zu erstellen:

1. Die aktuelle Uhrzeit wird als T aufgezeichnet.
2. Beginnen Sie mit dem Hochladen der neuen Mitglieder, indem Sie eine IngestAudienceMembersRequest senden. Bei Bedarf können Sie mehrere Aufnahmeanfragen stellen.

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

4. Senden Sie ein RemoveAllAudienceMembersRequest mit removeAsOfTime, das auf den in Schritt 1 aufgezeichneten Zeitstempel T festgelegt ist. Dadurch werden nur die Mitglieder entfernt, die bevor Sie mit dem Hochladen der neuen Mitglieder begonnen haben, hinzugefügt wurden. Es bleiben also nur die neu hinzugefügten Mitglieder übrig.

Erstellen Sie die Anfrage

Legen Sie im RemoveAllAudienceMembersRequest-Text die folgenden Felder fest:

destinations

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

removeAsOfTime

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

validateOnly

Optional. Auf true gesetzt, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, setzen Sie den Wert auf false.

Beispielanforderungen

Hier ist ein Beispiel für eine Anfrage, 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 Seite „API Explorer“ auf Ausführen und folgen Sie der Anleitung zur Autorisierung, 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 ein 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.