Como o Pixel Funciona
O Converlay utiliza a Web Pixels API da Shopify para capturar eventos da vitrine. O pixel roda dentro de um iframe em sandbox gerenciado inteiramente pela Shopify, garantindo zero impacto no desempenho da sua loja.
Execução em sandbox
A Shopify carrega pixels personalizados em um sandbox isolado. Isso significa que o pixel não pode acessar o DOM da página principal, cookies ou interferir na sua vitrine. Ele recebe eventos por meio do barramento de eventos da Shopify.
APIs de navegador disponíveis
| API | Disponível |
|---|---|
browser.localStorage | Sim |
browser.cookie | Não |
document.cookie | Não |
window.localStorage | Não (use browser.localStorage) |
fetch / sendBeacon | Sim |
Dados capturados
Cada payload de evento inclui:
- Client ID — identificador persistente armazenado em
browser.localStorage - Session ID — janela rotativa de 30 minutos, também persistida em localStorage
- Click IDs —
gclid,fbclid,ttclidextraídos da URL da página - Parâmetros UTM —
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Facebook Browser ID —
_fbpgerado a partir do client ID,_fbca partir do fbclid - PII do checkout — e-mail, telefone, nome, endereço (hasheados server-side com SHA-256 antes do encaminhamento)
- Estado de consentimento — mapeado da Customer Privacy API da Shopify para sinais do Google Consent Mode v2
Transporte
Os eventos são enviados para o endpoint de coleta do Converlay usando navigator.sendBeacon para confiabilidade durante descarregamentos de página. Se o sendBeacon não estiver disponível, o pixel utiliza uma requisição fetch POST padrão como fallback.
Persistência
O Client ID e o Session ID são armazenados em browser.localStorage. Se o localStorage não estiver disponível (ex.: em alguns navegadores focados em privacidade), o pixel utiliza armazenamento em memória como fallback. Os IDs serão regenerados a cada carregamento de página nesse caso.
Versionamento do pixel
Cada implantação do pixel inclui um número de versão e um hash de commit. Você pode verificar a versão em execução no seu painel do Converlay ou no console do navegador buscando por entradas de log [Converlay].
Cache
A Shopify faz cache agressivo do código do web pixel. Após implantar uma nova versão do pixel, as lojas devem desconectar e reconectar o pixel em Configurações → Eventos de clientes para que as alterações de código entrem em vigor. Alterações de configuração podem ser enviadas remotamente via o atualizador em massa.