Rimuovere tutti i membri da un segmento di pubblico

Questa guida spiega come rimuovere tutti i membri da un segmento di pubblico Customer Match inviando un RemoveAllAudienceMembersRequest.

Questo metodo è utile se devi cancellare un elenco di utenti con una singola richiesta o sostituire tutti i membri del segmento di pubblico di un elenco.

Cancella il segmento di pubblico

Per rimuovere tutti i membri da un segmento di pubblico, invia una richiesta RemoveAllAudienceMembersRequest e ometti il campo removeAsOfTime. In questo modo, l'ora di rimozione viene impostata sull'ora corrente e tutti i membri attuali vengono rimossi dall'elenco.

Sostituisci tutti i membri

Per sostituire tutti i membri di un segmento di pubblico Customer Match evitando un elenco di utenti vuoto, segui questi passaggi:

1. Registra l'ora corrente come T.
2. Inizia a caricare i nuovi membri inviando un IngestAudienceMembersRequest. Se necessario, puoi effettuare più richieste di importazione.

3. Attendi il completamento dell'elaborazione di tutte le richieste di importazione. Puoi controllare lo stato delle tue richieste utilizzando Diagnostica.

   Nota: se un elenco di utenti temporaneamente vuoto non è un problema, puoi saltare questo passaggio e andare al passaggio 4. Ti consigliamo comunque di controllare lo stato delle tue richieste di importazione per verificare che siano state elaborate correttamente.

4. Invia un RemoveAllAudienceMembersRequest con removeAsOfTime impostato sul timestamp T registrato nel passaggio 1. In questo modo vengono rimossi solo i membri aggiunti prima di iniziare a caricare i nuovi membri, lasciando solo quelli appena aggiunti.

Crea la richiesta

Imposta i seguenti campi nel corpo di RemoveAllAudienceMembersRequest:

destinations

Obbligatorio. L'elenco delle destinazioni. Il campo productDestinationId in ogni destinazione specifica il segmento di pubblico da cui vuoi rimuovere i membri. Per saperne di più, consulta Configura le destinazioni.

removeAsOfTime

Facoltativo. Verranno rimossi solo i membri aggiunti prima di questa data. Per i dettagli sulla formattazione, consulta Formato del timestamp. Se non viene impostato, questo valore viene impostato per impostazione predefinita sull'ora corrente.

validateOnly

Facoltativo. Impostalo su true per convalidare la richiesta senza applicare le modifiche. Quando è tutto pronto per applicare le modifiche, imposta il valore su false.

Richieste di esempio

Ecco una richiesta di esempio che rimuove tutti i membri da un elenco Customer Match.

1. Fai clic su Apri in Explorer API per aprire Explorer API in una nuova scheda o finestra.
2. Nel corpo della richiesta in Explorer API, sostituisci ogni stringa che inizia con REPLACE_WITH, ad esempio REPLACE_WITH_OPERATING_ACCOUNT_TYPE, con il valore pertinente.
3. Fai clic su Esegui nella parte inferiore della pagina di Explorer API e completa i prompt di autorizzazione per inviare la richiesta.
4. Imposta validateOnly su true per convalidare la richiesta senza applicare le modifiche. Quando è tutto pronto per applicare le modifiche, imposta validateOnly su false.

Inserzionista

Apri in Explorer API

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

Partner di dati

Apri in Explorer API

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

Invia la richiesta

Invia la richiesta all'endpoint removeAll.

Se la richiesta ha esito positivo, la risposta contiene un requestId che puoi utilizzare per monitorare lo stato dell'operazione.

{
  "requestId": "REQUEST_ID"
}

Se la richiesta non va a buon fine, esamina gli errori per determinare la causa dell'errore.