Waverunner
Browse the docs

Install on Shopify

Part of Waverunner’s always-on, site-measured performance stack. Shopify takes two small steps: the snippet in your theme covers your storefront pages, and a customer-events pixel covers checkout, where Shopify doesn't allow theme scripts to run.

First, copy your snippet

Your snippet is one line of code that looks like this, with YOUR_SITE_TOKEN replaced by a code that is unique to your website:

<script async src="https://waverunner.adwave.com/t/YOUR_SITE_TOKEN"></script>

Get the real one from your Waverunner account: sign in to copy your site's snippet. You'll land on the Tracking page, which shows your personalized snippet with a Copy snippet button. Each website (business) in your account has its own snippet. If you run more than one site, pick the right one with the switcher at the top of the page. Copy it there, then follow the steps below.

Don't copy the example above: it contains a placeholder instead of your real site token, so nothing would be recorded.

Add the snippet to your theme

  1. In your Shopify admin, go to Online Store → Themes.
  2. On your current theme, click the ⋯ button (three dots), then Edit code.
  3. In the file list on the left, under Layout, click theme.liquid.
  4. Find the line that says </head> (usually within the first 30–50 lines. You can press Ctrl/Cmd + F to search).
  5. Paste your snippet on its own line, just above </head>.
  6. Click Save. The change is live immediately.
Nervous about editing theme code? Duplicate your theme first (⋯ → Duplicate) so you have a backup, or copy the snippet and send it to whoever manages your store. It's a one-line change.

Cover checkout with the customer-events pixel

Shopify does not run theme scripts on its checkout and thank-you pages, so the snippet alone can't see purchases. Waverunner provides a ready-made customer-events pixel that reports each completed checkout with its exact order value, counted once per order:

  1. Open the Tracking page in Waverunner and find the Shopifytab under "Connect your store or tools". Copy the pixel code there.
  2. In your Shopify admin, go to Settings → Customer events.
  3. Click Add custom pixel, name it Waverunner, and paste the code.
  4. Click Save, then Connect.

Check that it's working

  1. Open your website in a new browser tab and load any page. For the checkout pixel, a test order (or your next real order) is what confirms purchases are flowing.
  2. Go back to the Tracking page in Waverunner (you'll be asked to sign in if you aren't already). The banner at the top turns green on its own the moment your first visit arrives, usually within a few seconds. No need to reload the page.

If the banner stays amber after a minute, re-check the steps above: the most common causes are pasting the example snippet instead of your personalized one, or forgetting to save or publish the change.