Symptom
You’ve installed TrackShift but events are not showing in:
- TrackShift Validation dashboard
- Google Analytics 4
- Meta Events Manager
- Other ad platforms
Quick Diagnostic Checklist
- [ ] Web Pixels are installed (check Migration page)
- [ ] Consent banner accepted (for GDPR regions)
- [ ] Tracking IDs are correct
- [ ] Ad blockers disabled for testing
- [ ] Waited 2-5 minutes for events to appear
Step-by-Step Troubleshooting
Step 1: Verify Pixel Installation
- Go to TrackShift → Migration
- Check the status for each provider:
- ✅ Installed – Pixel is active
- ⚠️ Not Installed – Click “Install” to activate
- ❌ Error – Check error message
If pixels show “Installed” but events aren’t flowing, continue to Step 2.
Step 2: Check Consent Status
If you’re in the EU or have a consent banner:
- Open your store in an Incognito/Private window
- You should see a consent banner
- Click Accept or Allow All
- Browse to a product page
- Add item to cart
- Check TrackShift in 2-3 minutes
Important: Events won’t fire until consent is granted. This is expected GDPR behavior.
Step 3: Test Without Ad Blockers
Ad blockers can interfere with event transmission:
- Disable any ad blocker extensions
- Or use a browser profile without extensions
- Clear your browser cache
- Visit your store and perform test actions
Step 4: Check Browser Network Tab
- Open your store in a new tab
- Press F12 to open Developer Tools
- Go to the Network tab
- In the filter box, type
telemetry - Browse your store (view product, add to cart)
- You should see requests to
/api/telemetry/ingest
If you see requests:
- Check the response status (should be 200)
- Check the response body for errors
If you don’t see requests:
- Pixel may not be installed correctly
- Check for JavaScript errors in Console tab
Step 5: Check Console for Errors
- In Developer Tools, go to Console tab
- Look for any red error messages
- Filter by “TrackShift” or “pixel”
Common errors and solutions:
| Error | Solution |
| “Shop not found” | Reinstall the app |
|---|---|
| “Invalid tracking ID” | Update tracking ID in Migration |
| “Consent required” | Accept consent banner |
| “Script blocked” | Disable ad blocker |
Step 6: Verify in Ad Platforms
Events may be flowing but not visible yet:
GA4:
- Go to GA4 → Configure → DebugView
- Enable debug mode in your browser
- Perform test actions
- Events should appear in real-time
Meta:
- Go to Events Manager → Test Events
- Enter your store URL
- Click “Open Website”
- Perform test actions
- Events appear in Test Events tab
TikTok:
- Go to Events Manager → Test Events
- Similar process to Meta
Step 7: Check Webhook Status
For purchase events specifically:
- Go to Shopify Admin → Settings → Notifications
- Scroll down to Webhooks
- Look for TrackShift webhook entries
- If missing, go to TrackShift and reinstall app
Common Causes of Missing Events
Cause 1: Multiple Tracking Implementations
If you have tracking code in multiple places, conflicts can occur:
- Additional Scripts (legacy)
- Theme.liquid
- Shopify native apps
- TrackShift
Solution: Remove duplicate tracking code. Keep only TrackShift.
Cause 2: Theme Conflicts
Some themes may have JavaScript that interferes with tracking:
- Try testing with a default Shopify theme
- If events work, your theme has a conflict
- Contact your theme developer
Cause 3: Checkout Restrictions
Shopify Plus stores with checkout.liquid customizations may have issues:
- Review checkout.liquid for conflicting scripts
- Ensure checkout extensibility is enabled
- Contact Shopify Plus support if needed
Cause 4: App Conflicts
Other Shopify apps may conflict:
- Temporarily disable other tracking apps
- Test TrackShift in isolation
- Re-enable apps one by one to find conflict
Still Not Working?
If you’ve tried all steps above:
- Take screenshots of:
- TrackShift Migration page
- Network tab showing (or not showing) requests
- Any console errors
- Note your:
- Browser and version
- Operating system
- Store URL
- Email support@trackshift.app with this information
—