Supprimer tous les membres d'une audience

Ce guide explique comment supprimer tous les membres d'une audience de ciblage par liste de clients en envoyant un RemoveAllAudienceMembersRequest.

Cette méthode est utile si vous devez vider une liste d'utilisateurs en une seule requête ou remplacer tous les membres d'une liste d'audience.

Effacer l'audience

Pour supprimer tous les membres d'une audience, envoyez un RemoveAllAudienceMembersRequest et omettez le champ removeAsOfTime. La date et l'heure de suppression sont alors définies sur la date et l'heure actuelles, et tous les membres actuels sont supprimés de la liste.

Remplacer tous les membres

Pour remplacer tous les membres d'une audience de ciblage par liste de clients tout en évitant d'avoir une liste d'utilisateurs vide, procédez comme suit :

1. Enregistrez l'heure actuelle sous la forme T.
2. Commencez à importer les nouveaux membres en envoyant un IngestAudienceMembersRequest. Si nécessaire, vous pouvez envoyer plusieurs demandes d'ingestion.

3. Attendez que toutes les demandes d'ingestion aient été traitées. Vous pouvez vérifier l'état de vos demandes à l'aide de la section Diagnostics.

4. Envoyez un RemoveAllAudienceMembersRequest avec removeAsOfTime défini sur le code temporel T enregistré à l'étape 1. Seuls les membres ajoutés avant que vous commenciez à importer les nouveaux membres sont supprimés. Seuls les membres nouvellement ajoutés sont conservés.

Créer la requête

Définissez les champs suivants dans le corps RemoveAllAudienceMembersRequest :

destinations

Obligatoire. Liste des destinations. Le champ productDestinationId de chaque destination spécifie l'audience dont vous souhaitez supprimer des membres. Pour en savoir plus, consultez Configurer des destinations.

removeAsOfTime

Facultatif. Seuls les membres ajoutés avant cette heure seront supprimés. Pour en savoir plus sur la mise en forme, consultez Format du code temporel. Si elle n'est pas définie, la valeur par défaut est l'heure actuelle.

validateOnly

Facultatif. Définissez-le sur true pour valider la requête sans appliquer les modifications. Lorsque vous êtes prêt à appliquer les modifications, définissez la valeur sur false.

Exemples de requêtes

Voici un exemple de requête qui supprime tous les membres d'une liste pour le ciblage des clients.

1. Cliquez sur Ouvrir dans l'explorateur d'API pour ouvrir l'explorateur d'API dans un nouvel onglet ou une nouvelle fenêtre.
2. Dans le corps de la requête de l'API Explorer, remplacez chaque chaîne commençant par REPLACE_WITH, comme REPLACE_WITH_OPERATING_ACCOUNT_TYPE, par la valeur correspondante.
3. Cliquez sur Exécuter en bas de la page de l'explorateur d'API et suivez les invites d'autorisation pour envoyer la requête.
4. Définissez validateOnly sur true pour valider la requête sans appliquer les modifications. Lorsque vous êtes prêt à appliquer les modifications, définissez validateOnly sur 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
}

Envoyer la requête

Envoyez la requête au point de terminaison removeAll.

Si la requête aboutit, la réponse contient un requestId que vous pouvez utiliser pour suivre l'état de l'opération.

{
  "requestId": "REQUEST_ID"
}

Si la requête échoue, inspectez les erreurs pour déterminer la cause de l'échec.