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.
- Clique em "Criar pixel no Shopify". Você vai para Configurações → Eventos de clientes. Lá, clique em "Adicionar pixel personalizado" e nomeie como Escalafy.
- 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".
- 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) {});
})();
- 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.