# Conectar o Google Analytics 4 ao cPixel {#doc-title}

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

## Como conectar o GA4 ao cPixel? {#how-do-i-connect-ga4-to-cpixel}

No Google Analytics, acesse Admin, Data collection and modification, Data streams, abra seu fluxo da Web e copie o Measurement ID, que começa com G-. No mesmo painel, abra Measurement Protocol API secrets e crie um. Cole os dois no cPixel e confirme com um pedido real, porque o GA4 aceita silenciosamente um segredo errado.

### Cole-os no cPixel {#paste-them-into-cpixel}

1. No cPixel, abra **Destinos** e clique no ícone do GA4 em **Conectar uma plataforma**. **Configurar Google Analytics 4** abre em **Cole seus IDs**.
2. Cole o Measurement ID em **ID de métrica** e o segredo em **Segredo de API do Measurement Protocol (opcional)**. Se quiser, dê um nome à conta em **Dê um nome a esta conta (opcional)** e clique em **Continuar**.
3. Em **Escolha as opções**, mantenha **Enviar eventos pelo navegador** e **Enviar eventos pelos nossos servidores** marcados. Mantenha **Não — o cPixel cuida do Google Analytics 4 (recomendado)** a menos que outra ferramenta envie para esta propriedade: apesar do nome, **Sim — mantenha-o, e o cPixel para de enviar o Google Analytics 4 pelo servidor** interrompe os envios do cPixel pelo navegador e pelo servidor para ela.
4. Em **Configurações avançadas**, **Residência dos dados** pode enviar eventos do servidor para o endpoint da UE do Google; só o endpoint muda. Clique em **Salvar e continuar**. **Teste** confirma **Google Analytics 4 está conectado**.

> **Importante:** O segredo é opcional no assistente, mas sem ele a conta permanece **Só navegador**: eventos de navegação, sem compras.

## Onde encontro o Measurement ID do GA4? {#where-do-i-find-my-ga4-measurement-id}

