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 effacer une liste d'utilisateurs avec une seule requête ou remplacer tous les membres d'une audience.

Effacer l'audience

Pour supprimer tous les membres d'une audience, envoyez une RemoveAllAudienceMembersRequest et omettez le champ removeAsOfTime. La valeur par défaut de l'heure de suppression est l'heure actuelle, ce qui efface 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 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 IngestAudienceMembersRequest. Si nécessaire, vous pouvez effectuer plusieurs requêtes d'ingestion.

3. Attendez que toutes les requêtes d'ingestion aient terminé le traitement. Vous pouvez vérifier l'état de vos requêtes à l'aide de Diagnostics.

   Remarque : Si une liste d'utilisateurs temporairement vide ne vous pose pas de problème, vous pouvez ignorer cette étape et passer à l'étape 4. Nous vous recommandons tout de même de vérifier l'état de vos requêtes d'ingestion pour vous assurer qu'elles ont été traitées correctement.

4. Envoyez un RemoveAllAudienceMembersRequest avec removeAsOfTime défini sur l'horodatage T enregistré à l'étape 1. Cela ne supprime que les membres qui ont été ajoutés avant que vous ne commenciez à importer les nouveaux membres, ne laissant que les membres nouvellement ajoutés.

Créer la requête

Définissez les champs suivants dans le RemoveAllAudienceMembersRequest corps :

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 pour plus d'informations.

removeAsOfTime

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

validateOnly

Facultatif. Définissez la valeur 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'API Explorer pour ouvrir l'API Explorer 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, telle que REPLACE_WITH_OPERATING_ACCOUNT_TYPE, par la valeur appropriée.
3. Cliquez sur Exécuter en bas de la page de l'API Explorer 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.

Annonceur

Ouvrir dans l'API Explorer

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

Partenaire pour les données

Ouvrir dans l'API Explorer

{
    "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, examinez les erreurs pour déterminer la cause de l'échec.