How to install the Escalafy Pixel on Shopify

Installing the pixel takes four steps inside Escalafy. The first two get the pixel capturing events, the third keeps them from being counted twice and the fourth turns it on.

Step 1 — Install the App Embed in your theme

From Escalafy, enable the Escalafy App Embed in Shopify. Two things make this step fail:

• It has to be enabled on your published theme, not on a draft.
• You have to click "Save" inside Shopify. If you don't save, Escalafy won't detect it.

Once it's ready, Escalafy marks it as "Installed on the published theme". If it still shows as not detected, enable it again and save again.

Step 2 — Create the Checkout pixel

This pixel captures checkout events: checkout started, payment info and purchase.

1. Click "Create pixel in Shopify". It takes you to Settings → Customer events. There, click "Add custom pixel" and name it Escalafy.
2. Under "Permission" select the first option: "Not required". Under "Data sale" select "Data collected does not qualify as data sale".
3. Paste this code into the pixel editor:

var ESC_ENGINE_URL = "https://p.escalafy.com/shopify/checkout-pixel.js";

(function () {
  var buffered = [];
  var handler = function (event) { if (buffered.length < 500) buffered.push(event); };
  analytics.subscribe("all_events", function (event) { handler(event); });

  var shop = (init && init.data && init.data.shop && init.data.shop.myshopifyDomain) || "";
  import(ESC_ENGINE_URL + "?shop=" + encodeURIComponent(shop))
    .then(function (mod) {
      return mod.handler(
        { analytics: analytics, browser: browser, init: init, settings: typeof settings === "undefined" ? {} : settings },
        "CUSTOM"
      );
    })
    .then(function (dispatch) {
      if (!dispatch) return;
      handler = dispatch;
      var early = buffered;
      buffered = [];
      early.forEach(function (event) { try { dispatch(event); } catch (e) {} });
    })
    .catch(function (e) {});
})();

4. Click "Save" and then "Connect". Go back to Escalafy and mark the step as done.

Step 3 — Remove your old tracking

This step is not optional: if you leave the old pixels in place, every sale gets counted twice and your numbers end up inflated. We explain it in detail here: How to remove old tracking from your store.

Step 4 — Summary and activation

Escalafy shows you a summary with the three checkpoints: App Embed enabled, checkout pixel created and old scripts removed. From there you turn on event sending, or switch to test mode to validate first.

Installed but events aren't showing up?

If the App Embed shows as detected and you still don't see events the way you expected, message us on WhatsApp and we'll go through it together.