Shopify Installation

TrueTracked is a native Shopify app. Once connected, it sets up storefront tracking, checkout tracking, and your product catalog sync automatically.

Step 1: Create your TrueTracked account

Visit app.truetracked.com and sign up. After verifying your email, you'll be prompted to create your first workspace (the org that owns your Shopify connection, ad accounts, custom domain, and billing).

Step 2: Connect Shopify from Settings → Integrations

1. From your TrueTracked dashboard, go to Settings → Integrations.
2. Under Sites, click Connect on the Shopify card.
3. Enter your Shopify store domain (e.g. mystore.myshopify.com) and click Connect to Shopify.
4. You'll be redirected to Shopify's app authorization screen. Click Install to approve the requested permissions.
5. Shopify redirects you back to TrueTracked with the integration connected and a 2-step Setup Guide ready to walk you through enabling tracking.

Step 3: Complete the Setup Guide

After install, TrueTracked adds the theme app embed to your Shopify admin. It still needs a one-time enable, and the checkout pixel has to be created by hand. The Setup Guide dialog walks you through both:

3a. Enable the TrueTracked Tracking app embed

1. Click Open Theme Editor in the Setup Guide. Shopify opens the theme customizer in a new tab.
2. In the left sidebar of the theme customizer, click App embeds.
3. Find TrueTracked Tracking and toggle it on.
4. Click Save in the top right.

This embed tracks every storefront page, capturing page views, product views, cart events, and customer journeys. Everything is configured automatically, with no manual setup needed.

3b. Add the Customer Events pixel

1. Click Open Customer Events Settings in the Setup Guide. Shopify opens the customer events page in a new tab.
2. Click Add custom pixel and give it a name, for example TrueTracked.
3. Under Customer privacy, set Permission to Not required. Without this the pixel will not fire for every visitor.
4. Copy the code snippet from the TrueTracked Setup Guide and paste it into the pixel's code box, replacing anything already there.
5. Click Save, then Connect to publish it.

The Customer Events pixel captures begin checkout, payment info, and purchase events from inside Shopify's checkout, where theme code is not allowed to run.

What gets tracked automatically

• Page views on every storefront page
• Product views
• Add to cart and remove from cart, plus cart views on your cart page
• Begin checkout, payment info, and purchase
• Orders, captured reliably even if a browser event is missed

Using a custom tracking domain

A custom domain is not required to get past ad blockers on Shopify. Our app already bypasses them automatically, so this is purely optional. A custom tracking domain mainly helps extend first-party cookie lifetime. If you want one, point a subdomain of your store (e.g. t.yourstore.com) at TrueTracked and the app picks it up automatically, with no theme code change required.

Troubleshooting

• Storefront events not firing: verify the TrueTracked Tracking app embed is enabled on the published theme (not a draft). Hard-refresh the storefront after enabling, then wait a moment for the change to take effect.
• Checkout events not firing: verify the TrueTracked custom pixel is published in Settings → Customer Events. The pixel auto-installs but doesn't enable itself.
• Orders not appearing: if both the embed and pixel are enabled, check Settings → Integrations and confirm the Shopify integration shows Active (green dot). An Uninstalled badge means the merchant removed the app from Shopify admin. Reinstall from the App Store to resume.
• Tracking paused after uninstall: if you uninstall the TrueTracked app from your Shopify admin, tracking stops. Reconnect from Settings → Integrations to resume.