Cómo instalar el pixel de Escalafy en Shopify

La instalación del pixel tiene cuatro pasos dentro de Escalafy. Los primeros dos dejan el pixel capturando eventos, el tercero evita que se cuenten dos veces y el cuarto lo activa.

Paso 1 — Instalar el App Embed en tu tema

Desde Escalafy, habilita el App Embed de Escalafy en Shopify. Dos cosas que hacen fallar este paso:

• Tiene que quedar habilitado en tu tema publicado, no en un borrador.
• Hay que hacer clic en "Guardar" dentro de Shopify. Si no guardas, Escalafy no lo detecta.

Cuando esté listo, Escalafy lo marca como "Instalado en el tema publicado". Si sigue apareciendo como no detectado, vuelve a habilitarlo y guarda de nuevo.

Paso 2 — Crear el pixel de Checkout

Este pixel captura los eventos del checkout: inicio, datos de pago y compra.

1. Haz clic en "Crear pixel en Shopify". Te lleva a Configuración → Eventos de clientes. Ahí, clic en "Agregar pixel personalizado" y nómbralo Escalafy.
2. En "Permiso" marca la primera opción: "No requerido". En "Venta de datos" marca "No califica como venta de datos".
3. Pega este código en el editor del pixel:

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. Haz clic en "Guardar" y después en "Conectar". Vuelve a Escalafy y marca el paso como hecho.

Paso 3 — Eliminar el tracking anterior

Este paso no es opcional: si dejas los pixels viejos, cada venta se cuenta dos veces y tus números quedan inflados. Lo explicamos en detalle acá: Cómo eliminar el tracking anterior de tu tienda.

Paso 4 — Resumen y activación

Escalafy te muestra un resumen con los tres puntos: App Embed habilitado, pixel de checkout creado y scripts antiguos eliminados. Desde ahí activas el envío de eventos, o entras en modo de prueba para validar antes.

¿Instalado pero los eventos no aparecen?

Si el App Embed figura como detectado y aun así no ves los eventos como esperabas, escríbenos por WhatsApp y lo revisamos juntos.