Conectar o Snap Pixel e a Conversions API ao cPixel
Como conectar o Snapchat ao cPixel?
No Snapchat Ads Manager, abra o Events Manager, depois o seu Snap Pixel em Event Sources: o Pixel ID é exibido abaixo do nome, hífens incluídos. Para o token, escolha Set Up Conversions API, depois Manual Setup. Cole os dois no cPixel, que dispara o Snap Pixel na sua loja Shopify e envia checkouts, a etapa de pagamento e compras pelos seus servidores.
Cole-os no cPixel
- No cPixel, abra Destinos e clique no ícone do Snapchat em Conectar uma plataforma. Configurar Snapchat abre em Cole seus IDs.
- Preencha ID do Snap Pixel e Token de acesso da Conversions API, ambos obrigatórios. A dica cinza acima deles, que diz que as compras não são rastreadas, é anterior à conexão de servidor do cPixel com o Snapchat. Se quiser, dê um nome à conta em Dê um nome a esta conta (opcional).
- Clique em Testar conexão: o Snapchat verifica o token em relação ao seu pixel sem registrar um evento, confirmando o acesso, não a entrega.
- Clique em Continuar. Em Escolha as opções, mantenha Enviar eventos pelo navegador e Enviar eventos pelos nossos servidores marcados. Mantenha Não — o cPixel cuida do Snapchat (recomendado) a menos que outra ferramenta envie para este pixel: apesar do nome, Sim — mantenha-o, e o cPixel para de enviar o Snapchat pelo servidor interrompe os envios do cPixel pelo navegador e pelo servidor para ele.
- Clique em Salvar e continuar. Teste confirma Snapchat está conectado.
Importante: O próprio app da Shopify do Snapchat, Snapchat Ads, também envia para um Snap Pixel (Snapchat), então mantenha um remetente por pixel.
Onde encontro o ID do meu Snap Pixel?
Abaixo do nome do seu pixel no Events Manager do Snapchat: um UUID de cinco grupos de letras e dígitos unidos por hífens, como xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- No Snapchat Ads Manager, abra o menu no canto superior esquerdo (Create Ads ou Manage Ads, dependendo de onde você chegou) e escolha Events Manager.
- Em Event Sources, na barra lateral esquerda, abra o seu Snap Pixel. Se a conta não tiver nenhum, use New Event Source.
- Copie o ID exibido abaixo do nome do pixel, hífens incluídos, no campo ID do Snap Pixel do cPixel. Ele também aparece na barra de endereço, depois de
/events/pixel/.
- O ID da conta de anúncios, também um UUID, é o primeiro na barra de endereço.
- Pule Set Up Snap Pixel: o cPixel carrega o Snap Pixel pelo seu app embed, e uma segunda cópia do código do Snapchat poderia contar as visualizações de página em dobro.
Como obtenho um token da Conversions API?
Gere-o no Snapchat Ads Manager, a partir da configuração do próprio pixel ou, como Organization Admin, em Business Details. É obrigatório.
A partir do seu Snap Pixel
- Na página do seu pixel, em Send events from a server, clique em Set Up Conversions API.
- Em Set Up Method, escolha Manual Setup, não Partner Integration nem Conversions API Gateway.
- Avance até o fim e clique em Copy Access Token. O Snapchat também mostra o endpoint do token,
https://tr.snapchat.com/v3/<pixel-id>/events, que deve conter o seu Pixel ID.
A partir de Business Details
Este é o caminho indicado pelo próprio guia do Snapchat (Snapchat):
- No Ads Manager, abra o menu no canto superior esquerdo e vá para Business Dashboard → Business Details.
- Em Conversions API Tokens, clique em Generate Token e copie-o.
A Snap diz que esses tokens não expiram e funcionam apenas para pixels da organização que os criou (Snap). O cPixel armazena o seu e nunca mais o exibe.
O que o cPixel envia ao Snapchat?
Eventos da loja a partir do Snap Pixel, carregado pelo app embed do cPixel, e checkouts, a etapa de pagamento e compras pelos servidores do cPixel através da Conversions API do Snapchat (versão 3); cada evento segue apenas um caminho.
PAGE_VIEWeADD_CARTvêm do Snap Pixel, só enquanto o app embed está ativado. Se um navegador bloquear o pixel, o cPixel envia esse evento pelos seus servidores.START_CHECKOUT,ADD_BILLINGePURCHASEvêm dos servidores do cPixel: início do checkout, envio dos dados de pagamento, e a compra, reconstruída a partir do pedido da Shopify, já que nenhum código do tema roda no checkout.
Os eventos do servidor carregam e-mail, telefone e ID de cliente da Shopify com hash quando conhecidos, além do endereço IP e do user agent; o click ID do Snapchat não é capturado. O Snapchat deduplica pelo ID do evento dentro de 48 horas, e as compras também pelo ID do pedido por até 30 dias (Snap).
Nota: A conexão de servidor do cPixel com o Snapchat é nova: em produção desde setembro de 2026, e ainda não confirmada em uma conta de anúncios real. Verifique seu primeiro checkout e compra no Ao vivo.
Como verifico se funcionou?
Acompanhe um checkout e uma compra no Ao vivo do cPixel, onde os envios pelo servidor mostram a resposta do Snapchat, depois confirme no Events Manager do Snapchat.
- No cPixel, abra Ao vivo e clique em Iniciar sessão.
- Navegue pela sua loja em outra aba e adicione algo ao carrinho. As linhas Navegador listam o Snapchat como Enviado do navegador, sem resposta: as plataformas não respondem a envios pelo navegador.
- Inicie um checkout e faça um pedido real; o cPixel ignora pedidos de teste por padrão. As linhas Servidor deles devem mostrar o Snapchat como Aceito.
- No Events Manager, os eventos do servidor aparecem na tela principal marcados como “via Conversions API”; o Snapchat diz que podem levar de 1 a 2 horas para aparecer (Snapchat).
Destinos marca a conta como Verificado após o primeiro envio pelo servidor aceito, geralmente o primeiro checkout. O Events Manager também mostra o próprio Event Quality Score do Snapchat; o cPixel não o lê.
E se não funcionar?
Se o Snapchat não está recebendo os eventos do cPixel, abra a linha do Snapchat no Ao vivo: um envio que não está Aceito indica a causa.
| O que você vê | O que fazer |
|---|---|
| Testar conexão rejeita o token | Copie-o novamente e verifique se ele vem da organização dona do pixel |
| Rejeitado ou Erro | Leia a resposta do Snapchat nos detalhes da linha; o cPixel tenta novamente os erros sozinho |
| Nada chega ao seu pixel | Verifique o Pixel ID: ele pode ter perdido os hífens, ou ser o ID da conta de anúncios |
| Corrigir Snapchat em Início: o token foi rejeitado ou excluído, os envios pelo servidor pararam e um alerta crítico foi enviado por e-mail | Gere um novo token, clique em Corrigir Snapchat, ou em Gerenciar ao lado da conta em Destinos, cole-o e salve |
| Nenhuma linha Navegador menciona o Snapchat | O app embed está desligado (o selo Navegador mostra Precisa do app embed): ative Rastreamento cPixel e salve seu tema, de novo depois de trocar de tema |
| Uma compra está ausente ou Ignorado | Leia o motivo, depois veja compras que não aparecem |
| Visualizações de página ou compras contadas em dobro | Outra ferramenta, como o app Snapchat Ads ou código de pixel no seu tema, envia para este pixel |
Remover, em Gerenciar Snapchat, interrompe os envios para essa conta e apaga seu token.
