Gérer les événements utilisateur

Cette page explique comment afficher des informations sur les événements utilisateur et comment les supprimer définitivement.

Pour enregistrer des événements utilisateur en temps réel, consultez la page Enregistrer des événements utilisateur en temps réel. Pour importer des données d'événements utilisateur à partir d'événements passés, consultez la page Importer des événements utilisateur historiques.

Afficher les informations agrégées concernant les événements utilisateur

Vous pouvez consulter des informations sur les événements utilisateur enregistrés pour votre application dans la Google Cloud console, dans l'onglet Événements de la page Données de votre application.

Cette page affiche des informations telles que le nombre d'événements ingérés, le nombre d'événements non associés, le pourcentage de variation du nombre d'événements sur une période et le nombre moyen de types d'événements par document. Vous pouvez également consulter les métriques de chaque type d'événement au fil du temps. Les métriques s'affichent environ 24 heures après la première importation d'événements.

Pour afficher les informations sur vos événements utilisateur :

  1. Dans la Google Cloud console, accédez à la page Applications d'IA.

    AI Applications

  2. Cliquez sur le nom de l'application pour laquelle vous souhaitez afficher des informations sur les événements utilisateur.

  3. Sur la page Données, accédez à l'onglet Événements. Les informations sur les événements utilisateur s'affichent dans cet onglet.

Supprimer définitivement des événements utilisateur

Si certains de vos événements utilisateur n'ont pas été enregistrés correctement et que vous devez les supprimer, vous pouvez utiliser la méthode d'API userEvents.purge. Bien que vous enregistriez et importiez des événements au niveau d'un établissement, vous devez les supprimer définitivement au niveau du datastore.

Spécifiez les événements que vous souhaitez supprimer à l'aide d'un filtre d'événements utilisateur. Vous pouvez utiliser le filtre d'événements utilisateur pour spécifier les événements que vous souhaitez supprimer définitivement. Vous pouvez filtrer les champs eventTime, eventType, visitorID et userID.

Cet exemple permet de filtrer une période spécifique, qui doit être spécifiée au format date/heure 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"

Vous devriez recevoir un objet de réponse semblable à celui-ci, où purge-user-events-54321 est l'ID de l'opération :

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

Cet exemple demande l'état de l'opération :

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"

Exemple d'état d'opération : 

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

Utiliser le filtre d'événements utilisateur

Vous pouvez filtrer les événements utilisateur à supprimer.

Le filtre est une chaîne qui contient une ou plusieurs des restrictions suivantes :

  • eventTime : fournit un horodatage pour restreindre les événements à supprimer. Ce filtre peut être spécifié une ou deux fois, accompagné d'un symbole supérieur à (>) ou inférieur à (<) symbole. La période spécifiée doit être un bloc unique contigu.

  • eventType : restreint les événements à supprimer à un seul type d'événement.

  • visitorID : restreint les événements à supprimer à un seul ID de visiteur.

  • userID : restreint les événements à supprimer à un seul ID d'utilisateur.

Seuls les événements utilisateur qui satisfont toutes les restrictions sont supprimés.

Par exemple, pour supprimer tous les événements utilisateur de type add-to-cart qui ont été enregistrés le 1er février 2023 ou après cette date, vous devez fournir la chaîne de filtre suivante :

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

Étape suivante