# Primeiros passos com o 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/getting-started/) [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/getting-started&utm_term=docs-header)

## Como configuro o cPixel? {#how-do-i-set-up-cpixel}

Instale o cPixel na Shopify App Store e ele abre em **Configurar o cPixel**, quatro etapas: ativar o app embed, conectar sua primeira plataforma, escolher seu plano e ver os primeiros eventos chegando. A última etapa abre o Ao vivo com uma sessão já em execução, para você ver eventos reais saindo antes de terminar a configuração.

Até você concluir ou pular essa etapa, toda página abre na configuração e o menu mostra apenas **Configurar o cPixel**.

1. **Ative o app embed**: **Abrir o editor de temas** abre seu tema publicado em **App embeds** com **Rastreamento cPixel** ativado. Clique em **Salvar** ali; a etapa se marca como concluída automaticamente. Só esta etapa tem **Pular esta etapa**.
2. **Conecte sua primeira plataforma**: **Escolher uma plataforma** lista as sete, embora o texto cite apenas quatro.
3. **Escolha seu plano**: **Começar grátis**, ou escolha um plano pago (**Escolher Starter**, por exemplo) e aprove-o na tela da Shopify ([compare os planos](/shopify/cpixel/#pricing)).
4. **Veja seus primeiros eventos chegando**: **Começar a acompanhar** conclui a configuração e abre o **Ao vivo** com uma sessão em execução, que no plano Free consome uma das suas sessões do Ao vivo.

**Pular configuração** vai para **Início**, de onde **Concluir configuração** traz você de volta. O painel lateral **Duas formas de rastreamento do cPixel** explica as duas frentes.

> **Nota:** Nada é registrado na sua loja até você salvar uma plataforma; depois disso, o pixel **cPixel** aparece em **Settings** → **Customer events**.

## Para quais plataformas o cPixel envia, e de onde? {#which-platforms-does-cpixel-send-to-and-from-where}

O cPixel envia para sete plataformas. Seis também recebem eventos dos servidores dele, que montam cada compra a partir do pedido da Shopify, não da página de agradecimento; o Google Ads recebe apenas uma tag do navegador. As frentes do navegador rodam no web pixel da Shopify, em todas as páginas, inclusive no checkout, ou em tags da loja que o app embed carrega.

| Plataforma | Frente do navegador | Eventos pelo servidor | Compra a partir de | O que você cola |
| --- | --- | --- | --- | --- |
| Meta | Web pixel, todas as páginas | PageView, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase | Servidor; navegador como alternativa | **ID do pixel / conjunto de dados**; **Token de acesso da Conversions API** (opcional) |
| TikTok | App embed: Pageview | Pageview, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, CompletePayment | Servidor | **Código do pixel**, **Token de acesso da Events API** |
| Google Analytics 4 | Web pixel, todas as páginas | purchase, refund | Servidor | **ID de métrica**; **Segredo de API do Measurement Protocol** (opcional; necessário para compras) |
| OpenAI Ads | App embed: visualizações de página, visualizações de produto, adições ao carrinho | checkout_started, order_created | Servidor | **ID do pixel**, **Chave da Conversions API** |
| Snapchat | App embed: visualizações de página, adições ao carrinho | START_CHECKOUT, ADD_BILLING, PURCHASE | Servidor | **ID do Snap Pixel**, **Token de acesso da Conversions API** |
| Pinterest | App embed: visitas de página, adições ao carrinho | initiate_checkout, checkout | Servidor | **ID da tag**, **ID da conta de anúncios**, **Token de acesso da Conversions API** |
| Google Ads | Web pixel, apenas na página de agradecimento | Nenhum | Navegador | **ID de conversão**, **Rótulo de conversão** |

- Todo plano envia pelo servidor; só o plano Free pausa, ao atingir sua cota mensal de pedidos, e não nos primeiros dias após a instalação ([preços](/shopify/cpixel/#pricing)). O rastreamento pelo navegador nunca é limitado.
- Se um evento de navegador do GA4, OpenAI Ads, Snapchat ou Pinterest nunca sair do dispositivo, o cPixel o envia pelos servidores.
- Os envios pelo servidor do Snapchat e do Pinterest são novos: em produção desde setembro de 2026, ainda sem confirmação em uma conta de anúncios real.
- Reembolsos chegam apenas ao GA4. Microsoft Advertising e X não são oferecidos.

## Por que o cPixel precisa do app embed? {#why-does-cpixel-need-its-app-embed}

O app embed, **Rastreamento cPixel**, carrega as tags da loja para TikTok, OpenAI Ads, Snapchat e Pinterest e permite que o cPixel veja o que os compradores navegam, para que mais dos seus eventos possam ser associados a um cliente.

Com ele desligado, o checkout, as compras, todas as frentes de servidor e os eventos de navegador do Meta, GA4 e Google Ads continuam funcionando. O que para: essas quatro tags da loja, o pareamento do TikTok entre visualizações de página do navegador e do servidor, o cookie de clique da OpenAI, e a segmentação da loja por coleção ou tag. O **Início** mostra **O rastreamento avançado está desligado na sua loja**.

### Ative o app embed {#turn-on-the-app-embed}

1. No **Início**, clique em **Ativar**, ou em **Ativar** ao lado de **App embed**. Seu editor de temas abre com **Rastreamento cPixel** ativado em **App embeds** ([guia da Shopify](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/apps)).
2. Clique em **Salvar** e volte para o cPixel: **App embed** exibe **Ativo**.

> **Importante:** Os app embeds pertencem a um tema. Depois de publicar outro tema, ative o **Rastreamento cPixel** nele também; o cPixel avisa se você esquecer.

## Como conecto minha primeira plataforma? {#how-do-i-connect-my-first-platform}

Abra **Destinos**, escolha uma plataforma em **Conectar uma plataforma** e siga o assistente: **Cole seus IDs**, **Escolha as opções** e **Teste**. O guia de cada plataforma mostra onde encontrar seus valores, começando por [conectar o Meta](/pt-br/docs/cpixel/connect-meta/) e [conectar o OpenAI Ads](/pt-br/docs/cpixel/connect-openai-ads/).

Você não precisa terminar uma plataforma de uma vez: Meta e GA4 aceitam só o ID, como **Só navegador**, até você adicionar o token ou o segredo. TikTok, OpenAI Ads, Snapchat e Pinterest precisam do token desde o início.

## Como sei que os eventos estão chegando? {#how-do-i-know-events-are-arriving}

Abra o **Ao vivo**, clique em **Iniciar sessão** e navegue pela sua loja em outra aba. Por 10 minutos, os eventos aparecem à medida que são enviados, e os envios pelo servidor mostram a resposta da plataforma: [veja seus primeiros eventos no Ao vivo](/pt-br/docs/cpixel/live-events/).

Em **Destinos**, **Verificado** significa que um envio pelo servidor teve sucesso, **Credenciais OK** que um **Testar conexão** passou, e **Só navegador** que há um ID sem token. **Mostrar verificações** no **Início** lista seis verificações de integridade. Cada guia de conexão mostra onde checar isso na plataforma.

> **Dica:** Por padrão, o cPixel ignora pedidos de teste, incluindo todos os pedidos de uma loja de desenvolvimento, e o Ao vivo os marca como **Ignorado**; para ver uma compra, pague de verdade ou desmarque **Configurações** → **Pedidos de teste**.

## O que devo configurar em seguida? {#what-should-i-set-up-next}

Conecte suas outras plataformas. Você pode [manter o app do Facebook e Instagram](/pt-br/docs/cpixel/official-channel-apps/) e os apps próprios de outras plataformas para seus catálogos e lojas, com um único remetente por pixel.

- Se uma compra não aparecer, veja [compras que não aparecem](/pt-br/docs/cpixel/purchases-missing/); para cotas, [planos do cPixel](/pt-br/docs/cpixel/plans/); para pagamento na entrega, [regras de pedidos](/pt-br/docs/cpixel/order-rules/).
- Para ajuda: **Início** → **Obter ajuda** → **Contatar suporte**, geralmente respondido em até um dia útil.

### Removendo o cPixel {#removing-cpixel}

O cPixel não edita arquivos de tema nem pode adicionar tags de script, então não há nada para limpar manualmente.

1. Em um plano pago, cancele primeiro em **Plano** → **Cancelar plano**, que é proporcional; [desinstalar](https://help.shopify.com/en/manual/apps/uninstalling-apps) ainda pode cobrar o ciclo atual.
2. Na Shopify, acesse **Settings** → **Apps**, clique em **…** ao lado do cPixel e depois em **Uninstall**. A Shopify remove o pixel do cPixel e o [app embed](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions/ux) automaticamente.

O cPixel exclui seus tokens de acesso imediatamente e o restante cerca de 48 horas depois; reinstale antes disso e suas configurações voltam, sem os tokens.

## Relacionados {#related}

- [Conectar o Meta](/pt-br/docs/cpixel/connect-meta/)
- [Conectar o OpenAI Ads](/pt-br/docs/cpixel/connect-openai-ads/)
- [Veja seus primeiros eventos no Ao vivo](/pt-br/docs/cpixel/live-events/)
- [Mantenha o app do Facebook e Instagram](/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/getting-started&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).