Nos detalhes do seu fluxo da Web, em **Admin** no GA4: `G-` seguido de letras e dígitos, normalmente dez ([Google](https://support.google.com/analytics/answer/12270356)).

1. No [Google Analytics](https://analytics.google.com/analytics/web/), escolha sua propriedade, clique em **Admin** no canto inferior esquerdo e, em **Data collection and modification**, clique em **Data streams**.
2. Clique no fluxo da Web da sua loja. O **Measurement ID** (ID de métrica) fica na primeira linha de **Stream details**; use o ícone de copiar ao lado.

> **Nota:** O Measurement ID não é o **Stream ID**, um número simples na mesma linha, nem o ID da propriedade. O cPixel quer o que começa com `G-`.

## Como crio um segredo de API do Measurement Protocol? {#how-do-i-create-a-measurement-protocol-api-secret}

No mesmo painel do fluxo: abra **Measurement Protocol API secrets**, crie um segredo e copie seu valor, com cerca de 22 caracteres. Guia do Google: [Measurement Protocol for GA4](https://developers.google.com/analytics/devguides/collection/protocol/ga4).

1. Role até o bloco **Events** e clique em **Measurement Protocol API secrets**, sua última linha. Os segredos existentes são listados, e você pode reutilizar um.
2. Clique em **Create**, dê um apelido como cPixel, clique em **Create** novamente e copie o **Secret value** para o cPixel.

O Google pode primeiro pedir que você reconheça os termos de coleta de dados do usuário ([Google](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties/acknowledgeUserDataCollection)).

## Por que o GA4 não avisa sobre um segredo errado? {#why-doesnt-ga4-warn-about-a-wrong-secret}

Porque o Measurement Protocol nunca reporta erros. O Google diz que ele “não retorna códigos de erro HTTP, mesmo que um evento esteja malformado”, e seu servidor de validação não verifica o segredo de API ([Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events)).

Então um segredo errado parece um sucesso em todo lugar: **Ao vivo** mostra **Aceito**, a conta aparece como **Verificado** e nenhum alerta dispara, enquanto o GA4 descarta os dados. **Testar conexão** usa o servidor de validação do Google, então ele verifica o payload, não o segredo.

## O que o cPixel envia ao GA4, e de onde? {#what-does-cpixel-send-to-ga4-and-from-where}

Compras e reembolsos saem dos servidores do cPixel; todo o restante vem do navegador do comprador, ou do servidor quando a cópia do navegador nunca saiu do dispositivo.

| Enviado de | Eventos |
| --- | --- |
| Navegador: o web pixel da Shopify, em todas as páginas, incluindo o checkout | page_view, view_item, view_item_list, search, view_cart, add_to_cart, remove_from_cart, begin_checkout, add_shipping_info, add_payment_info |
| Servidor: o Measurement Protocol | purchase, com o pedido como transaction ID; refund, quando você reembolsa um pedido |
| Servidor, só quando o navegador não conseguiu | Um evento do navegador que nunca saiu do dispositivo do comprador, marcado em Ao vivo como reenvio de um evento do navegador bloqueado |

O GA4 deduplica compras pelo transaction ID em fluxos da Web ([Google](https://support.google.com/analytics/answer/12313109)), mas não outros eventos, então o cPixel envia cada um deles uma única vez. Ele não consegue recuperar um evento quando um bloqueador também impede a própria requisição do cPixel, nem ver o GA4 recusar um evento do navegador.

Uma compra precisa da sessão de navegador que o pixel do cPixel registra no checkout. Sem ela, como quando um bloqueador impede a requisição do cPixel, o Ao vivo mostra “Dados insuficientes para montar o payload deste destino” e o GA4 não recebe a compra.

Compras pelo servidor carregam os IDs de cliente e sessão do GA4, e-mail e telefone com hash, e o ID do cliente da Shopify, sem hash, como `user_id`. As duas vias precisam do consentimento de analytics do comprador.

> **Nota:** O GA4 só atribui a origem, mídia e campanha da visita a um evento do servidor se ele chegar dentro de 24 horas do início da sessão ([Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/use-cases)). Compras enviadas depois, por exemplo com **Quando o pedido é enviado** em **Configurações**, podem perder a campanha.

O app Google & YouTube da Shopify também pode enviar visualizações de página e compras para a sua propriedade, então mantenha [um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/). A varredura diária do cPixel sinaliza uma tag do GA4 colada no seu tema:

## Como verifico se funcionou? {#how-do-i-check-it-worked}

Faça um pedido real e encontre a compra no **Ao vivo** do cPixel e no relatório **Realtime** do GA4. Pedidos de teste são ignorados por padrão: pague com um método real, ou desmarque **Configurações** → **Pedidos de teste**.

1. No cPixel, abra **Ao vivo**, clique em **Iniciar sessão** e faça o pedido em outra aba.
2. Abra a linha **Servidor** da compra. O Google Analytics 4 aparece como **Aceito**, o que só significa que o Google respondeu.
3. No GA4, abra o relatório **Realtime** e procure a compra. O Realtime normalmente leva alguns minutos; os outros relatórios, de 24 a 48 horas ([Google](https://support.google.com/analytics/answer/11198161)).

O DebugView não vai mostrá-la: ele lista apenas eventos enviados em modo de depuração, o que não é o caso dos envios reais do cPixel ([Google](https://support.google.com/analytics/answer/7201382)).

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

A maioria das falhas aparece no **Ao vivo** do cPixel; um segredo errado não aparece em lugar nenhum, então verifique o próprio GA4.

| O que você vê | O que isso significa | O que fazer |
| --- | --- | --- |
| **Aceito** no Ao vivo, sem compra no GA4 depois de 48 horas | Um segredo ou Measurement ID errado, ou de outro fluxo | Crie um segredo no mesmo fluxo e cole-o em **Gerenciar Google Analytics 4** em **Destinos**, depois clique em **Continuar** e **Salvar e continuar** |
| **Ignorado**, com um motivo | O cPixel optou por não enviar, por exemplo por falta de consentimento de analytics ou por ser um pedido de teste | Pague de verdade, ou desmarque **Pedidos de teste** |
| A conta aparece como **Só navegador** | Nenhum segredo salvo | Adicione um em **Gerenciar Google Analytics 4** |
| Visualizações de página em dobro, receita correta | Outro remetente, como o app Google & YouTube ou uma tag no seu tema | Mantenha [um remetente por propriedade](/pt-br/docs/cpixel/official-channel-apps/) |

**Remover**, em **Gerenciar Google Analytics 4**, interrompe os envios para essa conta e apaga seu segredo.

## Relacionados {#related}

- [Por que as compras do GA4 não batem com a Shopify](/pt-br/blog/ga4-shopify-purchases/)
- [Acompanhe cada envio no Ao vivo](/pt-br/docs/cpixel/live-events/)
- [Um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/)
- [Como o cPixel conta cada compra uma única vez](/pt-br/docs/cpixel/deduplication/)

[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-ga4&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).