Shopify's introduction of Checkout Extensibility provides merchants with a better-performing, more secure, upgrade-safe solution for checkout customizations.
Note: Shopify requested that all merchants upgrade since the checkout.liquid template was deprecated on August 13, 2024.
This feature involves updating Athos Commerce's existing Athos Commerce app on the Shopify App Store to support Shopify's new streamlined method of tracking customer events (such as Web Pixel).
If you are integrating via our API, you also need to track product clicks on the search results page and autocomplete. This is not required if integrating via our JavaScript Catalog. Click here for more information on tracking product clicks.
Enabling Web Pixel Tracking
If you already have Web Pixel Tracking enabled, skip this section by jumping here.
To enable pixel tracking:
- Navigate to the Data\Data Connectors\Data Sources page in the Athos Search & Product Discovery console (ASD).
- Select the Shopify connection by clicking on "Shopify" or by hovering over the "..." icon on the far right and selecting "Edit".
-
Scroll down the page to the Store Settings section and click the "Enable Tracking" button.
- If Athos already has permissions to edit Pixels, proceed to Step 4.
- If Athos does not have the necessary permissions to edit Pixels, you will be redirected to your Shopify admin portal to add the permission. On the Shopify authorization page, click the "Update" button, and you will be redirected back to the Athos console.
- The Web Pixel Tracking section in the console will show that tracking is enabled.
Removing Web Pixel Tracking
To disable pixel tracking:
- Navigate to the Data Sources page in the Athos console, under Data\Data Connectors\Data Sources.
- For the Shopify feed, click the "..." button at the far right and choose "Edit".
- Scroll down and click the "Disable Tracking" button.
- Once tracking has been removed, the Web Pixel Tracking section will revert to its default state, which displays the "Enable Tracking" button. To re-enable, simply click "Enable Tracking".
FAQs
-
Do I have to migrate my tracking?
Yes, you need to set up the new tracking before August 13, 2024, to prevent any impacts to Reporting and Personalization.
-
Do I have to make any changes to my existing IntelliSuggest tracking?
Nope! Just enable the Pixel tracking and we will handle the rest. Once your Pixel tracking is enabled, you can optionally remove the previous IntelliSuggest tracking when convenient to do so.
-
I have multiple accounts in Athos but only a single Shopify store (i.e., Shopify Markets); what should I do?
Follow the "Enable Pixel Tracking" steps to set up the tracking once. The tracking beacon will automatically associate the events to its appropriate account.
-
I have multiple accounts in Athos that are associated with different Shopify stores; what should I do?
Follow the "Enable Pixel Tracking" steps to set up the tracking for each site you have.
-
I use the Shopify data connector but I have an API implementation; what should I do?
Follow the “Enable Pixel Tracking” steps to set up the pixel. If you have multiple accounts in the Athos console, you will need to update your implementation to route the pixel events to the appropriate siteID. You will also need to track product clicks on the search results page and autocomplete if they are not being tracked already. Click here for more information on tracking product clicks.
-
We are using a headless Shopify storefront; is there anything different that I need to do?
The Athos Shopify Web Pixel handles several tracking events but only for Shopify powered experiences (Shopify Stores). In most headless stores, the majority of the shopping experience happens apart from Shopify, with the exception of the checkout process; for the most part, stores still have this flow through Shopify's checkout process. Because of this, only the "checkout" tracking event handled by our Shopify Pixel will be sent. Unfortunately, the other events that the Pixel tracking would normally track (product page views and cart views) will need to be handled in the headless store. See our documentation on how to send those events here.
-
Why are recent events on the IntelliSuggest Tracking report not showing?
Collection of tracking data will start as soon as the Pixel tracking is enabled, however the IntelliSuggest tracking report will take a few days for values to populate in the report.
Additional Permissions
From time to time, Athos Commerce may require additional permissions from your site in order to provide your team with access to additional capabilities.
IMPORTANT: As a part of Shopify's efforts to migrate all public apps to use exclusively their GraphQL API, we needed additional permissions by July 1st, 2025, in order to maintain compatibility with existing features. If permission was not granted by this date, we cannot guarantee that we will still be able to access the up-to-date data we need from your store to power search, merchandising, and personalization.
Providing Additional Permissions
To provide additional permissions:
- Log in to the Athos Search & Product Discovery console (ASD) and navigate to the Data Sources page.
- Look for the "Access Scopes" banner and click the "Verify Scopes" button.
- This will redirect you to your Shopify store to provide additional permissions.
- Click "Update". This will redirect you back to the Athos console, and "Access Scopes" should no longer appear.
Comments
0 comments
Article is closed for comments.