Alle Mitglieder aus einer Zielgruppe entfernen

In dieser Anleitung wird erklärt, wie Sie alle Mitglieder aus einer Zielgruppe zum Kundenabgleich entfernen. Dazu senden Sie eine RemoveAllAudienceMembersRequest.

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 removeAsOfTime Feld weg. Die Entfernung erfolgt dann standardmäßig zum aktuellen Zeitpunkt 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 Zeit als T.
2. Beginnen Sie mit dem Hochladen der neuen Mitglieder, indem Sie eine IngestAudienceMembersRequest senden. Bei Bedarf können Sie mehrere Anfragen zum Hochladen senden.

3. Warten Sie, bis alle Anfragen zum Hochladen verarbeitet wurden. Sie können den Status Ihrer Anfragen mit der Diagnosefunktionprüfen.

   Hinweis: Wenn eine vorübergehend leere Nutzerliste kein Problem darstellt, können Sie diesen Schritt überspringen und mit Schritt 4 fortfahren. Wir empfehlen jedoch, den Status Ihrer Anfragen zum Hochladen zu prüfen, um sicherzustellen, dass sie erfolgreich verarbeitet wurden.

4. Senden Sie eine RemoveAllAudienceMembersRequest mit removeAsOfTime auf den Zeitstempel T gesetzt, 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.

Anfrage erstellen

Legen Sie die folgenden Felder im RemoveAllAudienceMembersRequest Text 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 für mehr Informationen.

removeAsOfTime

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

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 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 jede String, die mit REPLACE_WITH beginnt, z. B. REPLACE_WITH_OPERATING_ACCOUNT_TYPE, durch den entsprechenden Wert.
3. Klicken Sie unten auf der Seite des API Explorer auf Ausführen und folgen Sie der Autorisierungsaufforderung, um die Anfrage zu senden.
4. Legen Sie validateOnly auf true fest, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, legen Sie validateOnly auf false fest.

Werbetreibender

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 removeAll Endpunkt.

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.