Shopiens on your Shopify store.

Install the snippet on every page

Paste the tracking snippet into your storefront's root layout or template, on every page, not just one.

If Shopify creates your orders

The common case, even with a custom frontend. Whenever you build or update the cart, give it a Shopify cart custom attribute named _shopiens holding the value of the visitor's _shopiens cookie, via the Storefront API's cartAttributesUpdate mutation (cartCreate takes the same list). That mutation replaces the cart's whole list of attributes, so send every attribute the cart should keep, yours included, and add _shopiens only while the cookie exists. Leaving it out removes it from the cart; an empty value would stay on the cart as an empty attribute.

mutation cartAttributesUpdate($cartId: ID!, $attributes: [AttributeInput!]!) {
  cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {
    cart { id }
    userErrors { field message }
  }
}

# variables: the cart's other attributes, then _shopiens while the cookie exists
{
  "cartId": "YOUR_CART_ID",
  "attributes": [
    { "key": "gift_note", "value": "AN_ATTRIBUTE_OF_YOUR_OWN" },
    { "key": "_shopiens", "value": "VALUE_OF_THE_SHOPIENS_COOKIE" }
  ]
}

To build that list in the browser, read the cookie itself, never session storage, where consent mode keeps the visitor id while it has no consent. Pass this the attributes the cart should keep, the cart's current ones for example: it drops any earlier _shopiens, and an _evarist left by an older version of this code, then adds the cookie's value back only if the cookie is still there.

function withShopiens(attributes) {
  var kept = attributes.filter(function (a) { return a.key !== '_shopiens' && a.key !== '_evarist'; });
  var cookie = document.cookie.match(/(?:^|;\s*)_shopiens=([^;]+)/);
  return cookie ? kept.concat([{ key: '_shopiens', value: cookie[1] }]) : kept;
}

Set this up before? Your code reads the _evarist cookie and writes an _evarist attribute. The visitor id now lives in the _shopiens cookie, and _evarist is deleted, so switch both names to _shopiens: until you do, your orders reach Shopiens without the visitor id. Orders that already carry _evarist are still read.

It rides through to the order, so Shopiens attributes the purchase to the right visitor, no matter where checkout renders. This only carries the anonymous visitor id, never anything about the customer. If you run subscriptions (through Recharge or another subscription app on top of Shopify), setting this attribute is required, not just helpful: in most subscription setups it is carried forward from the first order onto future rebills, which is what lets Shopiens credit each rebill to the channel that originally acquired the subscriber instead of reporting it as unattributed revenue. How much of that carries through depends on the subscription app, so expect good coverage rather than every single rebill.

One timing note: the snippet loads asynchronously, so on a brand-new visit the _shopiens cookie may not exist yet when you first create the cart. Read the cookie fresh at every cart mutation rather than caching it at page load, and have the handler that sends the shopper to checkout write the attributes one last time, so a cart created before the snippet finished loading still picks the value up, and a cart whose cookie has since gone loses it. The value present at checkout is the one that rides through; a cart without it simply shows as an unattributed order, nothing breaks.

Consent. With consent mode, the cookie carries the visitor's choice: Shopiens sets no _shopiens cookie until you signal that the visitor consented, and deletes it when you signal a withdrawal. So nothing reaches the cart before consent, and the last write before checkout removes a value written before a withdrawal. Use consent mode if your storefront must set no identifying cookie before consent. Without it, the snippet sets its cookie as soon as it loads, so load the snippet only after the visitor accepts analytics; a withdrawal then leaves the cookie in place until you delete it.