Instalação
Coloque o Converlay em funcionamento na sua loja Shopify em menos de 5 minutos. Sem alterações de código necessárias.
Pré-requisitos
- Uma loja Shopify ativa (qualquer plano)
- Acesso de administrador à sua loja Shopify
- Pelo menos um destino pronto (ex.: um Measurement ID do GA4 ou um Pixel ID do Meta)
Passo 1: Instale pela Shopify App Store
- Acesse a página do Converlay na Shopify App Store
- Clique em Instalar
- Revise as permissões solicitadas e clique em Instalar app
Permissões solicitadas
O Converlay solicita os seguintes escopos durante a instalação:
| Escopo | Finalidade |
|---|---|
read_pixels, write_pixels | Instalar e gerenciar o pixel de rastreamento do Converlay |
read_customer_events | Receber eventos da vitrine e do checkout para encaminhar |
read_orders | Ler o valor e os itens de compras concluídas |
read_customers | Associar compras a cliques em anúncios com e-mail e telefone com hash |
read_products | Incluir detalhes de produtos nos payloads de eventos |
read_analytics | Comparar os totais da própria Shopify com o que foi entregue |
Por que o Converlay precisa de cada permissão
Em termos simples — o que cada permissão permite ao Converlay fazer, por que é necessária e para que ela nunca é usada.
read_pixels, write_pixels
- O que acessa: Permite que o Converlay adicione seu pixel aos Eventos de clientes da sua loja e o mantenha atualizado.
- Por que é necessária: É isso que captura os eventos da vitrine — sem edições de tema ou código da sua parte.
- Não é usada para: Ele toca apenas no pixel do Converlay, nunca no seu tema, em outros apps ou nas configurações da loja.
read_customer_events
- O que acessa: Recebe os eventos que o pixel da Shopify emite — visualizações de página, adições ao carrinho, checkout e compras.
- Por que é necessária: Esses eventos são as conversões que o Converlay encaminha server-side aos seus destinos.
- Não é usada para: Criar perfis de clientes ou rastrear pessoas em outras lojas.
read_orders
- O que acessa: Lê o valor, a moeda e os itens de pedidos concluídos.
- Por que é necessária: As plataformas de anúncios precisam do valor e do conteúdo exatos do pedido para atribuir receita e otimizar campanhas.
- Não é usada para: Envio, edição de pedidos ou pagamentos — o Converlay nunca vê dados de cartão ou bancários.
read_customers
- O que acessa: Lê o e-mail e o telefone associados a um pedido.
- Por que é necessária: Plataformas como Meta e Google associam uma compra ao clique em anúncio que a gerou usando dados de contato com hash, que o Converlay aplica com SHA-256 antes de saírem do seu servidor.
- Não é usada para: Enviar e-mails ou marketing aos seus clientes, ou enviar dados pessoais brutos para qualquer lugar.
read_products
- O que acessa: Lê os nomes, IDs e preços dos produtos referenciados em um evento.
- Por que é necessária: Os destinos que alimentam anúncios de catálogo e dinâmicos precisam dos detalhes dos produtos no payload.
- Não é usada para: Editar seu catálogo, preços ou estoque.
read_analytics
- O que acessa: Lê os totais agregados de vendas da sua loja — não os registros individuais de clientes.
- Por que é necessária: A verificação de saúde do rastreamento do Converlay compara o que a Shopify registrou com o que cada destino recebeu, para que você possa identificar lacunas.
- Não é usada para: Qualquer coisa que identifique um cliente individual.
Passo 2: Conecte um destino
Após a instalação, você será levado ao painel do Converlay. Navegue até Configuração e insira as credenciais do seu destino. Consulte o guia de destinos para instruções detalhadas por plataforma.
Passo 3: Verifique se o pixel está conectado
- No seu Admin Shopify, vá em Configurações → Eventos de clientes
- Encontre Converlay na lista de pixels
- Confirme que o status mostra Conectado
Teste seu pixel
Clique no menu de três pontos ao lado do pixel Converlay e selecione Testar. O testador de pixel integrado da Shopify será aberto — navegue pela sua vitrine e verifique se os eventos disparam em tempo real.