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 une requête RemoveAllAudienceMembersRequest.

Cette méthode est utile si vous devez effacer une liste d'utilisateurs avec 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 une requête RemoveAllAudienceMembersRequest et omettez le champ removeAsOfTime. La date de suppression est alors définie par défaut sur l'heure actuelle, ce qui supprime tous les membres actuels 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 une requête IngestAudienceMembersRequest. Vous pouvez effectuer plusieurs demandes d'ingestion si nécessaire.

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

4. Envoyez une requête RemoveAllAudienceMembersRequest avec removeAsOfTime défini sur le code temporel T enregistré à l'étape 1. Cette opération ne supprime que les membres ajoutés avant que vous ne commenciez à importer les nouveaux membres, ne laissant que les membres récemment ajouté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 date seront supprimés. Pour en savoir plus sur la mise en forme, consultez Format du code temporel. Si elle n'est pas définie, cette valeur est définie par défaut sur l'heure actuelle.

validateOnly

Facultatif. Définissez cette option 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 APIs Explorer pour ouvrir APIs Explorer dans un nouvel onglet ou une nouvelle fenêtre.
2. Dans le corps de la requête dans APIs Explorer, remplacez chaque chaîne commençant par REPLACE_WITH, telle que REPLACE_WITH_OPERATING_ACCOUNT_TYPE, par la valeur appropriée.
3. Cliquez sur Exécuter en bas de la page d'APIs Explorer, puis 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.