Storesynk fires the standard storefront events (page view, product view, add to cart, remove from cart, checkout) to the pixels on your page, with consent enforced through Shopify’s Customer Privacy API. With the Storesynk AI app, the same events can also go server-side to Meta Conversions API and GA4 Measurement Protocol. Needs: the engine for client pixels; the app’s Integrations page for server-side.
Client-side pixels
Section titled “Client-side pixels”Add track-events to the store. The pixels module loads on demand and fires to every onsite pixel it detects: Meta, Google, TikTok, Pinterest, Reddit, Klaviyo. Pin an allow-list with track-client if you also fire events yourself.
<storesynk-store domain="your-store.myshopify.com" token="your-public-storefront-token" track-events track-client="meta,ga"></storesynk-store>Consent is automatic: events wait for the Customer Privacy API’s answer. If your jurisdiction needs a banner, install one (Shopify’s or your own); the engine only reads the result.
Server-side events
Section titled “Server-side events”- In the Storesynk AI app, open Integrations and connect Meta (pixel id plus Conversions API token) or GA4 (measurement id plus API secret).
- Add
track-servernaming the providers the relay should handle:
<storesynk-store domain="your-store.myshopify.com" token="your-public-storefront-token" track-events track-server="meta,ga"></storesynk-store>The engine sends a beacon per event to the Storesynk relay, which makes the real Meta and GA4 calls from the config stored in the app. Meta deduplicates client and server events by a shared event id, so it may run both ways. GA4 cannot deduplicate, so ga in track-server turns its client pixel off.
Purchase events are not forwarded yet; the relay covers the funnel up to checkout.
Options
Section titled “Options”Attribute on storesynk-store | What it does |
|---|---|
track-events | Loads the pixels module. Required for everything else here. |
track-client | Comma-separated allow-list of client pixels. Absent means all detected pixels run. |
track-server | Comma-separated providers forwarded through the relay: meta, ga. |
relay-endpoint | Override the relay URL when self-hosting the relay. |
Provider names: meta, ga, tiktok, pinterest, reddit, klaviyo. The same settings can live in the central config block as pixels: { enabled, client, server, relayEndpoint }.