# User Events

User events are essential data points that capture shopper interactions on your Shopify storefront. Vertex AI Search for Commerce leverages user event data to train machine learning models, providing personalized search results, collection pages, and product recommendations.

User Events are ingested to Vertex AI Search for Commerce using Nimstrata's App Embed and App Pixel as part of the Theme Installation process.

# Identifying Users

Unique identities are required to enable personalization. Retail Cloud Connect leverages a uniquely generated Visitor ID to identify users. If a Shopify user is signed in, Retail Cloud Connect also leverage's Shopify's built-in User ID to persist personalized results acrossed other logged in devices, such as mobile phones.

# User Event Types

# Add to Cart

Signals that a user has added one or more products to their shopping cart. This event includes details about the product(s) added and their quantities. These events inform purchase intent, powers "Frequently Bought Together" recommendations, and helps understand product popularity.

# Remove From Cart

Signals that a user has removed one or more products from their shopping cart. This event includes details about the product(s) removed These events help understand changing user intent, refine purchase probability models, and analyze reasons for cart adjustments.

# Category Page View

Indicates that a user has viewed a Shopify collection page, such as "Women's Shoes", "Electronics Sale", or a brand-specific page. These events capture interest in broader product collections, useful for personalizing collection page results and making collection-level recommendations. These events are distinct from viewing specific product detail pages.

# Detail Page View

Indicates that a user has viewed the detail page of a product. This is a strong signal of interest in that particular item. These events are crucial for powering recommendations like "Recently Viewed Items", personalizing search rankings, and understanding product-level engagement.

# Home Page View

Signals that a user has visited the main homepage of the Shopify storefront. These events often marks the beginning of a user session and provides a baseline for site traffic analysis. While less specific than other events, it contributes to understanding overall user engagement patterns and can help train a "Recommended For You" model.

# Purchase

Signals that a user has successfully completed a transaction. This event includes details about all products purchased, quantities, prices, and the total transaction value. Thes definitive events help track conversionts, revenue attribution, training "Frequently Bought Together" models, and post-purchase analysis.

# Search

Indicates that a user has performed a search or viewed a collection page on the Shopify store. This event includes the query containing the terms the user searched for or the collection details. These events are essential for understanding user intent, improving search relevance, training query suggestion models, and identifying popular or poorly performing search terms.

# Shopping Cart Page View

Signals that a user has viewed their shopping cart page. These events indicate an intent to review the cart or proceed towards checkout and are useful for cart abandonment analysis and understanding the checkout funnel.