Install the Tapper Shopify App

The Tapper Shopify app is installed from a private link we send you. It is not listed in the Shopify App Store, and the link works only for the store it was generated for.

Installing it does two things: it sets up Tapper's tracking on your storefront with no theme editing, and it connects your order and refund data so Tapper can measure what your ad spend actually earned - including money that came back as refunds.

Installing the app is not the whole setup

There are three things to do, and the install link only covers the first:

Each takes about a minute, and you only do them once.

Before You Start

Step 1: Open the Install Link

Open the link we sent you while signed in to your Shopify admin. Shopify shows an installation screen naming the app and listing what it will be allowed to access.

Shopify asks for one permission:

We do not request access to your customer records, your products, your pixels, or your store settings.

Click Install. You'll land back in your Shopify admin a few seconds later.

Then confirm the connection

In your Tapper dashboard, open the protected website, go to the Website monitoring tab, select the Shopify tab and click Check connection.

This finishes connecting your order data. Installing the app on its own is not always enough - this step is what lets Tapper read your order history, so do it once after installing.

Step 2: Turn On Storefront Tracking

The app adds a Tapper block to your theme. You enable it once:

Step 3: Check Storefront Tracking Works

Open your store in a browser and browse a product page. Within a few minutes, visitor activity appears in your Tapper dashboard under the matching protected website.

Step 4: Add the Checkout Pixel - required

This is the step people miss. It is separate from installing the app and separate from the theme embed, and without it Tapper never sees a purchase.

Shopify's checkout runs in a sandbox that no app is permitted to write to, which is why it cannot be bundled into the app you just installed. It has to be pasted here, by you, once.

var script = document.createElement("script");
script.src = "https://monitor.tapper.ai/bundle.js";
script.async = true;
script.onload = function () {
  window.tapper.init("YOUR_TRACKING_ID", { ecommerce: "shopify-sandbox", analytics: analytics });
};
document.head.appendChild(script);

Step 5: Confirm Everything Is Connected

What Tapper Receives

From your storefront - page views, product views, add-to-cart and browsing behaviour, so we can tell real shoppers from bots and other invalid traffic.

From your checkout - checkout steps and purchases, via the pixel you added in Step 4.

From your orders - order ID and number, totals, currency, payment status, and the timestamps Shopify records. Refunds and cancellations too, which is what lets Tapper correct a sale that was later returned rather than counting it forever.

What Tapper never receives - customer names, email addresses, phone numbers, billing and shipping addresses. These are excluded before Shopify sends anything.

Removing Tapper

Two things to undo, because they're installed separately:

1. The app - Settings → Apps and sales channels, find Tapper, click Uninstall. This stops order data immediately and revokes our access; it also removes the storefront tracking, since the theme block belongs to the app.
2. The checkout pixel - Settings → Customer events, open your Tapper pixel and disconnect or delete it. Uninstalling the app does not remove this, because you created it yourself.

Troubleshooting