Lifetime Support & Updates Plan for Google Analytics 4 is now available

One less subscription to manage! Grab a LIFETIME Support & Updates Plan and gain access to lifetime free updates, Priority Support & a dedicated Slack Channel. Get it at 10% OFF with discount code UPDATES10

Grab Lifetime
Toggle Nav
Menu
Account
My Cart
Loading...

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.

Start Setup Need help?
  • 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
Main feature image for the WeltPixel Shopify GA4 Tracking Pixel

Contents

Jump to the part of the guide that answers your question fastest.

01

Overview

What the app does for your store.

 02

How it works

See how the admin, pixel, and embed connect.

 03

Requirements

Everything to have ready before setup.

 04

Quick start

Five steps to go live in minutes.

 05

GA4 settings

Break down of every option on the Settings page.

 06

Event toggles

Choose which GA4 events stay active.

 07

Consent

Match tracking to your privacy program.

 08

Theme embed

Enable the storefront app block.

 09

Validation

Ways to confirm GA4 is capturing data.

 10

Fix issues

Simple answers for common blockers.

 11

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

Remix Admin

Enter your GA4 details once and the app keeps Shopify and Google in step, so every change is shared automatically.

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

  1. Install & open the app. Approve requested scopes so the app can write Customer Events and metafields.
  2. Enable the theme app embed. Shopify Admin → Online Store → Themes → Customize → App embeds → toggle on “WeltPixel GA4”.
  3. Enter GA4 credentials. In GA4 Settings, add your Measurement ID and API secret, keep “Enable Pixel Tracking” on, then click Save.
  4. Choose events. On Event Toggles, enable or disable the 11 GA4 events to match your compliance rules.
  5. 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.

Log payloads

Need to peek behind the scenes? Toggle this on and open your browser console to see each event payload.

Consent controls

Match Ad User Data and Ad Personalization to your CMP decision (Granted or Denied) so GA4 honors customer choices.

Tap Save any time you make a change—the app refreshes your storefront tracking within a few seconds.

6. 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.

Enable All Disable All
Event Description
page_view Storefront Tracks every storefront page view, including the full URL, title, and referrer.
view_item Storefront Sends product, variant, price, and currency when shoppers open a product page.
view_item_list Storefront Captures collection grids and search result lists with list name and product order.
add_to_cart Storefront Records every add to cart along with quantity, value, and currency.
remove_from_cart Storefront Keeps GA4 cart quantities accurate when shoppers remove or reduce items.
view_cart Storefront Sends the full cart snapshot (items, value, currency) each time the cart page opens.
begin_checkout Checkout Fires when checkout starts, carrying the token, cart value, and coupon codes.
add_shipping_info Checkout Captures shipping step actions, including the shipping tier and line items.
add_payment_info Checkout Notes when payment details are submitted so you can monitor funnel drop-off.
purchase Checkout GA4-ready purchase events with order ID, customer info, items, tax, shipping, and coupons.
search Storefront Tracks storefront search terms and also mirrors the related product impressions.
Tip: Turning every toggle off pauses GA4 tracking until you switch at least one event back on.

8. Theme app embed

  1. Go to Online Store → Themes → Customize.
  2. Select your live theme, then open the App embeds panel.
  3. Toggle WeltPixel GA4 to “On”.
  4. 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.js with your Measurement ID.
  • Relays custom weltpixel-ga4-event messages 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.

9. 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.

10. 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.

11. 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.

Email address is required to login
Recently Viewed
No recently views items
Clear All
Newsletter Fashion Box
How about a gift?