# 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.

<figure><img src="/files/WBn1SZtIyN5R4HpNZi1A" alt=""><figcaption><p>Fueled's "Tracking Setup" configuration screen.</p></figcaption></figure>

## Step 1: Configure Client-Side Event Tracking

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

<figure><img src="/files/SKd3Cp95eUBI1fJICGEj" alt=""><figcaption><p>At the top o f our "Tracking Setup" screen, you will find a link to enable Fueled's App Extension in your theme.</p></figcaption></figure>

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."*

<figure><img src="/files/B9AFWjxbFpvi1JEILtNX" alt=""><figcaption><p>Save Fueled's App Extension settings in your active theme.</p></figcaption></figure>

### Optional: Adjust You "Add To Cart" Tracking Settings

We will cover this option in more detail in: [Custom Pixel For Tracking ATC Events](/apps/shopify/shopify-event-tracking/custom-pixel/custom-pixel-for-tracking-atc-events.md)

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.

<figure><img src="/files/TQRt5w2cRSexVbatNAir" alt=""><figcaption><p>By default, Fueled tracks checkout and purchase-related events server-side.</p></figcaption></figure>

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.

{% hint style="info" %}
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 <support@fueled.io> for more information on this.
{% endhint %}

## 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 <mark style="color:red;">`Custom Pixel v2`</mark> following these instructions.

<figure><img src="/files/o4YJNbYH1AU0p48Qa7Ti" alt=""><figcaption><p>Instructions for installing Fueled's Custom Pixel v2.</p></figcaption></figure>

This pixel code can be found here:

{% embed url="<https://github.com/fueled-io/client-scripts/blob/main/shopify/custom_pixel_v2.js>" %}

This code can be added as a custom pixel here:

<mark style="color:red;">`https://admin.shopify.com/store/[your-store-name]/settings/customer_events`</mark>

## 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:

<figure><img src="/files/O40ZaadC6zFL9SqxjWcK" alt=""><figcaption><p>Callout for our Domain Proxy feature</p></figcaption></figure>

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:

{% embed url="<https://fueled.io/pricing>" %}

## Next Steps:

{% content-ref url="/pages/SGef3SN6teecDb10qJ50" %}
[Customizing Client-Side Shopify Events](/apps/shopify/shopify-event-tracking/customizing-client-side-shopify-events.md)
{% endcontent-ref %}

{% content-ref url="/pages/xiDQlXqLx34y9WXbnl3n" %}
[Custom Pixel For Tracking ATC Events](/apps/shopify/shopify-event-tracking/custom-pixel/custom-pixel-for-tracking-atc-events.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZSY7ECOW7NtnKmDGjZKN" %}
[Working with Fueled’s Shopify Data Layer](/apps/shopify/shopify-event-tracking/working-with-fueleds-shopify-data-layer.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.fueled.io/apps/shopify/shopify-event-tracking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.