Manage user events

This page describes how to view user event information and purge user events.

To record user events as they happen, see Record real-time user events. To import user event data from past events, see Import historical user events.

View aggregated user event information

You can see information about recorded user events for your app in the Google Cloud console on the Events tab of your app's Data page.

This page shows information such as number of events ingested, number of unjoined events, percentage change in number of events over a period, and average count of event type per document. In addition, you can see metrics for each event type over time. Metrics appear about 24 hours after you first upload events to Recommendations for Media.

To see your user event information:

  1. In the Google Cloud console, go to the Agent Builder page.

    Agent Builder

  2. Click the name of the app that you want to see user event information for.

  3. On the Data page, go to the Events tab. User event information is displayed on this tab.

Remove user events

To remove user events, you must delete your app and its connected data store that contains the events. Deleting your app and data store also removes your documents. You might decide to remove user events if they were imported incorrectly and you want to re-import them.

For more information, see Delete an app.

Use the user event filter

You can filter user events to be deleted.

The filter is a string that contains one or more of the following restrictions:

  • eventTime: Provides a timestamp to bound the events to be deleted. This filter can be specified once or twice, with a greater-than (>) or less-than (<) symbol. The bounded time must be a single contiguous block.

  • eventType: Restrict the events to be deleted to a single event type.

  • visitorID: Restrict the events to be deleted to a single visitor ID.

  • userID: Restrict the events to be deleted to a single user ID.

Only user events that satisfy all of the restrictions are deleted.

For example, to delete all user events of type add-to-cart that were logged on or after February 1, 2023, you would provide the following filter string:

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

What's next