Alle Mitglieder aus einer Zielgruppe entfernen

In dieser Anleitung wird beschrieben, wie Sie alle Mitglieder aus einer Zielgruppe zum Kundenabgleich entfernen, indem Sie ein 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 löschen

Wenn Sie alle Mitglieder aus einer Zielgruppe entfernen möchten, senden Sie einen RemoveAllAudienceMembersRequest 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 in einer Zielgruppe zum Kundenabgleich, ohne eine leere Nutzerliste zu erhalten:

1. Die aktuelle Zeit wird als T aufgezeichnet.
2. Beginnen Sie mit dem Hochladen der neuen Mitglieder, indem Sie eine IngestAudienceMembersRequest senden. Bei Bedarf können Sie mehrere Anfragen zum Aufnehmen von Inhalten stellen.

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

   Hinweis :Wenn eine vorübergehend leere Nutzerliste kein Problem darstellt, können Sie diesen Schritt überspringen und mit Schritt 4 fortfahren. Wir empfehlen weiterhin, den Status Ihrer Aufnahmeanträge zu prüfen, um sicherzugehen, dass sie erfolgreich bearbeitet wurden.

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. Es werden nur Mitglieder entfernt, die vor diesem Zeitpunkt hinzugefügt wurden. 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 zu übernehmen. Wenn Sie die Änderungen anwenden möchten, setzen Sie den Wert auf false.

Beispielanforderungen

Hier sehen Sie 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 Seite „APIs Explorer“ auf Ausführen und folgen Sie der Aufforderung 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.

Advertiser

Im API Explorer öffnen

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

Datenpartner

Im API Explorer öffnen

{
    "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 eine requestId, mit der 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.