On a Shopify store, Vision records sessions like on any other site, and also reads what Shopify knows about each page. One extra step, a customer event, follows visitors into Shopify's checkout, where no script can run.
What Vision reads on Shopify#
| Signal | How | What you see |
|---|---|---|
| Page types | Automatic | Product views in the session timeline, with the product name |
| Add to cart | Automatic | "Added to cart" steps, side cart drawers included |
| Checkout steps | Customer event | Started checkout, contact details, shipping, payment |
| Purchases | Customer event | The order total on the session, which counts as converted |
Vision reads only a page type, a product name and a price. It never reads customer data: no name, email, address or payment details.
1. Add the script to your theme#
- Copy the script In Vision, open Install and check your site: a Shopify store gets the Shopify tab on step 2. Select Copy script.
- Edit the theme In Shopify, open Online Store → Themes, then ⋯ → Edit code on your live theme.
- Paste it Open
theme.liquid, paste the script just before</head>, then save.
Already using Google Tag Manager on the store? Use the Google Tag Manager tab instead.
2. Track checkout and purchases#
Shopify runs checkout on its own pages, where neither your theme nor Google Tag Manager can run a script. Without this step, Vision sees no purchases on a Shopify store.
- Copy the customer event In Vision, on Install, step 3, select Copy the customer event.
- Add a custom pixel In Shopify, open Settings → Customer events, then Add custom pixel. Name it Henkan Vision.
- Paste and connect Paste the code. Set the permission to Analytics, and in Data sale choose Data collected does not qualify as data sale. Then Save and Connect.
The customer event sends each checkout step and the order total to Vision, linked to the visitor's latest session. It sends nothing for a visitor Vision did not record, for example one who refused cookies.
The status card at the top of Install shows how many purchases arrived in the last 30 days, and step 3 shows the latest one.
Funnels on Shopify#
On a Shopify store, the funnel builder offers two more step types:
- Added to cart: a product added to the cart, side cart drawers included.
- Reached checkout: the visitor started Shopify checkout.
Purchase counts Shopify orders sent by the customer event.
Cookie banners on Shopify#
If the store uses its own cookie banner (Axeptio, Didomi, OneTrust…) instead of Shopify's, Vision follows that banner. See Consent.
Common issues#
- No purchases after an order Check that the custom pixel is Connected in Settings → Customer events, and that the order was placed in a browser that accepted cookies.
- Purchases but no checkout steps Some checkouts skip a step, for example Shop Pay. Purchases still count.
- Store not detected Some stores block automated visits. Pick Shopify after the check, or use the Shopify tab: the store is also detected after its first recorded session.