Scripts
How the Zappush tracker and gate scripts load, the URL shape of each, and where to copy the exact snippet for your store.
Zappush serves two small scripts. The tracker captures shopper events on your store, and is the same script across every route in your store: install it once and it works everywhere. The gate runs on a compliant page and hands visitors off to your store while carrying their identity across; it stays specific to the route it belongs to. Either way, the snippet you copy from the dashboard already contains the right key.
The tracker script
The tracker loads on your store's pages and records events like page views,
product views, cart actions, and checkouts. Its URL looks like this, with your
own key in place of your-key:
<script src="https://api.zappush.com/s/your-key.js" defer></script>The defer attribute lets the page finish parsing before the script runs, so it
never blocks rendering. The dashboard install snippet also wraps this loader with
a small inline block that buffers events fired before the script loads. Copy the
exact snippet from Settings → Install in the dashboard rather than the example
above, since the key is unique to your store.
Full install instructions, including where to paste the snippet for Shopify, WordPress, and custom sites, are in Install the tracker.
The gate script
The gate script powers a compliant page. It is served at the same host but under
the /g/ path:
<script src="https://api.zappush.com/g/your-key.js" defer></script>Like the tracker, the gate loads with defer. You normally do not paste this by
hand. Copy the exact snippet from the route's Install panel in the dashboard,
since the key identifies which route the gate belongs to.
What the scripts configure
You do not configure the scripts in the page. Zappush bakes everything they need into the file it serves for your key: the ingestion key that ties events to your store, the API endpoint to send events to, and route attribution for compliant pages. The tracker script is the same across every route in your store, so there is nothing to set in the snippet beyond the key in the URL; the gate script stays specific to the route that issued its key.
Always copy the snippet from the dashboard. A snippet copied from somewhere else will send events to the wrong place or fail to load.
If your store is paused or still being set up, the script returns a harmless placeholder that logs a short status message and captures nothing. It is replaced automatically once your store is active, with no change needed on your side.