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 utenti con una singola richiesta o sostituire tutti i membri del pubblico di un elenco.

Cancellare il pubblico

Per rimuovere tutti i membri di un pubblico, invia una RemoveAllAudienceMembersRequest e ometti il campo removeAsOfTime. Per impostazione predefinita, l'ora di rimozione è l'ora corrente, quindi tutti i membri attuali vengono rimossi dall'elenco.

Sostituire tutti i membri

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

1. Registra l'ora corrente come T.
2. Inizia a caricare i nuovi membri inviando una 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 richieste utilizzando Diagnostica.

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

4. Invia una 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 i membri appena aggiunti.

Creare la richiesta

Imposta i seguenti campi nel RemoveAllAudienceMembersRequest corpo:

destinations

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

removeAsOfTime

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

validateOnly

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

Richieste di esempio

Di seguito è riportata 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 Explorer API e completa le richieste 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
}

Inviare 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 del problema.