Setup guide
From install to your first live conversion in about ten minutes.
1. Install the app
Install SoSimpleTracking from the Shopify App Store and approve the permissions. The app opens in your Shopify admin with a setup checklist on its Home page. Your store currency is detected automatically, and the checkout pixel is connected for you.
2. Turn on tracking in your theme
- On the app's Home page, choose Enable tracking.
- The theme editor opens with the SoSimpleTracking app embed selected. Make sure it's switched on, then choose Save.
This adds no code to your theme files. Once a visitor who has consented views a page, the checklist shows Theme tracking: Active.
3. Check your cookie banner
SoSimpleTracking collects nothing until Shopify reports that the visitor allows marketing and hasn't opted out of data sale or sharing. In your Shopify admin, go to Settings → Customer privacy and make sure a cookie banner is shown in the regions that need one, such as the UK and EU. Consent apps that work with Shopify's Customer Privacy API work too.
Tip: with a UK or EU IP address you'll see the banner and must accept it before testing. Visitors in regions without a banner are tracked unless they opt out.
4. Connect Google Ads
- In Google Ads, create a conversion action for each event you want to send: Goals → Conversions → New conversion action → Import → Track conversions from clicks. Typically that's Purchase, plus optional Add to cart and Begin checkout actions set as secondary, so they don't drive bidding unless you want them to.
- In the app, go to Connections → Google Ads → Sign in with Google and approve access with an account that can manage the ad account.
- Enter your Customer ID (for example
123-456-7890), and a Manager account ID only if you reach the account through a manager (MCC) account. - Enter each conversion action ID. To find it, open the action in Google Ads; the ID is the
ctId=number in the page address. - Tick the events to send, and leave Test mode on for now. In test mode, uploads are validated but not recorded.
Google only accepts conversions from visits that came from a Google ad click (gclid, gbraid or wbraid). Other conversions are skipped for Google; that's expected.
5. Connect Meta (Facebook and Instagram)
- In Meta Events Manager, open your dataset (pixel) and copy its Dataset ID.
- Go to Settings → Conversions API → Generate access token and copy the token.
- Open the Test events tab and copy the test event code.
- In the app, go to Connections → Meta, paste all three, tick the events and keep Test mode on.
If the Facebook & Instagram channel or a Meta pixel on your store already sends AddToCart or InitiateCheckout, send those events from one place only, to avoid double counting. In Events Manager → Settings → Traffic permissions, allow your store's domains.
6. Connect TikTok
- In TikTok Ads Manager, go to Tools → Events → Web events and open your pixel. Copy the pixel code shown under its name.
- In the pixel's Settings → Events API, choose Generate access token.
- Under Test events → Server events, copy the test event code.
- In the app, go to Connections → TikTok, paste them, tick the events and keep test mode on.
7. Connect Pinterest
- In Pinterest Ads Manager, copy your ad account ID, shown in the account switcher and in the page address.
- Go to Conversions → Conversions API → Generate new token.
- In the app, go to Connections → Pinterest, paste both and tick the events. Pinterest has no "begin checkout" event, so it offers purchase and add to cart.
In test mode, events show under Pinterest's test events and aren't used for reporting.
8. Connect Snapchat
- In Snapchat Ads Manager, go to Events Manager, open your pixel and copy the Pixel ID. It looks like
1a2b3c4d-1234-…. - Under Setup → Conversions API, choose Generate token.
- In the app, go to Connections → Snapchat, paste both and tick the events.
In test mode, events are validated by Snapchat but not recorded.
9. Connect Reddit
- In Reddit Ads, go to Events Manager, open your pixel and copy the Pixel ID, for example
t2_abc123. - Go to Conversions API → Generate access token.
- For test mode, open Events Testing and copy the test ID.
- In the app, go to Connections → Reddit, paste them and tick purchase and/or add to cart.
10. Send a test conversion
- Open your store in a private or incognito window. Add a test click ID to the address, for example
?gclid=test123&fbclid=test456. - Accept the cookie banner if one appears, view a product and add it to the cart.
- Complete a test order. Shopify's Bogus Gateway or test mode for your payment provider works well.
- On the app's Home page, the order appears as attributed within a minute or two, and conversions sent increases.
- Check each platform's test view: Meta Test events, TikTok Test events, Pinterest test events, Reddit Events Testing. For Google, "sent" in test mode means the upload was validated.
11. Go live
Once a test conversion shows as sent, untick Test mode for that platform in Connections and save. Only events created after that are sent live. Then cancel or refund your test order in Shopify.
Under Settings you can choose whether conversion value is the subtotal after discounts (the default) or the order total, and how long unmatched visit data is kept.
12. Troubleshooting
Theme tracking isn't active
- Check the app embed is switched on and saved in the theme editor (step 2), on your published theme.
- Accept the cookie banner when testing. Nothing is collected before consent.
An order isn't attributed
- The visitor didn't consent, or declined the banner. These orders are counted but never sent.
- The order came from somewhere other than the online store, such as POS, draft orders or some marketplace channels.
A conversion was skipped
The Home page shows the reason. The most common ones:
- Google: no click ID. The visit didn't come from a Google ad.
- No matchable user data. The platform needs a click ID, its own cookie, an IP address or a hashed email to match the event, and none were available. This is common for add-to-cart events from visitors who didn't click an ad.
- Event not supported. The platform has no standard event of that type, such as Reddit and Pinterest for begin checkout.
A send failed
The platform's error is shown on the Connections page. Usually the cause is an expired or revoked token, or a wrong ID; reconnect or correct it and save. Temporary errors are retried automatically.
Still stuck? Contact support.