Shopify

Visits: the script in your theme

1. In Shopify, open Online Store › Themes, click … next to your theme and choose Edit code.
2. Open layout/theme.liquid and paste your site’s line from Settings › Installation in Nvivio just above </head>:

<script defer src="https://nviv.io/js/NV-XXXXXXX.js"></script>

3. Save. Nvivio’s installation page says “It works” as soon as the first visit arrives.

Add every domain your shop is reached on to the site in Nvivio, under Settings › Domains: your own domain and, if customers see it, yourshop.myshopify.com (Domains).

Purchases: a custom pixel

Shopify’s checkout does not run the scripts of your theme. A custom pixel does run there, and counts each completed order as the event purchase, with its total and currency (Revenue).

1. In Shopify, open Settings › Customer events and click Add custom pixel. Name it Nvivio.
2. Paste the code below and replace NV-XXXXXXX with your site code.
3. Under Customer privacy, choose what fits your own consent policy. Nvivio without cookies stores no personal data and needs no consent (Privacy and GDPR).
4. Click Save, then Connect.

// Nvivio: every completed order as the event purchase, with its total and currency.
const SITE = 'NV-XXXXXXX';

analytics.subscribe('checkout_completed', (event) => {
  const checkout = event.data.checkout;
  fetch('https://nviv.io/e', {
    method: 'POST',
    keepalive: true,
    body: JSON.stringify({
      s: SITE,
      n: 'purchase',
      // A fixed address: the checkout's own address carries its token, which stays with Shopify.
      u: event.context.document.location.origin + '/checkout/thank-you',
      p: { revenue: { amount: checkout.totalPrice.amount, currency: checkout.currencyCode } }
    })
  });
});

• Only the total and its currency are sent: never the order number, the products or the customer.
• The purchase belongs to the visit it ended, so revenue shows per source, campaign, page and country. Without cookies, Nvivio recognises the same browser on the same day; in cookie mode the pixel cannot read the cookie, so a purchase may start a visit of its own.
• The total includes tax and shipping, in the currency the customer paid in; Nvivio shows it in your site’s currency. To leave out tax, send checkout.subtotalPrice.amount instead.
• Make a goal of the event purchase to see its conversion rate and revenue per goal (Goals and funnels).