TrueTracked

Documentation

Setup guides and reference documentation to help you get the most from TrueTracked.

Integrations

Connect your Shopify store and ad platform accounts to TrueTracked for complete attribution data. Integrations enable automatic product syncing, order webhook processing, and ad spend data collection.

Shopify

Connecting your Shopify store is the foundation of TrueTracked's attribution system. It enables order webhook processing, product catalog syncing, and checkout event tracking.

How to Connect

  1. Go to Settings > Integrations in your TrueTracked dashboard
  2. Under Sites, click Connect on the Shopify card
  3. Enter your Shopify store domain (e.g., mystore.myshopify.com)
  4. Enter your Shopify Admin API Access Token
  5. Click Connect

Getting Your Shopify API Token

  1. In your Shopify admin, go to Settings > Apps and sales channels
  2. Click Develop apps (you may need to enable developer access first)
  3. Click Create an app and give it a name (e.g., "TrueTracked")
  4. Under Configuration, click Configure Admin API scopes
  5. Enable the following scopes:
    • read_products — for product catalog syncing
    • read_orders — for order data
  6. Click Save, then Install app
  7. Copy the Admin API access token — it's only shown once

Security note: Your API token is encrypted and stored securely. It is never exposed to the frontend or included in API responses.

What Happens After Connecting

  • TrueTracked syncs your product catalog (variants, prices, SKUs) for cost tracking
  • Order webhooks are set up to receive real-time purchase data
  • Product data is used for attribution reports and profit calculations

Google Ads

Connect your Google Ads account to pull ad spend data and enable campaign-level attribution.

How to Connect

  1. Go to Settings > Integrations
  2. Under Ad Platforms, click Connect on the Google Ads card
  3. You'll be redirected to Google to authorize TrueTracked
  4. Select the Google account that manages your Google Ads
  5. Grant the requested permissions
  6. After redirect, select the specific Google Ads account(s) you want to connect

Manager accounts: If your Google Ads account is managed under an MCC (Manager) account, you'll see a hierarchical list. Click into Manager accounts to browse child accounts, then select the specific ad accounts you want.

Meta (Facebook Ads)

Connect your Meta ad accounts to pull ad spend data and enable campaign-level attribution.

How to Connect

  1. Go to Settings > Integrations
  2. Under Ad Platforms, click Connect on the Meta card
  3. You'll be redirected to Facebook to authorize TrueTracked
  4. Log in and grant the requested permissions
  5. After redirect, first select a Business Manager (or "All Accounts" to see everything)
  6. Then select the specific ad account(s) you want to connect

TikTok Ads

Connect your TikTok ad accounts to pull ad spend data and enable campaign-level attribution.

How to Connect

  1. Go to Settings > Integrations
  2. Under Ad Platforms, click Connect on the TikTok card
  3. You'll be redirected to TikTok to authorize TrueTracked
  4. Log in and grant the requested permissions
  5. After redirect, select a Business Center (if applicable)
  6. Then select the specific advertiser account(s) you want to connect

Managing Connections

Once connected, you can manage your integrations from the same Settings page:

  • View status: Each integration shows a green dot when active or red when there's an issue (e.g., expired token).
  • Add more accounts: For ad platforms, click Manage to add additional ad accounts under the same authorization.
  • Disconnect: Click Manage on any integration, then use the disconnect option. This removes the stored credentials but does not delete historical data.

Troubleshooting

  • OAuth redirect fails: Ensure pop-ups aren't blocked. Some browsers block the redirect window. Try again in a new tab or disable pop-up blockers temporarily.
  • No accounts shown after authorization: Make sure you're logging in with the account that has access to the ad accounts. For Meta, ensure your Facebook user has the "Advertiser" role on the Business Manager.
  • Integration shows error status: The API token may have expired or been revoked. Disconnect and reconnect the integration to refresh the authorization.
  • Missing Shopify products after connecting: Click "Sync Now" in Cost Settings to trigger a manual product sync. Large catalogs may take a few minutes.