Shopify Installation

TrueTracked is a native Shopify app. Once connected, the app injects the storefront tracking script, registers the checkout customer-events pixel, sets up order webhooks, and syncs your product catalog 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 auto-creates the theme app embed and the Customer Events pixel inside your Shopify admin. They still need a one-time merchant enable. The Setup Guide dialog walks you through both:

3a. Enable the Storefront 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 Storefront Tracking and toggle it on.
4. Click Save in the top right.

This embed loads TrueTracked's tracking script on every storefront page, capturing page views, product views, cart events, and customer journeys. Workspace ID and tracker endpoint are read from app metafields automatically — no manual configuration.

3b. Enable 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. Find the TrueTracked pixel in the custom events list.
3. Click Connect on the pixel to publish it.

The Customer Events pixel fires begin_checkout, payment_info_submitted, and checkout_completed events from inside Shopify's checkout extension (where the storefront script can't reach). Order webhooks also fire order/created events server-side as a redundant signal.

What gets tracked automatically

• Page views — every storefront page load (theme embed)
• Product views — Shopify product page templates
• Add to cart / view cart / remove from cart / update quantity — fetch/XHR interception on /cart/*
• Begin checkout / payment info / purchase — Customer Events pixel inside checkout
• Order created — Shopify order webhook fires server-side as a redundant purchase signal (deduplicated against the pixel)

Using a custom tracking domain

Optional but recommended for bypassing ad blockers and extending cookie lifetime. Set up a custom tracking domain on a subdomain of your store (e.g. t.yourstore.com). The Shopify app embed picks it up automatically from the workspace — no theme code change required.

Troubleshooting

• Storefront events not firing: verify the Storefront Tracking app embed is enabled on the published theme (not a draft). Hard-refresh the storefront after enabling — Shopify caches theme assets for ~60 seconds.
• 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.
• Ad blockers blocking events: set up a custom tracking domain on your store's root.