AI arrivals

How tracking works

A consent-aware web pixel records arrivals; orders are attributed idempotently. Here is how, and how to create a test arrival.

The web pixel

Tracking uses Shopify's sanctioned web pixel, not a theme script that phones home. It runs only within Shopify's consent framework. For each landing it records the channel (which AI assistant, or non-AI), a hashed visitor key, and the landing path. It never stores anything that identifies a shopper personally.

Order attribution

When an order is placed, the app attributes it to the channel that visitor first arrived on, falling back to Shopify's own referring-site data when a pixel session is missing. Attribution is idempotent on the order id, so an order webhook that double-fires never double-counts.

Create a test arrival

Because the report only fills once an AI-referred visit happens, here is how to see the whole flow on a development store:

  1. Open your storefront with an AI referrer tag, for example https://YOUR-STORE.myshopify.com/?utm_source=chatgpt.com
  2. Click into a product.
  3. In the app, open Overview and AI Arrivals. The visit appears attributed to ChatGPT.
  4. Repeat with utm_source=perplexity.ai or gemini.google.com to see other assistants.
Consent respected. If a shopper declines tracking, no session is recorded. The report reflects consented traffic only.

Related articles