# Conectar o Snap Pixel e a Conversions API ao cPixel {#doc-title}

Por [B2B Gold](/about/#how-we-write) Atualizado em 26 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/docs/cpixel/connect-snapchat/) [Página do cPixel](/shopify/cpixel/) [cPixel na Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-br/docs/cpixel/connect-snapchat&utm_term=docs-header)

## Como conectar o Snapchat ao cPixel? {#how-do-i-connect-snapchat-to-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 {#paste-them-into-cpixel}

1. No cPixel, abra **Destinos** e clique no ícone do Snapchat em **Conectar uma plataforma**. **Configurar Snapchat** abre em **Cole seus IDs**.
2. 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)**.
3. 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.
4. 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.
5. 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](https://businesshelp.snapchat.com/s/article/enhanced-signal-integration-shopify)), então mantenha [um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/).

## Onde encontro o ID do meu Snap Pixel? {#where-do-i-find-my-snap-pixel-id}

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`.

1. No [Snapchat Ads Manager](https://ads.snapchat.com/), abra o menu no canto superior esquerdo (**Create Ads** ou **Manage Ads**, dependendo de onde você chegou) 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 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? {#how-do-i-get-a-conversions-api-token}

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 {#from-your-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é 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 {#from-business-details}

Este é o caminho indicado pelo próprio guia do Snapchat ([Snapchat](https://businesshelp.snapchat.com/s/article/activate-capi)):

1. No Ads Manager, abra o menu no canto superior esquerdo e vá para **Business Dashboard** → **Business Details**.
2. 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](https://developers.snap.com/marketing-api/Conversions-API/GetStarted)). O cPixel armazena o seu e nunca mais o exibe.

## O que o cPixel envia ao Snapchat? {#what-does-cpixel-send-to-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_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 pelos seus servidores.
- **`START_CHECKOUT`, `ADD_BILLING` e `PURCHASE`** vê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](https://developers.snap.com/marketing-api/Conversions-API/Deduplication)).

> **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? {#how-do-i-check-it-worked}

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.

1. No cPixel, abra **Ao vivo** e clique em **Iniciar sessão**.
2. 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.
3. 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**.
4. 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](https://businesshelp.snapchat.com/s/article/capi-verifying-setup)).

**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](https://businesshelp.snapchat.com/s/article/view-event-quality-score) do Snapchat; o cPixel não o lê.

## E se não funcionar? {#what-if-it-doesnt-work}

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](/pt-br/docs/cpixel/alerts-and-reconciliation/) | 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](/pt-br/docs/cpixel/purchases-missing/) |
| 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.

## Relacionados {#related}

- [Ativar o app embed](/pt-br/docs/cpixel/getting-started/)
- [Acompanhe cada envio no Ao vivo](/pt-br/docs/cpixel/live-events/)
- [Um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Instalar grátis pela Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-br/docs/cpixel/connect-snapchat&utm_term=card) [Planos e preços](/shopify/cpixel/#pricing)

Precisa de ajuda com o cPixel? Envie um e-mail para [support@b2bgold.app](mailto:support@b2bgold.app).
