# Ligar o Google Analytics 4 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-ga4/) [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-ga4&utm_term=docs-header)

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

No Google Analytics, vá a Admin, Data collection and modification, Data streams, abra o seu stream web e copie o ID de medição, que começa por G-. No mesmo painel, abra Measurement Protocol API secrets e crie um. Cole ambos no cPixel, depois confirme com uma encomenda 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 **Ligar uma plataforma**. **Configurar Google Analytics 4** abre em **Cole os seus IDs**.
2. Cole o ID de medição em **ID de medição** e o segredo em **Segredo da API do Measurement Protocol (opcional)**. Dê um nome à conta em **Dê um nome a esta conta (opcional)** se quiser, depois clique em **Continuar**.
3. 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 Google Analytics 4 (recomendado)** a menos que outra ferramenta envie para esta propriedade: apesar do seu nome, **Sim — mantenha-a, e o cPixel deixa de enviar para o Google Analytics 4 do lado do servidor** para os envios do navegador e do servidor do cPixel para ela.
4. Em **Definições avançadas**, **Residência dos dados** pode enviar eventos do lado do servidor para o endpoint da UE do Google; só o endpoint muda. Clique em **Guardar e continuar**. **Testar** confirma que **Google Analytics 4 está ligado**.

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

## Onde encontro o meu ID de medição do GA4? {#where-do-i-find-my-ga4-measurement-id}

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

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

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

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

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

1. Desça até ao bloco **Events** e clique em **Measurement Protocol API secrets**, a sua última linha. Os segredos existentes são listados, e pode reutilizar um.
2. Clique em **Create**, dê-lhe uma alcunha como cPixel, clique em **Create** novamente e copie o **Secret value** para o cPixel.

O Google pode primeiro pedir-lhe para reconhecer os seus termos de recolha de dados de utilizador ([Google](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties/acknowledgeUserDataCollection)).

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

Porque o Measurement Protocol nunca reporta erros. O Google diz que “does not return HTTP error codes, even if an event is malformed”, e o seu servidor de validação não verifica o segredo da API ([Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events)).

Por isso um segredo errado parece um sucesso em todo o lado: o Direto mostra **Aceite**, a conta lê **Verificado** e nenhum alerta dispara, enquanto o GA4 descarta os dados. **Testar ligação** usa o servidor de validação do Google, por isso verifica o payload, não o segredo.

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

As compras e os reembolsos vão dos servidores do cPixel; tudo o resto do navegador do comprador, ou do servidor quando a cópia do navegador nunca saiu do dispositivo.

| Enviado de | Eventos |
| --- | --- |
| Navegador: web pixel do 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 a encomenda como ID de transação; refund, quando reembolsa uma encomenda |
| Servidor, só quando o navegador não conseguiu | Um evento do navegador que nunca saiu do dispositivo do comprador, marcado no Direto como reenviando um evento do navegador bloqueado |

O GA4 desduplica compras pelo ID de transação em streams web ([Google](https://support.google.com/analytics/answer/12313109)), mas não outros eventos, por isso o cPixel envia cada um deles uma vez. Não consegue recuperar um evento quando um bloqueador também parou o próprio pedido do cPixel, nem ver o GA4 recusar um evento do navegador.

Uma compra precisa da sessão de navegador que o pixel do cPixel regista no checkout. Sem uma, como quando um bloqueador parou o pedido do cPixel, o Direto mostra “Dados insuficientes para construir o payload deste destino” e o GA4 não recebe compra nenhuma.

Os envios do servidor levam os IDs de cliente e de sessão do GA4, e-mail e telefone com hash, e o ID de cliente do Shopify, sem hash, como `user_id`. Ambas as vias precisam do consentimento de análise do comprador.

> **Nota:** O GA4 só atribui a um evento do servidor a origem, o meio e a campanha da sua visita se chegar dentro de 24 horas do início da sessão ([Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/use-cases)). As compras enviadas mais tarde, por exemplo com **Quando a encomenda é expedida** em **Definições**, podem perder a sua campanha.

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

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

Faça uma encomenda real e encontre a compra no **Direto** do cPixel e no relatório **Realtime** do GA4. As encomendas de teste são ignoradas por predefinição: pague com um método real, ou desmarque **Definições** → **Encomendas de teste**.

1. No cPixel, abra **Direto**, clique em **Iniciar sessão**, depois faça a encomenda noutro separador.
2. Abra a linha **Servidor** da compra. Google Analytics 4 lê **Aceite**, o que só significa que o Google respondeu.
3. No GA4, abra o relatório **Realtime** e procure a compra. O Realtime demora tipicamente uns minutos, os outros relatórios 24–48 horas ([Google](https://support.google.com/analytics/answer/11198161)).

O DebugView não a mostra: lista só eventos enviados em modo de depuração, o que os envios reais do cPixel não são ([Google](https://support.google.com/analytics/answer/7201382)).

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

A maioria das falhas aparece no **Direto** do cPixel; um segredo errado não aparece em lado nenhum, por isso verifique o próprio GA4.

| O que vê | O que significa | O que fazer |
| --- | --- | --- |
| **Aceite** no Direto, sem compra no GA4 depois de 48 horas | Um segredo ou ID de medição errado, ou de outro stream | Crie um segredo no mesmo stream e cole-o em **Gerir Google Analytics 4** em **Destinos**, depois **Continuar** e **Guardar e continuar** |
| **Ignorado**, com um motivo | O cPixel optou por não enviar, por exemplo sem consentimento de análise ou uma encomenda de teste | Pague a sério, ou desmarque **Encomendas de teste** |
| A conta lê **Apenas no navegador** | Nenhum segredo guardado | Adicione um em **Gerir Google Analytics 4** |
| Visualizações de página duplicadas, receita correta | Outro emissor, como a aplicação Google & YouTube ou uma tag no seu tema | Mantenha [um emissor por propriedade](/pt-pt/docs/cpixel/official-channel-apps/) |

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

## Relacionados {#related}

- [Porque é que as compras do GA4 não correspondem ao Shopify](/blog/ga4-shopify-purchases/)
- [Veja cada envio no Direto](/pt-pt/docs/cpixel/live-events/)
- [Um emissor por pixel](/pt-pt/docs/cpixel/official-channel-apps/)
- [Como o cPixel conta cada compra uma vez](/pt-pt/docs/cpixel/deduplication/)

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