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 di un pubblico, invia un RemoveAllAudienceMembersRequest e ometti il campo removeAsOfTime. 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:

1. Registra l'ora attuale come T.
2. Inizia a caricare i nuovi abbonati 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.

4. Invia una richiesta RemoveAllAudienceMembersRequest con removeAsOfTime impostato sul timestamp T registrato nel passaggio 1. In questo modo vengono rimossi solo i membri aggiunti prima dell'inizio del caricamento dei 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 Configurare le destinazioni.

removeAsOfTime

Facoltativo. Verranno rimossi solo i membri aggiunti prima di questo orario. Per i dettagli sulla formattazione, vedi Formato del timestamp. Se non viene impostato, questo valore corrisponde all'ora corrente.

validateOnly

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

Richieste di esempio

Di seguito è riportato un esempio di richiesta 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 API Explorer 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.

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

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