Gestire gli eventi utente

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

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

Visualizzare informazioni sugli eventi utente aggregati

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

Questa pagina mostra informazioni quali il numero di eventi importati, 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 ciascun tipo di evento nel tempo. Le metriche vengono visualizzate circa 24 ore dopo il primo caricamento degli eventi in Consigli per i media.

Per visualizzare le informazioni sugli eventi utente:

  1. Nella console Google Cloud, vai alla pagina Agent Builder.

    Agent Builder

  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 dell'API userEvents.purge.

Specifica gli eventi da rimuovere utilizzando un filtro degli eventi utente. Puoi utilizzare il filtro degli eventi utente per specificare gli eventi da eliminare definitivamente. Puoi filtrare con i campi eventTime, eventType, visitorID e userID.

Poiché non puoi annullare la purga, prova i filtri eseguendo un test simulato prima di eliminare gli eventi utente. Il campo force è impostato su false per impostazione predefinita. Questa impostazione restituirà il numero di eventi da eliminare senza effettivamente eliminarli. Quando è tutto pronto per eliminare effettivamente gli eventi utente, imposta il campo force su true.

Questo esempio filtra per un intervallo di tempo, che deve utilizzare il formato della data in ora Zulu. Il campo force è impostato su false.

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\"",
    "force":"false"
  }' \
  "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, dovepurge-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"
  }
}

L'impostazione del campo force su true forza l'eliminazione.

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\"",
    "force":"true"
  }' \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

Utilizzare il filtro degli eventi utente

Puoi filtrare gli eventi utente da eliminare.

Il filtro è una stringa contenente 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 periodo di tempo limitato deve essere un singolo 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 il 1° febbraio 2023 o in una data successiva, devi fornire la seguente stringa di filtro:

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

Passaggi successivi