Tracking
How PSYKHE AI tracks shopper behaviour on Shopify through a Web Pixel, the consent model, and the events emitted.
PSYKHE AI tracking on Shopify is delivered as a Shopify Web Pixel.
How It Works
The pixel collects shopper behaviour on the storefront and forwards it to PSYKHE AI. No script tag, no theme edit. Shopify controls when the pixel can run based on the merchant's privacy configuration and the shopper's consent state (see Consent Model).
Consent Model
The pixel runs inside Shopify's Web Pixel sandbox, which means:
- it honours Shopify's Customer Privacy API and the merchant's consent banner
- it only emits events when Shopify allows the consent categories required by the pixel configuration
- merchants control the consent banner and consent categories through Shopify's standard configuration
References:
Events We Track
The pixel captures Shopify-native shopper interactions used for ranking and attribution: product views, add-to-cart, remove-from-cart, checkout, and conversion. It also accepts PSYKHE AI custom events for search, list views, list clicks, product dwell, and promotional placements.
For the full event catalogue (names, payloads, mandatory vs. recommended, quality filters), see the canonical reference: Tracking API Events.
For custom Shopify theme UI that needs to publish list, click, search, or dwell events into the PSYKHE AI Web Pixel, see Custom UI Tracking.
What The Pixel Does Not Track
- shoppers whose consent state does not allow the pixel to run
- non-online-store sales channels