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

Por [B2B Gold](/about/#how-we-write) Atualizado a 26 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/docs/cpixel/connect-snapchat/) [Página de 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-pt/docs/cpixel/connect-snapchat&utm_term=docs-header)

## Como ligo o Snapchat ao cPixel? {#how-do-i-connect-snapchat-to-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 {#paste-them-into-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](https://businesshelp.snapchat.com/s/article/enhanced-signal-integration-shopify)), por isso mantenha [um emissor por pixel](/pt-pt/docs/cpixel/official-channel-apps/).

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

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](https://ads.snapchat.com/), 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? {#how-do-i-get-a-conversions-api-token}

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

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

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](https://developers.snap.com/marketing-api/Conversions-API/GetStarted)). O cPixel guarda o seu e nunca o volta a mostrar.

## O que envia o cPixel ao Snapchat? {#what-does-cpixel-send-to-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](https://developers.snap.com/marketing-api/Conversions-API/Deduplication)).

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

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](https://businesshelp.snapchat.com/s/article/capi-verifying-setup)).

**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](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 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.

| O que vê | O que fazer |
| --- | --- |
| **Testar ligação** rejeita o token | Copie-o de novo, e verifique que vem da organização que possui o pixel |
| **Rejeitado** ou **Erro** | Leia a resposta do Snapchat nos detalhes da linha; o cPixel repete os erros sozinho |
| Nada chega ao seu pixel | Verifique o Pixel ID: pode ter perdido os traços, ou ser o ID da conta de anúncios |
| **Corrigir Snapchat** em **Início**: o token foi rejeitado ou eliminado, os envios do servidor pararam e um alerta crítico foi [enviado por e-mail](/pt-pt/docs/cpixel/alerts-and-reconciliation/) | Gere um novo token, clique em **Corrigir Snapchat**, ou **Gerir** junto à conta em **Destinos**, cole-o e guarde |
| Nenhuma linha **Navegador** nomeia o Snapchat | O app embed está desligado (o emblema **Navegador** lê **Precisa do app embed**): ative o **Rastreio cPixel** e guarde o seu tema, de novo depois de mudar de tema |
| Uma compra está em falta ou **Ignorado** | Leia o motivo, depois veja [compras que não aparecem](/pt-pt/docs/cpixel/purchases-missing/) |
| Visualizações de página ou compras contadas duas vezes | Outra ferramenta, como a aplicação Snapchat Ads ou código de pixel no seu tema, envia para este pixel |

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

## Relacionados {#related}

- [Ative o app embed](/pt-pt/docs/cpixel/getting-started/)
- [Veja cada envio no Direto](/pt-pt/docs/cpixel/live-events/)
- [Um emissor por pixel](/pt-pt/docs/cpixel/official-channel-apps/)

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

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

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