Administra los eventos de usuario

En esta página, se describe cómo ver información de los eventos de usuario y borrarlos definitivamente.

Para registrar eventos de usuario a medida que ocurren, consulta Registra eventos de usuario en tiempo real. Para importar datos de eventos de usuarios anteriores, consulta Importa eventos de usuarios históricos.

Visualiza información agregada de los eventos de usuarios

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

En esta página, se muestra información como la cantidad de eventos transferidos, la cantidad de eventos no unidos, el cambio porcentual en la cantidad de eventos durante un período y el recuento promedio del tipo de evento por documento. Además, puedes 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 a Recomendaciones para contenido multimedia.

Para ver la información de tus eventos de usuario, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Agent Builder.

    Agent Builder

  2. Haz clic en el nombre de la app de la que deseas ver la información de eventos del usuario.

  3. En la página Datos, ve a la pestaña Eventos. La información de los eventos de usuarios se muestra en esta pestaña.

Borra definitivamente los eventos de usuario

Si tienes eventos de usuario que no se registraron de forma correcta y necesitas quitarlos, puedes hacerlo con el método de la API userEvents.purge.

Especifica los eventos que deseas quitar mediante un filtro de eventos de usuario. Puedes usar el filtro de eventos de usuario para especificar los eventos que deseas borrar definitivamente. Puedes filtrar con los campos eventTime, eventType, visitorID y userID.

Debido a que no puedes deshacer la purga, prueba los filtros mediante una prueba de validación antes de borrar los eventos de usuario. El campo force está configurado como false de forma predeterminada. Esta configuración mostrará la cantidad de eventos que se borrarán sin borrarlos. Cuando estés listo para borrar los eventos de usuario, establece el campo force como true.

En este ejemplo, se filtra por un intervalo de tiempo, que debe usar el formato de fecha de la hora de Zulú. El campo force está configurado como 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"

Deberías recibir un objeto de respuesta similar al siguiente, en el que 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"
  }
}

Establecer el campo force como true fuerza la eliminación.

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"

Usa el filtro de eventos de usuario

Puedes filtrar los eventos de usuario que se borrarán.

El filtro es una string que contiene una o más de las siguientes restricciones:

  • eventTime: Proporciona una marca de tiempo para vincular los eventos que se borrarán. Este filtro se puede especificar una o dos veces, con un símbolo "mayor que" (>) o "menor que" (<). El tiempo delimitado debe ser un bloque único contiguo.

  • eventType: Restringe los eventos que se borrarán a un solo tipo de evento.

  • visitorID: Restringe los eventos que se borrarán a un solo ID de visitante.

  • userID: Restringe los eventos que se borrarán a un solo ID de usuario.

Solo se borran los eventos del usuario que cumplan con todas las restricciones.

Por ejemplo, para borrar todos los eventos de usuario de tipo add-to-cart que se registraron a partir del 1 de febrero de 2023, debes proporcionar la siguiente cadena de filtro:

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

¿Qué sigue?