Ligar o Google Analytics 4 ao cPixel
Como ligo o GA4 ao 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
- No cPixel, abra Destinos e clique no ícone do GA4 em Ligar uma plataforma. Configurar Google Analytics 4 abre em Cole os seus IDs.
- 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.
- 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.
- 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?
Nos detalhes do seu stream web em GA4 Admin: G- seguido de letras e dígitos, tipicamente dez (Google).
No Google Analytics, escolha a sua propriedade, clique em Admin no canto inferior esquerdo e, em Data collection and modification, clique em Data streams.
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?
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.
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.
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).
Porque não avisa o GA4 sobre um segredo errado?
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).
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?
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), 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). 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. O rastreio diário do cPixel assinala uma tag do GA4 colada no seu tema:
Como verifico que funcionou?
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.
- No cPixel, abra Direto, clique em Iniciar sessão, depois faça a encomenda noutro separador.
- Abra a linha Servidor da compra. Google Analytics 4 lê Aceite, o que só significa que o Google respondeu.
- 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).
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).
E se não funcionar?
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 |
Remover, em Gerir Google Analytics 4, para os envios para essa conta e apaga o seu segredo.
