Gestionar eventos de usuario

En esta página se describe cómo ver la información de eventos de usuario y cómo purgar eventos de usuario.

Para registrar eventos de usuario a medida que se producen, consulte Registrar eventos de usuario en tiempo real. Para importar datos de eventos de usuario anteriores, consulte Importar historial de eventos de usuario.

Ver información agregada de eventos de usuario

Puedes ver información sobre los eventos de usuario registrados de tu aplicación en la consola, en la pestaña Eventos de la página Datos de tu aplicación.Google Cloud

En esta página se muestra información como el número de eventos registrados, el número de eventos no unidos, el cambio porcentual en el número de eventos durante un periodo y el recuento medio de tipos de eventos por documento. Además, puede ver las métricas de cada tipo de evento a lo largo del tiempo. Las métricas aparecen unas 24 horas después de que subas los eventos por primera vez.

Para ver la información de los eventos de usuario, siga estos pasos:

  1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

    Aplicaciones de IA

  2. Haz clic en el nombre de la aplicación de la que quieras ver la información de eventos de usuario.

  3. En la página Datos, vaya a la pestaña Eventos. En esta pestaña se muestra información sobre los eventos de usuario.

Purgar eventos de usuario

Si tiene eventos de usuario que no se han registrado correctamente y necesita eliminarlos, puede hacerlo con el método de la API userEvents.purge.

Especifique los eventos que quiere quitar mediante un filtro de eventos de usuario. Puede usar el filtro de eventos de usuario para especificar los eventos que quiere purgar. Puedes filtrar por los campos eventTime, eventType, visitorID y userID.

En este ejemplo se filtra por un intervalo de tiempo, que debe usar el formato de fecha de hora zulú.

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"

Deberías recibir un objeto de respuesta similar al siguiente, donde purge-user-events-54321 es el ID de la operación:

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

En este ejemplo se solicita el estado de la operación:

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"

Ejemplo de estado de la operación: 

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

Usar el filtro de eventos de usuario

Puede filtrar los eventos de usuario que quiera eliminar.

El filtro es una cadena que contiene una o varias de las siguientes restricciones:

  • eventTime: proporciona una marca de tiempo para delimitar los eventos que se van a eliminar. Este filtro se puede especificar una o dos veces con el símbolo mayor que (>) o menor que (<). El tiempo delimitado debe ser un único bloque contiguo.

  • eventType: restringe los eventos que se van a eliminar a un solo tipo de evento.

  • visitorID: restringe los eventos que se van a eliminar a un solo ID de visitante.

  • userID: restringe los eventos que se van a eliminar a un solo ID de usuario.

Solo se eliminan los eventos de usuario que cumplen todas las restricciones.

Por ejemplo, para eliminar todos los eventos de usuario de tipo add-to-cart que se registraron el 1 de febrero del 2023 o después, debe proporcionar la siguiente cadena de filtro:

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

Siguientes pasos