Remix Admin
Enter your GA4 details once and the app keeps Shopify and Google in step, so every change is shared automatically.
WeltPixel · GA4 Tracking Pixel
Merchant User Guide
Connect your Shopify storefront, checkout, and post-purchase surfaces to Google Analytics 4 with one unified tracking pixel powered by Shopify Customer Events and the Measurement Protocol.
- 11 events ready to send to GA4 Storefront, cart, checkout, and purchase
- 3 surfaces covered out of the box Storefront, checkout, and customer events
- 0 theme edits required to launch Just enable the WeltPixel GA4 app embed
GA4 Server-Side
Meta Conversions API
TikTok Events API
Contents
Jump to the part of the guide that answers your question fastest.
01
02
03
04
05
06
07
08
09
10
11
12
13
14
Overview
What the app does for your store.
How it works
See how the admin, pixel, and embed connect.
Requirements
Everything to have ready before setup.
Quick start
Five steps to go live in minutes.
GA4 settings
Break down of every option on the Settings page.
Meta Pixel
Connect Facebook & Instagram tracking.
TikTok Pixel
Setup TikTok Events API tracking.
Google Ads
Conversion attribution & linking.
Event toggles
Choose which events stay active.
Consent
Match tracking to your privacy program.
Theme embed
Enable the storefront app block.
Validation
Ways to confirm data accuracy.
Fix issues
Simple answers for common blockers.
FAQ & support
Helpful tips and how to reach us.
1. Overview
The WeltPixel – GA4 Tracking Pixel app sends the 11 critical GA4 ecommerce events (page views through purchases) from your Shopify store to Google Analytics 4 without editing theme code. It combines Shopify’s Web Pixel API, GA4’s Measurement Protocol, and a lightweight theme app embed to keep tracking resilient during theme updates or checkout changes.
- Storefront + cart + checkout coverage
- Automatic metafield + Customer Events sync
- Toggleable GA4 event registry
- DebugView-ready payloads with session & client IDs
- Consent-safe advertising signals
2. How the app works
Web Pixel Extension
Shopify’s Customer Events feed informs the GA4 pixel whenever shoppers browse, add to cart, checkout, or purchase.
Theme App Embed
Flip on the WeltPixel GA4 app embed and gtag is injected on every theme automatically—no code edits required.
Sync order: Save settings ➜ metafield updated ➜ Shopify
Customer Event refreshed ➜ theme embed + pixel read the latest config.
If a sync fails, the admin shows a warning so you can retry.
3. What you need
-
A published GA4 property with a Web data stream. Copy the
Measurement ID (format
G-XXXXXXXXXX). - A Measurement Protocol API secret generated under Admin → Data Streams → Measurement Protocol API secrets.
- Shopify staff or collaborator access with permission to install apps and manage Online Store → Themes.
- Theme editor access to enable the “WeltPixel GA4” app embed after installation.
- Optional: a staging store for testing with GA4 DebugView before going live.
4. Quick start checklist
- Install & open the app. Approve requested scopes so the app can write Customer Events and metafields.
- Enable the theme app embed. Shopify Admin → Online Store → Themes → Customize → App embeds → toggle on “WeltPixel GA4”.
- Enter GA4 credentials. In GA4 Settings, add your Measurement ID and API secret, keep “Enable Pixel Tracking” on, then click Save.
- Choose events. On Event Toggles, enable or disable the 11 GA4 events to match your compliance rules.
- Test in GA4 DebugView. Browse your storefront, then confirm events appear in GA4 Realtime/DebugView before launching.
5. GA4 settings page
Open Apps → WeltPixel GA4 Tracking Pixel → GA4 Settings to manage everything that Google Analytics needs. Each card below explains the fields you’ll see on that screen.
Enable Pixel Tracking
Use this switch to pause or resume GA4 tracking across your store with a single click.
GA4 Measurement ID
Paste the code that starts with G- from your GA4 property. We’ll check the format before saving.
GA4 API Secret
Copy the secret from GA4 → Data Streams → Measurement Protocol. This keeps purchase data flowing from checkout.
Debug Mode
Turn this on while testing so events show up instantly inside GA4 DebugView, then turn it off for day-to-day use.
Tap Save any time you make a change—the app refreshes your storefront tracking within a few
seconds.
6. Meta Pixel & CAPI
Open Apps → WeltPixel GA4 → Meta Settings to configure Facebook and Instagram tracking. Setting this up ensures your ad campaigns can optimize for purchases using server-side data.
Meta Pixel ID
Your unique dataset ID from Meta Events Manager. This powers the browser-side tracking.
Conversions API Access Token
Required for server-side tracking (CAPI). Generate this in Meta Events Manager under Settings.
7. TikTok Pixel & Events API
Open Apps → WeltPixel GA4 → TikTok Settings to feed the TikTok algorithm with high-quality signals. This integration uses both browser and server-side events to maximize match rates.
TikTok Pixel ID
The identifier for your TikTok pixel, found in TikTok Ads Manager.
Events API Access Token
The system user token that authorizes server-side events. Generate this in TikTok Events Manager.
8. Google Ads Integration
Since this app uses the Measurement Protocol for server-side purchase tracking, linking your data to Google Ads is seamless and requires no extra tags.
1. Automatic Attribution
Orders sent to GA4 are automatically attributed to Google Ads if:
- The session started with a Google Ad click (GCLID).
- The payload includes the correct
client_idandsession_id(which our app stitches automatically).
Result: The event inherits the
google / cpc source/medium without needing the GCLID in the payload itself.
2. Sending Conversions
To push server-side purchases into Google Ads:
- Link Accounts: Connect GA4 to your Google Ads account.
- Import Conversion: In Google Ads (Goals > Conversions), import the
purchaseevent from GA4.
Google Ads will simply recognize and count the events attributed to its campaigns.
9. Event toggles
The Event Toggles page mirrors the GA4 event registry
inside DEFAULT_EVENT_TOGGLES. Enabling/disabling an event
updates the Customer Event’s eventFilter so the web pixel
knows exactly which payloads to send.
| Event | Description | GA4 | Meta | TikTok |
|---|---|---|---|---|
| Page View | Storefront Tracks every storefront page view. | ✔ | ✔ | ✔ |
| View Product / Content | Storefront Product view with details. | ✔ | ✔ | ✔ |
| View Category / Collection | Storefront Collection/Category views. | ✔ | ✔ | N/A |
| Add to Cart | Storefront Item added to cart. | ✔ | ✔ | ✔ |
| Remove from Cart | Storefront Item removed from cart. | ✔ | N/A | N/A |
| View Cart | Storefront Cart page view. | ✔ | N/A | N/A |
| Begin Checkout / InitiateCheckout | Checkout Checkout initiated. | ✔ | ✔ | ✔ |
| Add Shipping Info | Checkout Shipping step completed. | ✔ | N/A | N/A |
| Add Payment Info | Checkout Payment step completed. | ✔ | ✔ | ✔ |
| Search | Storefront Site search performed. | ✔ | ✔ | ✔ |
| Purchase | Checkout Order completed. | ✔ | ✔ | ✔ |
| Place an Order (TikTok) | TikTok Special TikTok order event. | N/A | N/A | ✔ |
Tip: Turning every toggle off pauses GA4 tracking until you switch at least one event back on.
10. Consent & privacy
Consent choices are stored with each config save and forwarded with every Measurement Protocol payload. This keeps GA4’s Consent Mode aligned with any CMP decision you enforce elsewhere.
- Use “Denied” if your CMP says advertising signals cannot be sent until opt-in.
- Update the setting programmatically by re-saving once your CMP writes to a metafield or through a manual toggle after legal review.
- Combine with Shopify’s own customer privacy API if you need to block the theme embed from bootstrapping gtag until consent exists.
11. Theme app embed
- Go to Online Store → Themes → Customize.
- Select your live theme, then open the App embeds panel.
- Toggle WeltPixel GA4 to “On”.
- Click Save. No additional settings are required.
This embed simply renders the weltpixel-ga4-loader
snippet, which:
- Reads
shop.metafields.weltpixel_ga4.config. - Injects
gtag.jswith your Measurement ID. - Relays custom
weltpixel-ga4-eventmessages if you trigger them in Liquid or apps.
Running headless? You can still rely solely on the Customer Event.
Just ensure the embed remains enabled for Online Store sales channel
themes so metafields stay in sync.
12. Validating data
GA4 DebugView
Turn on Enable Debug Mode, open DebugView, then browse your storefront. Events should appear under “Most recent events” with full parameters.
GA4 Realtime
Switch Debug Mode off once validated, then use Realtime to confirm active users, conversions, and purchase revenue within the last 30 minutes.
Shopify Customer Events
Shopify Admin → Settings → Customer events → WeltPixel GA4 Tracking Pixel. Ensure it shows Active and the date matches your last save.
Browser console
Enable “Log payloads to console,” open DevTools (⌥⌘I), and look
for [WeltPixel GA4] Payload. You can copy the JSON
into GA4’s Measurement Protocol debugger if needed.
13. Troubleshooting
Problem
Measurement ID rejected
Solution
Copy the code again from GA4 (Admin → Data Streams) and make sure it starts with “G-” and uses only letters/numbers.
Problem
No events in GA4
Solution
Confirm the app embed is enabled, “Enable Pixel Tracking” is on, then browse your store with GA4 DebugView open.
Problem
Warning about syncing
Solution
Open Shopify Settings → Customer events once to clear the banner, then return to the app and click Save again.
Problem
Duplicate purchases
Solution
Remove legacy GA or theme scripts that also fire purchase events—the WeltPixel app already reports them.
Problem
Consent mismatch
Solution
Set both consent dropdowns to “Denied” until your CMP reports opt-in; GA4 immediately reflects that choice.
If you change event toggles but do not click Save on GA4 Settings,
Shopify still uses the previous measurement ID/API secret. Always save
configurations after bulk edits so everything stays aligned.
14. FAQ & support
Does this work with Online Store 2.0 themes?
Absolutely. Enable the “WeltPixel GA4” app embed and you’re done—no theme code edits needed.
How do I verify tracking?
Use GA4 DebugView or Realtime after enabling debug mode, and keep “Log payloads to console” on while testing.
Do I need to re-enable the theme embed?
If you publish a new theme, open Online Store → Customize and re-enable the WeltPixel GA4 app embed for that theme.
How do I contact support?
Email [email protected] or open Shopify Admin → Apps → WeltPixel GA4 Tracking Pixel → Get support.
