Skip to main
← Index

Install Walityk on Shopify in 3 steps

Step-by-step guide to install Walityk on a Shopify store and start sending events to GA4 and Meta CAPI.

This guide covers installing Walityk on a Shopify store, from first click to events arriving at Meta and GA4. Plan for less than 5 minutes.

1. Install the app

  1. Log into your Shopify admin.
  2. Open the Shopify App Store and search for Walityk.
  3. Click Install, approve the requested permissions (write_script_tags to inject the tag, write_pixels + read_customer_events to capture commerce and checkout events).
  4. You’re redirected to the Walityk dashboard with your store already connected.

No theme edit needed. Walityk deploys two pieces automatically:

  • a tag (page views, scroll, page context) injected via script_tag;
  • a Web Pixel that captures commerce and checkout events (view_item, add_to_cart, begin_checkout, purchase) — the only way to track checkout pages, where script_tags don’t run.

Served first-party. The tag and the collect endpoint are served from your own domain (your-store.com/apps/walityk/…) through the Shopify App Proxy. Result: better adblocker resistance, same-origin requests (no CORS issues), TLS handled by Shopify.

2. Connect marketing destinations

On the Destinations page in the dashboard:

  • GA4: click “Connect”, paste your Measurement ID (G-XXXXXXX) and API secret (Admin → Data Streams → Measurement Protocol API secrets).
  • Meta CAPI: open Meta Events Manager, copy your Pixel ID and generate a Conversions API token (Settings → Conversions API → Generate access token). Paste both into Destinations → Meta. Optional: a Test Event Code to verify delivery without polluting your stats. No Facebook app to create.

Keys are stored encrypted at rest server-side. They never pass through the end-user browser.

3. Verify events arrive

  1. In the dashboard, open Live debug.
  2. In another tab, browse your store: home, product page, add to cart.
  3. Events appear in real time: page_view, view_item, add_to_cart.
  4. On Meta Events Manager → Test events, the event shows up within 30 seconds.
  5. On GA4 → Realtime, users appear immediately.

Not working?

  • No events arriving: check the tag actually loaded (DevTools → Network → search walityk or tft). If missing, the Shopify script_tag hasn’t propagated yet (≤ 1 min after install).
  • Events arrive but Meta doesn’t receive them: open Destinations → Meta and check status. If the CAPI token expired, generate a new one in Events Manager and paste it back.
  • Duplicate events on Meta: make sure you disabled the client-side Pixel in your Shopify theme (otherwise Walityk sends via CAPI and your Pixel sends client-side → duplicates).

Next steps

  • Configure Consent Mode v2 if you use a CMP (Cookiebot, Axeptio, Didomi).
  • Enable Google Ads conversions if running SEA.
  • Explore the visual tag plan to add custom events (newsletter, lead form, etc.).

Need help? Write to hi@walityk.com, we reply within 1 business day.