Gestire gli eventi utente

Questa pagina descrive come visualizzare le informazioni sugli eventi utente ed eliminarli.

Per registrare gli eventi utente man mano che si verificano, consulta Registrare gli eventi utente in tempo reale. Per importare i dati degli eventi utente degli eventi passati, consulta Importare gli eventi utente storici.

Visualizzare le informazioni aggregate sugli eventi utente

Puoi visualizzare le informazioni sugli eventi utente registrati per la tua app nella console nella scheda Eventi della pagina Dati della tua app.Google Cloud

Questa pagina mostra informazioni quali il numero di eventi inseriti, il numero di eventi non uniti, la variazione percentuale del numero di eventi in un periodo e il conteggio medio del tipo di evento per documento. Inoltre, puoi visualizzare le metriche per ogni tipo di evento nel tempo. Le metriche vengono visualizzate circa 24 ore dopo il primo caricamento degli eventi.

Per visualizzare le informazioni sugli eventi utente:

  1. Nella Google Cloud console, vai alla pagina AI Applications.

    Applicazioni di AI

  2. Fai clic sul nome dell'app per cui vuoi visualizzare le informazioni sugli eventi utente.

  3. Nella pagina Dati, vai alla scheda Eventi. In questa scheda vengono visualizzate le informazioni sugli eventi utente.

Elimina definitivamente gli eventi utente

Se hai eventi utente che non sono stati registrati correttamente e devi rimuoverli, puoi farlo utilizzando il metodo API userEvents.purge.

Specifica gli eventi che vuoi rimuovere utilizzando un filtro eventi utente. Puoi utilizzare il filtro degli eventi utente per specificare gli eventi da eliminare definitivamente. Puoi filtrare in base ai campi eventTime, eventType, visitorID e userID.

Questo esempio filtra un intervallo di tempo, che deve utilizzare il formato della data Zulu Time.

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data '{
    "filter":"eventTime > \"2023-12-21T18:25:43.511Z\" eventTime < \"2023-12-21T18:30:43.511Z\"",
  }' \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

Dovresti ricevere un oggetto di risposta simile al seguente, dove purge-user-events-54321 è l'ID operazione:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/purge-user-events-54321"
}

Questo esempio richiede lo stato dell'operazione:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/operations/OPERATION_ID"

Esempio di stato dell'operazione: 

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.PurgeUserEventsResponse"
    "purgedEventsCount": "1"
  }
}

Utilizzare il filtro degli eventi utente

Puoi filtrare gli eventi utente da eliminare.

Il filtro è una stringa che contiene una o più delle seguenti limitazioni:

  • eventTime: fornisce un timestamp per delimitare gli eventi da eliminare. Questo filtro può essere specificato una o due volte, con un simbolo maggiore di (>) o minore di (<). Il tempo delimitato deve essere un unico blocco contiguo.

  • eventType: limita gli eventi da eliminare a un singolo tipo di evento.

  • visitorID: limita gli eventi da eliminare a un singolo ID visitatore.

  • userID: limita gli eventi da eliminare a un singolo ID utente.

Vengono eliminati solo gli eventi utente che soddisfano tutte le limitazioni.

Ad esempio, per eliminare tutti gli eventi utente di tipo add-to-cart registrati a partire dal 1° febbraio 2023, devi fornire la seguente stringa di filtro:

eventTime > "2023-02-01T00:00:00Z" eventType = add-to-cart

Passaggi successivi