Back to Home

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

  1. Visit the WeltPixel Server-Side Tracking page on the Shopify App Store
  2. Click "Add app" and authorize the installation
  3. 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:

  1. Go to Online Store → Themes in your Shopify admin
  2. Click "Customize" on your active theme
  3. In the theme editor, click "App embeds" (left sidebar)
  4. Toggle ON the WeltPixel Server-Side Tracking embed
  5. Click "Save"
Note: The app embed must be enabled for tracking to work. If you switch themes, remember to re-enable the app embed on your new theme.

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

  1. Sign in to Google Analytics
  2. Click Admin (gear icon in the bottom left)
  3. In the Property column, go to Data collection and modification → Data Streams
  4. Click the Web tab
  5. Click on your web data stream to open its details
  6. Your Measurement ID is displayed in the first row (format: G-XXXXXXXXXX)
Permissions Required: You need Editor role or higher at the property level to view the Measurement ID.

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

  1. Sign in to Google Analytics
  2. Click Admin (gear icon in the bottom left)
  3. In the Property column, go to Data collection and modification → Data Streams
  4. Click on your web data stream to open its details
  5. Scroll down to the Events section
  6. Click Measurement Protocol API secrets
  7. Click the Create button
  8. Enter a nickname for the secret (e.g., "WeltPixel Shopify")
  9. Click Create
  10. Copy the Secret value that is generated
Keep it confidential: The API Secret should be treated like a password. Do not share it publicly or commit it to version control.

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

  1. Go to Meta Events Manager
  2. In the left sidebar, click Data Sources
  3. Select your Pixel from the list
  4. Your Pixel ID is the number displayed next to your Pixel's name
Tip: The Pixel ID is a numeric string, typically 15-16 digits long.

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

  1. Go to Meta Events Manager
  2. In the left sidebar, click Data Sources
  3. Select your Pixel from the list
  4. Click the Settings tab
  5. Scroll down to the Conversions API section
  6. Click Generate access token
  7. Copy the token that is displayed
Keep it secure: The access token grants permission to send events on behalf of your business. Store it securely and never share it publicly.
Why server-side tracking? Server-side events typically have a 20-30% higher match rate compared to browser-only tracking, resulting in better ad attribution and optimization.

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

  1. Sign in to TikTok Ads Manager
  2. Click Assets in the top navigation
  3. Select Events from the dropdown
  4. Click Web Events
  5. Select your pixel from the list (or create a new one if needed)
  6. Your Pixel ID is displayed on the Overview page

Alternatively, you can find it by:

  1. Click the Manage tab on your pixel
  2. Go to Pixel settings
  3. 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

  1. Sign in to TikTok Ads Manager
  2. Click Assets in the top navigation
  3. Select Events from the dropdown
  4. Click Web Events
  5. Select your pixel from the list
  6. Click the Settings tab
  7. Scroll down to the Events API section
  8. Click Generate Access Token
  9. Copy the token that is displayed
Important: Store your access token securely. If you believe it has been compromised, generate a new one immediately.

Frequently Asked Questions

Is this app free?

Yes, the app is currently free to use with no usage limits or 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 three integrations (GA4, Meta, TikTok)?

No, you can enable only the integrations you need. Configure just the platforms you're actively using for advertising or analytics.

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.

How do I verify events are being sent?

Each platform has its own debugging tools: GA4 DebugView, Meta Events Manager Test Events, and TikTok Events Manager. Check these tools to confirm events are being received.

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.

100% Free - No Credit Card
Server-Side Tracking
Install Free