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 four things:

• It sets up Tapper's tracking on your storefront, with no theme editing.
• It connects your order and refund data, so Tapper can measure what your ad spend actually earned, including money that came back as refunds.
• It reads your order history, so Tapper Vantage can learn from your past orders instead of waiting months for new ones.
• It gives Tapper read access to your products and inventory, for the product checks in Tapper Lift.

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.

If your install link is on file with us, Tapper shows it too. In Tapper, open Setup > Website, then Monitoring, and the Install script and consent tab. Under Conversion script, select the Shopify tab. It shows an Install on button for your store, which opens the same link. The button is removed once the link has expired.

Shopify asks you to approve read access to four things. Every permission is read only, so the app never changes your products, orders, or settings. On your storefront, Tapper's tracking adds its visitor ID to the shopper's cart as a hidden cart attribute, when the visitor's consent allows it.

We do not request access to your customer records, your pixels, or your store settings, and we never request permission to edit anything.

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

Then confirm the connection

In Tapper, open Setup > Website, then Monitoring, and the Install script and consent tab. Under Conversion script, select the Shopify tab. Its second step, check the connection, shows a button for your store.

• If it reads Check connection, click it and approve the screen Shopify shows. That approval also lets Tapper read your order history and your catalog.
• If it already reads Connected, there is nothing to click, and your new orders are connected. Your order history and your catalog need one more step, so contact us and we'll finish connecting them.

Once the store is connected, the button reads Connected, and the line under it shows your store's domain followed by order tracking is active.

Already installed? Approve the new access

Stores that installed Tapper earlier keep exactly the access they approved at the time. Nothing breaks: Tapper keeps receiving your orders and refunds as before. Two kinds of access were added since, and one approval covers both:

• All orders: your order history beyond the last 60 days.
• Products and inventory: your products, prices and stock levels, for the product checks in Tapper Lift.

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. Then check that visitor activity appears in Tapper.

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 does not let an app add a custom pixel for you, and Tapper's checkout code only runs in a custom pixel. That is why it is not part of the app you just installed. It has to be pasted here, by you, once.

The snippet is on the same Shopify tab in Tapper, in its third step, add the checkout pixel. The copy there already contains your tracking ID.

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 behavior, 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

The order fields listed in Step 1. Refunds and cancellations too, which is what lets Tapper correct a sale that was later returned rather than counting it forever.

From your order history, once you approve it

The same order details for your past orders, up to 24 months back, except order tags, cart attributes and referring pages, which Tapper does not read for past orders.

From your catalog, once you approve it

Read access to your products and variants (including prices), your stock levels and the unit cost recorded for each product. Tapper Lift's product checks use it.

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: go to Settings > Apps and sales channels, find Tapper, and click Uninstall. This stops order data immediately and revokes our access, including product and inventory access. It also removes the storefront tracking, since the theme block belongs to the app.
2. The checkout pixel: go to 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