Integrações e Ads2 de setembro de 2026 2 min de leitura

Como instalar o pixel da Escalafy no Shopify

A instalação completa, passo a passo: habilitar o App Embed no seu tema, criar o pixel de checkout e deixar tudo pronto para ativar o envio de eventos.

A instalação do pixel tem quatro passos dentro da Escalafy. Os dois primeiros deixam o pixel capturando eventos, o terceiro evita contagem dupla e o quarto ativa o envio.

Este guia é para lojas Shopify. O pixel também funciona com a Nuvemshop: se a sua loja está lá, fale com a gente pelo WhatsApp e deixamos instalado junto com você.

Passo 1 — Instalar o App Embed no seu tema

Pela Escalafy, habilite o App Embed da Escalafy no Shopify. Dois detalhes que fazem este passo falhar:

  • Precisa ficar habilitado no seu tema publicado, não em um rascunho.
  • É preciso clicar em "Salvar" dentro do Shopify. Sem salvar, a Escalafy não detecta.

Passo 2 — Criar o pixel de Checkout

Esse pixel captura os eventos do checkout: início, dados de pagamento e compra.

  1. Clique em "Criar pixel no Shopify". Você vai para Configurações → Eventos de clientes. Lá, clique em "Adicionar pixel personalizado" e nomeie como Escalafy.
  2. Em "Permissão" marque a primeira opção: "Não obrigatório". Em "Venda de dados" marque "Não se qualifica como venda de dados".
  3. Cole este código no editor do 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) {});
})();
  1. Clique em "Salvar" e depois em "Conectar". Volte para a Escalafy e marque o passo como feito.

Passo 3 — Remover o tracking anterior

Este passo não é opcional: se deixar os pixels antigos, cada venda é contada duas vezes e seus números ficam inflados. Explicamos em detalhe aqui: Como remover o tracking anterior da sua loja.

Passo 4 — Resumo e ativação

A Escalafy mostra um resumo com os três pontos: App Embed habilitado, pixel de checkout criado e scripts antigos removidos. Dali você ativa o envio de eventos, ou entra em modo de teste para validar antes.

Não encontrou o que procurava?Fale com o time

Pare de operar no escuro.Resultados reais, em tempo real.

Você conecta em minutos. A Escalafy te diz se ganha ou perde dinheiro — hoje, não no fim do mês.

Teste 7 dias · Sem cartão · Cancele quando quiser