Documentation
Everything you need to set up and configure server-side tracking for your Shopify store.
Installation
Getting started with WeltPixel Server-Side Tracking takes just a few minutes. Follow these steps to install and activate the app on your Shopify store.
Step 1: Install from Shopify App Store
- Visit the WeltPixel Server-Side Tracking page on the Shopify App Store
- Click "Add app" and authorize the installation
- Once installed, you'll be redirected to the app dashboard
Step 2: Enable the App Embed
For the tracking scripts to load on your storefront, you need to enable the app embed in your theme:
- Go to Online Store → Themes in your Shopify admin
- Click "Customize" on your active theme
- In the theme editor, click "App embeds" (left sidebar)
- Toggle ON the WeltPixel Server-Side Tracking embed
- Click "Save"
Google Analytics 4: Measurement ID
The Measurement ID identifies your GA4 data stream and is required to send events to Google Analytics. It has the format G-XXXXXXXXXX.
Finding Your Measurement ID
- Sign in to Google Analytics
- Click Admin (gear icon in the bottom left)
- In the Property column, go to Data collection and modification → Data Streams
- Click the Web tab
- Click on your web data stream to open its details
- Your Measurement ID is displayed in the first row (format:
G-XXXXXXXXXX)
Google Analytics 4: API Secret
The Measurement Protocol API Secret is required for server-side event tracking. This allows our app to send events directly to GA4 from the server.
Creating an API Secret
- Sign in to Google Analytics
- Click Admin (gear icon in the bottom left)
- In the Property column, go to Data collection and modification → Data Streams
- Click on your web data stream to open its details
- Scroll down to the Events section
- Click Measurement Protocol API secrets
- Click the Create button
- Enter a nickname for the secret (e.g., "WeltPixel Shopify")
- Click Create
- Copy the Secret value that is generated
Meta Conversions API: Pixel ID
The Meta Pixel ID identifies your pixel and is required for both browser-side and server-side event tracking with Facebook and Instagram.
Finding Your Pixel ID
- Go to Meta Events Manager
- In the left sidebar, click Data Sources
- Select your Pixel from the list
- Your Pixel ID is the number displayed next to your Pixel's name
Meta Conversions API: Access Token
The Conversions API Access Token allows our app to send events directly to Meta's servers, improving tracking accuracy and ad optimization.
Generating an Access Token
- Go to Meta Events Manager
- In the left sidebar, click Data Sources
- Select your Pixel from the list
- Click the Settings tab
- Scroll down to the Conversions API section
- Click Generate access token
- Copy the token that is displayed
TikTok Events API: Pixel ID
The TikTok Pixel ID identifies your pixel and is required for tracking conversions from your TikTok advertising campaigns.
Finding Your Pixel ID
- Sign in to TikTok Ads Manager
- Click Assets in the top navigation
- Select Events from the dropdown
- Click Web Events
- Select your pixel from the list (or create a new one if needed)
- Your Pixel ID is displayed on the Overview page
Alternatively, you can find it by:
- Click the Manage tab on your pixel
- Go to Pixel settings
- The Pixel ID is shown at the top of the settings page
TikTok Events API: Access Token
The Events API Access Token allows our app to send conversion events directly to TikTok's servers for improved tracking accuracy.
Generating an Access Token
- Sign in to TikTok Ads Manager
- Click Assets in the top navigation
- Select Events from the dropdown
- Click Web Events
- Select your pixel from the list
- Click the Settings tab
- Scroll down to the Events API section
- Click Generate Access Token
- Copy the token that is displayed
Google Ads: Enable Auto-Tagging
Auto-tagging adds a small tracking code (called a gclid, short for "Google Click Identifier") to the end of your ad links whenever someone clicks one of your Google Ads. This code is what lets the app know which purchases came from a Google Ad. Without it, the app can't connect the sale back to your ad.
Enabling Auto-Tagging
- Sign in to your Google Ads account
- Click the Admin icon (gear/wrench) in the left sidebar
- Click Account settings
- Find the Auto-tagging section
- Make sure "Tag the URL that people click through from my ad" is checked
- Click Save
Google Ads: Connect Your Account
To send your purchase data to Google Ads, you'll sign in with the Google account that owns your Google Ads. It's the same sign-in flow you'd use for Gmail or YouTube — the app never sees your password, and you can disconnect at any time from the app's settings.
Connecting with Your Google Account
- Open the WeltPixel Server-Side Tracking app in your Shopify admin
- Navigate to the Setup Wizard or the Google Ads channel settings
- Click Connect to begin the sign-in flow
- A Google sign-in window will open — choose the Google account that has access to your Google Ads account
- Review the permissions Google asks you to grant, then click Allow
- The sign-in window will close automatically and the app will show "Google account connected" with a green checkmark
Selecting Your Google Ads Account
After you've signed in, the app will show you every Google Ads account your Google account has access to.
- A dropdown will appear listing your available accounts
- Each account shows its name and Customer ID (e.g.,
My Store (123-456-7890)) - Select the Google Ads account you want to connect
Google Ads: Conversion Action
A conversion action is how Google Ads tracks what counts as a "sale" and what each sale is worth. You need one set up for offline conversion imports — that's the setting that lets the app upload your Shopify purchases to Google Ads in the background.
Option A: Automatic Creation (Recommended)
The fastest path — the app creates a properly-configured conversion action for you in one click.
- After selecting your account, the app checks for existing conversion actions
- If none are suitable, click Create conversion action
- The app creates an action named "Shopify WeltPixel Conversion" with these settings:
- Type: Upload Clicks (offline import)
- Category: Purchase
- Value: Use different values for each conversion
- Lookback window: 90 days
- Status: Enabled
- The new action is automatically selected in the dropdown with a green confirmation banner
Option B: Create One Manually in Google Ads
If you prefer to create the conversion action yourself:
- In Google Ads, click Goals in the left sidebar
- Click Conversions → Summary
- Click "+ New conversion action"
- On the data sources page, check "Conversions offline" and click Edit data sources
- Select "Skip this step and set up a data source later" at the bottom of the list
- Leave "Enhanced conversions for leads" unchecked, then click Save and continue
- Click "+ Add conversion action manually" and configure:
- Goal: Purchase
- Value: Use different values for each conversion (default:
0) - Count: Every
- Click-through conversion window: 90 days
- Attribution model: Data-driven
- Click Save and continue, then Done
- Return to the WeltPixel app, click Recheck, and select your new action from the dropdown
Completing the Connection
With your Google account connected, Google Ads account selected, and conversion action chosen, click Connect at the bottom of the wizard to save your configuration. Make sure the Google Ads tracking toggle is enabled on the channel settings page.
Google Ads: Enhanced Conversions
Enhanced Conversions improve how accurately Google Ads matches your store's purchases to the customers who clicked your ads. When enabled, the app sends hashed customer data (like email and phone number) from each order alongside the conversion data. Google uses this hashed data to fill in gaps that the gclid click identifier alone can't cover — improving your reported conversion count and Smart Bidding accuracy.
Enabling Enhanced Conversions
- In the WeltPixel Server-Side Tracking app, open the Google Ads channel settings
- Scroll to the Advanced Settings section
- Check the Enable Enhanced Conversions box
- Save your changes
Frequently Asked Questions
How much does this app cost?
The app includes a 14-day free trial with no credit card required. After that, it's $39/month with unlimited orders and no hidden costs.
Will this slow down my store?
No. Server-side events have zero impact on page load since they're processed entirely on the server, not in the customer's browser.
Do I need all four integrations (GA4, Meta, TikTok, Google Ads)?
No, you can enable only the integrations you need. Configure just the platforms you're actively using for advertising or analytics — for example, if you only run Google Ads campaigns, you can skip Meta and TikTok entirely.
What events are tracked?
The app tracks standard e-commerce events including page views, product views, add to cart, checkout initiation, and purchases. All events are sent server-side for maximum accuracy. Google Ads only receives purchase conversions (that's all it uses for bid optimization) — the other events are sent to GA4, Meta, and TikTok.
How do I ensure optimal conversion attribution/Match Quality?
Maximum scores are only reached when events include all required identifiers. The app sends these on purchase events (ensure your Shopify checkout requests both an email and a phone number) and persists them on all events after a purchase. Logged-in users can also reach maximum scores when their account profile includes an address, email, and phone number. Google Ads uses a different matching mechanism — conversions are attributed via the gclid click identifier, not user identifiers. See the Google Ads section above for details.
How do I verify events are being sent?
Each platform has its own debugging tools: GA4 DebugView, Meta Events Manager Test Events, TikTok Events Manager, and Google Ads → Goals → Conversions → Summary. Check these tools to confirm events are being received. Note that Google Ads conversions can take up to 3 hours to appear — this is normal for offline conversion imports.
How do I prevent duplicate event tracking?
Disable any overlapping tracking sources so events are only sent once per platform. For example, if you're using the official Facebook & Instagram app alongside WeltPixel, turn off the Data Sharing setting in that app to avoid duplicate conversions (you can keep Catalog Sync enabled without any issues). For Google Ads, if you already have a Google Tag or Google Tag Manager setup tracking purchase conversions on your store, remove or disable it before enabling our Google Ads integration — otherwise the same purchase will be counted twice.
Why aren't my Google Ads conversions showing up?
Common reasons: (1) offline conversions can take up to 3 hours to appear in Google Ads after a test order; (2) the customer didn't actually arrive from a Google Ads click — only orders carrying a gclid are counted; (3) Auto-Tagging isn't enabled in your Google Ads account (see the Auto-Tagging section above); or (4) you signed in with the wrong Google account when connecting — click Reconnect in the app and sign in with the right one. If none of those apply, check that your conversion action is marked Active under Goals → Conversions → Summary in Google Ads.
How do I get support?
For technical support, submit a support ticket. In the "How can we help you today?" dropdown, select Shopify to ensure your request is routed to the right team.