Ligar o Snap Pixel e a Conversions API ao cPixel

Como ligo o Snapchat ao cPixel?

No Snapchat Ads Manager, abra Events Manager, depois o seu Snap Pixel em Event Sources: o Pixel ID está impresso sob o seu nome, traços incluídos. Para o token, escolha Set Up Conversions API, depois Manual Setup. Cole ambos no cPixel, que dispara o Snap Pixel na sua loja Shopify e envia checkouts, o passo de pagamento e compras a partir dos seus servidores.

Cole-os no cPixel

1. No cPixel, abra Destinos e clique no ícone do Snapchat em Ligar uma plataforma. Configurar Snapchat abre em Cole os seus IDs.
2. Preencha ID do Snap Pixel e Token de acesso da Conversions API, ambos obrigatórios. A dica cinzenta acima deles, que diz que as compras não são rastreadas, é anterior à ligação de servidor do Snapchat do cPixel. Dê um nome à conta em Dê um nome a esta conta (opcional) se quiser.
3. Clique em Testar ligação: o Snapchat verifica o token contra o seu pixel sem registar um evento, confirmando o acesso, não a entrega.
4. Clique em Continuar. Em Escolha as opções, mantenha Enviar eventos a partir do navegador e Enviar eventos a partir dos nossos servidores marcados. Mantenha Não — o cPixel trata do Snapchat (recomendado) a menos que outra ferramenta envie para este pixel: apesar do seu nome, Sim — mantenha-a, e o cPixel deixa de enviar para o Snapchat do lado do servidor para os envios do navegador e do servidor do cPixel para ele.
5. Clique em Guardar e continuar. Testar confirma que Snapchat está ligado.

Importante: A própria aplicação Shopify do Snapchat, Snapchat Ads, também envia para um Snap Pixel (Snapchat), por isso mantenha um emissor por pixel.

Onde encontro o meu ID do Snap Pixel?

Sob o nome do seu pixel no Events Manager do Snapchat: um UUID de cinco grupos de letras e dígitos unidos por traços, como xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

1. No Snapchat Ads Manager, abra o menu no canto superior esquerdo (Create Ads ou Manage Ads, conforme onde caiu) e escolha Events Manager.
2. Em Event Sources na barra lateral esquerda, abra o seu Snap Pixel. Se a conta não tiver nenhum, use New Event Source.
3. Copie o ID impresso sob o nome do pixel, traços incluídos, para o campo ID do Snap Pixel do cPixel. Também está 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.
• Salte Set Up Snap Pixel: o cPixel carrega o Snap Pixel através do seu app embed, e uma segunda cópia do código do Snapchat poderia contar visualizações de página duas vezes.

Como obtenho um token da Conversions API?

Gere-o no Snapchat Ads Manager, a partir da própria configuração do seu pixel ou, como Organization Admin, em Business Details. É obrigatório.

A partir do seu Snap Pixel

1. Na página do seu pixel, em Send events from a server, clique em Set Up Conversions API.
2. Em Set Up Method, escolha Manual Setup, não Partner Integration nem Conversions API Gateway.
3. Avance até ao 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 que o próprio guia do Snapchat dá (Snapchat):

1. No Ads Manager, abra o menu no canto superior esquerdo e vá a Business Dashboard → Business Details.
2. Em Conversions API Tokens, clique em Generate Token e copie-o.

O Snap diz que estes tokens não expiram e só funcionam para pixels na organização que os criou (Snap). O cPixel guarda o seu e nunca o volta a mostrar.

O que envia o cPixel ao Snapchat?

Eventos da loja a partir do Snap Pixel, que o app embed do cPixel carrega, e checkouts, o passo de pagamento e compras dos servidores do cPixel através da Conversions API (versão 3) do Snapchat; cada evento vai numa única direção.

• PAGE_VIEW e ADD_CART vêm do Snap Pixel, só enquanto o app embed está ativado. Se um navegador bloquear o pixel, o cPixel envia esse evento a partir dos seus servidores.
• START_CHECKOUT, ADD_BILLING e PURCHASE vêm dos servidores do cPixel: checkout iniciado, dados de pagamento submetidos, e a compra, reconstruída a partir da encomenda do Shopify, já que nenhum código do tema corre no checkout.

Os envios do servidor levam e-mail, telefone e ID de cliente do Shopify com hash quando conhecidos, mais endereço IP e agente de utilizador; o ID de clique do Snapchat não é capturado. O Snapchat desduplica pelo ID do evento dentro de 48 horas, e as compras também pelo ID de encomenda durante até 30 dias (Snap).

Nota: A ligação de servidor do Snapchat do cPixel é nova: em produção desde setembro de 2026, e ainda não confirmada numa conta de anúncios ativa. Verifique o seu primeiro checkout e compra no Direto.

Como verifico que funcionou?

Observe um checkout e uma compra no Direto do cPixel, onde os envios do servidor mostram a resposta do Snapchat, depois confirme no Events Manager do Snapchat.

1. No cPixel, abra Direto e clique em Iniciar sessão.
2. Navegue na sua loja noutro separador e adicione ao carrinho. As linhas Navegador listam o Snapchat como Enviado do navegador, sem resposta: as plataformas não respondem a envios do navegador.
3. Inicie um checkout e faça uma encomenda real; o cPixel ignora encomendas de teste por predefinição. As suas linhas Servidor devem mostrar o Snapchat Aceite.
4. No Events Manager, os eventos do servidor aparecem no ecrã principal marcados “via Conversions API”; o Snapchat diz que podem demorar 1–2 horas a aparecer (Snapchat).

Destinos marca a conta como Verificado depois do seu primeiro envio do servidor aceite, normalmente 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 estiver a receber os eventos do cPixel, abra a linha do Snapchat em Direto: um envio que não seja Aceite nomeia a sua causa.

Remover, em Gerir Snapchat, para os envios para essa conta e apaga o seu token.

Relacionados

• Ative o app embed
• Veja cada envio no Direto
• Um emissor por pixel