Faça a gestão de eventos do utilizador

Esta página descreve como ver informações de eventos do utilizador e eliminar eventos do utilizador.

Para registar eventos do utilizador à medida que ocorrem, consulte o artigo Registe eventos do utilizador em tempo real. Para importar dados de eventos de utilizadores de eventos anteriores, consulte o artigo Importe eventos de utilizadores anteriores.

Veja informações de eventos de utilizadores agregadas

Pode ver informações sobre eventos de utilizadores registados para a sua app na Google Cloud consola no separador Eventos da página Dados da sua app.

Esta página mostra informações como o número de eventos carregados, o número de eventos não associados, a percentagem de alteração no número de eventos durante um período e a contagem média do tipo de evento por documento. Além disso, pode ver métricas para cada tipo de evento ao longo do tempo. As métricas são apresentadas cerca de 24 horas após o primeiro carregamento de eventos.

Para ver as informações de eventos do utilizador:

  1. Na Google Cloud consola, aceda à página Aplicações de IA.

    Aplicações de IA

  2. Clique no nome da app para a qual quer ver informações de eventos do utilizador.

  3. Na página Dados, aceda ao separador Eventos. As informações dos eventos do utilizador são apresentadas neste separador.

Remova completamente eventos do utilizador

Se tiver eventos de utilizadores que não foram registados corretamente e precisar de os remover, pode fazê-lo através do método da API userEvents.purge.

Especifique os eventos que quer remover através de um filtro de eventos do utilizador. Pode usar o filtro de eventos do utilizador para especificar os eventos que quer remover completamente. Pode filtrar com os campos eventTime, eventType, visitorID e userID.

Este exemplo filtra um intervalo de tempo, que tem de usar o formato de data/hora Zulu.

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"

Deve receber um objeto de resposta semelhante ao seguinte, em que purge-user-events-54321 é o ID da operação:

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

Este exemplo pede o estado da operação:

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"

Exemplo de estado da operação: 

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

Use o filtro de eventos do utilizador

Pode filtrar os eventos do utilizador a eliminar.

O filtro é uma string que contém uma ou mais das seguintes restrições:

  • eventTime: fornece uma data/hora para limitar os eventos a serem eliminados. Este filtro pode ser especificado uma ou duas vezes, com um símbolo de maior que (>) ou menor que (<). O tempo delimitado tem de ser um único bloco contíguo.

  • eventType: restrinja os eventos a eliminar a um único tipo de evento.

  • visitorID: restringe os eventos a eliminar a um único ID de visitante.

  • userID: restringe os eventos a eliminar a um único ID do utilizador.

Apenas os eventos do utilizador que satisfazem todas as restrições são eliminados.

Por exemplo, para eliminar todos os eventos de utilizador do tipo add-to-cart que foram registados a 1 de fevereiro de 2023 ou após essa data, forneceria a seguinte string de filtro:

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

O que se segue?