Connect Shopify¶
Connecting Shopify imports your store's commerce data so Squoosh can calibrate synthetic shoppers against your real customers. Shopify is one of two calibration sources, alongside Google Analytics. A property uses one source at a time.
Connecting is two steps¶
- Install the Squoosh app on your store. This imports storefront events and commerce conversion metrics.
- Make Shopify your calibration source. A toggle in the connected store's row switches calibration to Shopify.
Installing the app makes commerce data available. It does not change which source calibrates your shoppers until you turn on the toggle.
Install the Squoosh app¶
- In the sidebar, click Integrations.
- In the Shopify row, click Install app.
- In the Connect Shopify dialog, type your store domain in the Store domain field. Enter the slug (for example,
your-store) or the full*.myshopify.comdomain. Squoosh fills in the.myshopify.comsuffix. - Click Install app. Squoosh redirects you to Shopify.
- In Shopify, approve the permissions Squoosh requests, then install the app. Squoosh reads theme metadata and generates preview URLs for experiments.
When you return to Squoosh, the Shopify row shows Connected to {your store}.
Note
If the row shows Install pending or the button reads Complete setup, the app is installed but not yet linked to a property. Finish linking the store to a property to complete the connection.
To open your store's Shopify admin later, use the Admin button in the connected row. To change which store is linked, click Disconnect, then install again with the new store domain.
Make Shopify your calibration source¶
In the connected Shopify row, turn on Shopify Analytics source. Squoosh then models your synthetic shoppers on your store's real customer behavior, so experiment results reflect your actual audience.
A property uses one calibration source at a time. Turning on Shopify Analytics source disconnects Google Analytics, and turning Google Analytics back on clears the Shopify source. You can have one or the other, not both.
Once Shopify is the calibration source, the Synthetic Shoppers page shows Calibrated with Shopify and the match between your recorded traffic and the synthetic pool.
Test a Shopify theme change¶
You don't need a special mode to test a theme change. Publish the change to an unpublished theme, then run a standard Two URLs experiment:
- Use the live theme's URL as your Control page (A).
- Use the unpublished theme's preview URL as your Variant page (B).
The change is never published to live shoppers while you test it. For the full walkthrough, see Test a Shopify theme change.
Synthetic shoppers and your Shopify data¶
Synthetic shoppers do not appear in your Shopify Analytics. Squoosh blocks its synthetic traffic before it reaches your store's tracking, so your real conversion data stays clean with no setup from you. See Keep synthetic traffic out of your analytics.
Troubleshooting¶
| Problem | What to do |
|---|---|
| Can't install the app | Ask a store admin to install it, or have your Shopify user granted permission to install and manage apps for the store. |
| Row shows Install pending | The app installed but isn't linked to a property yet. Finish linking the store to a property. |
| Wrong store linked | Click Disconnect, then Install app again and enter the correct store domain. |