Shopify Event Tracking

To get started with Fueled, you will first need to configure how the app tracks client-side and server-side events. These configuration settings apply to all of the destinations where Fueled sends data, such as Google Analytics and Facebook Conversion API.

Step 1: Configure Client-Side Event Tracking

The first step in configuring Fueled is to enable our "App Extension" in your Shopify theme.

Click the link in the "Configure Client-Side Tracking section. This will take you to your active Shopify theme, where you can enable our App Extension Widget. Remember to hit "Save."

Optional: Adjust You "Add To Cart" Tracking Settings

We will cover this option in more detail in: Custom Pixel For Tracking ATC Events

However, it's good to know that you can customize how "Add To Cart" (ATC) events are tracked in your theme. By default, Fueled listens for standard ATC event buttons in your theme code. However, for highly customized sites, it's sometimes helpful to disable our standard ATC tracking and instead leverage our Shopify Custom Pixel implementation for these events.

Step 2: Configure Server-Side Event Tracking

Next, confirm your server-side event tracking configuration.

Out-of-the-box, Fueled will track checkout and purchase-related events server-side. We inject special code in your Shopify theme (when you have client-side tracking enabled) to send attribution events from the browser to our server-side event integration.

With server-side tracking, we can ensure near-perfect, 1-to-1 tracking of purchase events between Shopify and Google Analytics. With server-side tracking, we also allow merchants to use point-of-sale and recurring billing purchases for ad targeting in Facebook.

There are pros and cons to client-side vs. server-side tracking of purchase events into GA4. With server-side tracking, you get better parity between GA4 reports and Shopify order counts/totals. With client-side tracking, you do get a bit more metadata about purchase events, such as information about browser devices and geolocation data.

We do offer customizations to track purchase event client-side. Please contact [email protected] for more information on this.

Step 3: Configure Fueled's Custom Pixel

Fueled leverages a Custom Pixel for tracking Checkout-related steps and purchases. If you installed our app before February 4th, 2025, you will likely need to update any custom pixel code that you have configured with us. Otherwise, you will simply need to install our Custom Pixel v2 following these instructions.

This pixel code can be found here:

client-scripts/shopify/custom_pixel_v2.js at main · fueled-io/client-scriptsGitHub

This code can be added as a custom pixel here:

https://admin.shopify.com/store/[your-store-name]/settings/customer_events

Step 4: (Optional) Configure Fueled's Domain Proxy

At the bottom of our "Tracking Setup" tab, you will see a reference to our "Domain Proxy" feature:

This feature is only available on our "Fueled Advanced" and "Fueled Plus" plans. With domain proxying, we run all of Fueled's scripts, as well as our Google Analytics endpoint over a domain proxy, which helps with cookie expires and ensures more complete client-side event tracking.

If you are interested in learning more about our advanced features, please visit: