Track events using the Coveo app for Shopify

This is for:

Developer

In this article

usage analytics events are crucial for analyzing your storefront performance and power Coveo Machine Learning (Coveo ML) models. This page explains how the Coveo AI Search and Discovery app tracks commerce events. If you’re not using the app, see Custom implementations: Track events without the Coveo AI Search & Discovery app.

Types of events

There are four types of commerce events:

Note

Under the Coveo Event Protocol (EP), the Commerce API logs search events server-side automatically for you.

We highly recommend using Coveo Atomic or Coveo Headless, as these libraries simplify event tracking.

The following table summarizes how commerce events are tracked:

Event	Atomic ^[1]	Headless
Click	Logged automatically by Atomic	Logged by Headless controllers ^[2]
Cart	Logged by Coveo web pixel
Product view
Purchase	Logged by Coveo web pixel

Event

Atomic ^[1]

Headless

Click

Logged automatically by Atomic

Logged by Headless controllers ^[2]

Cart

Logged by Coveo web pixel

Product view

Purchase

Logged by Coveo web pixel

1. Be sure to initialize the web pixel in your storefront.

2. Headless event logging:

The Coveo AI Search & Discovery app uses a web pixel to log certain commerce events based on your implementation approach.

The Coveo AI Search & Discovery app:

Deploys the web pixel when you synchronize your Shopify product catalog with Coveo.
Updates the web pixel to reflect the changes in your store when you manually synchronize your Shopify product catalog with Coveo.
Removes the web pixel when you unlink your Coveo organization from your store.