When this is useful
Use this setup when shoppers purchase through Jurni-hosted pages served through the Shopify app proxy or a Jurni custom subdomain and you want that Storefront API activity represented in Shopify’s channel reporting. Native Shopify Pages already run inside the Shopify Online Store theme, so they use a different storefront surface. Do not treat this Headless-channel token as the mechanism that makes Shopify Pages work.What Jurni needs
Jurni currently asks for one field: Shopify Storefront public access token The token is generated by Shopify’s Headless sales channel after you create a storefront.Connect Shopify Analytics
1
Install Shopify's Headless channel
In Shopify admin, install/add the Headless sales channel if it is not already available for the store.
2
Create a storefront
Open Sales channels → Headless and create a storefront for the Jurni integration.
3
Give the storefront a clear name
A name such as Jurni Headless Storefront makes the channel easy to recognize in Shopify. The identifier Jurni actually stores is the public access token, so the display name is primarily an operational/reporting choice.
4
Copy the public access token
Open the Storefront API token settings for that Headless storefront and copy the Public access token.
5
Save it in Jurni
In Settings → Integrations → Data Integrations → Shopify Analytics, paste the public access token and choose Save Changes.
Verify in Shopify
After real Jurni-hosted traffic and commerce activity begins, use Shopify analytics/reports to inspect the Headless storefront/channel. Shopify reporting is not necessarily real-time, so allow its reporting pipeline to update before diagnosing a missing channel immediately after setup. For order-level debugging, remember that Shopify Sales channel and Jurni attribution answer different questions. Jurni attribution is based on Jurni visit/cart/checkout evidence, not the Shopify channel label.Updating or disconnecting
The Jurni integration lets you:- Update token when the Shopify Headless storefront/token changes
- Disconnect by removing the saved token
Troubleshooting
Jurni does not show Connected
Jurni does not show Connected
Confirm the value is the public Storefront API token from a Shopify Headless storefront and that it was saved in the correct Jurni workspace.
I only use native Shopify Pages
I only use native Shopify Pages
Shopify Pages are served by the Online Store theme. You do not need this Headless reporting setup simply to publish or render a Shopify Page.
Shopify and Jurni reports do not match
Shopify and Jurni reports do not match
Compare the same date range/timezone and remember that channel reporting and Jurni attribution use different models. See Analytics Differences and Shopify Sales Channel.
Related guides
- Shopify Setup Overview
- Shopify Sales Channel
- Attribution Overview
- Shopify Pages
- Analytics Differences
