Storefront tracking
Enable theme app embed or headless API ingest for Browse and Cart Abandonment playbooks.
Browse Abandonment, Cart Abandonment, High-Intent Visitor Alert, and Quiz Completion Followup require storefront events before or outside checkout. Use the theme app embed for Liquid stores or the headless API for Hydrogen and Next.js storefronts.
The theme pixel sends checkout:started when a shopper lands on checkout. Engine cancels that session's cart-abandonment watch immediately — you do not need to wait for Shopify checkout webhooks alone.
| Setting | Type | Default | Description |
|---|---|---|---|
| Browse dwell (minutes) | number | 15 | Browse Abandonment — alert after browsing without add-to-cart (5–120) |
| Cart idle delay (minutes) | number | 60 | Cart Abandonment — alert after cart activity stops (10–1440) |
| High-intent dwell (minutes) | number | 8 | High-Intent Visitor Alert — strong intent dwell threshold (3–30) |
Theme (Liquid / OS 2.0)
- Shopify Admin → Online Store → Themes → Customize
- App embeds → enable Arcanum Engine — Storefront tracking → Save
- Arcanum Engine → Settings → Storefront tracking → Send test event
- Confirm Receiving events, then install Browse or Cart Abandonment
Headless (Hydrogen / Next.js)
- Settings → Storefront tracking → Generate API key (server-side only)
- POST JSON events to the ingest URL with Authorization: Bearer <key> and X-Arcanum-Shop-Domain
- Send page:view and cart:add from your server proxy — never expose the key in NEXT_PUBLIC_* vars
- Verify Receiving events, then install playbooks
Was this page helpful?