# Ligar o Google Analytics 4

> Ligar o GA4 ao DataFirefly Server-Side através do Measurement Protocol: Measurement ID, API secret do fluxo correto, verificação em tempo real.

- Página original: https://server-side.datafirefly.com/pt/docs/ga4.html
- Idioma: pt
- Atualizado em: 2026-09-01
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

Dois valores, ambos no admin do GA4: o Measurement ID do seu fluxo web e um API secret criado nesse mesmo fluxo.

## Os campos

| Campo | Onde o encontrar |
| --- | --- |
| GA4 Measurement ID | GA4 > **Admin > Data streams** > o seu fluxo web: identificador no formato `G-XXXXXXXXXX` |
| GA4 API secret | Admin > Data streams > abra o fluxo > **Measurement Protocol API secrets** > **Create** |
| GA4 property ID (opcional) | Resolvido automaticamente a partir do Measurement ID. Preencha-o apenas para forçar uma propriedade específica. |

O API secret deve pertencer **ao mesmo fluxo** que o Measurement ID. Um secret criado noutro fluxo é aceite pela Google, mas os eventos não aparecem em lado nenhum.

## Verificar

Particularidade do GA4: o Measurement Protocol responde sempre « OK », mesmo a um envio errado. Não existe portanto validação externa. Verifique em dois sítios:

1. A taxa **Delivered** no Monitoring da sua área de cliente.
2. **GA4 > Reports > Realtime**: envie um evento de teste e veja-o chegar.

## Atribuição dos canais

Os eventos enviados transportam o identificador de sessão e o referrer da página, o que permite ao GA4 ligar as conversões ao seu canal de aquisição em vez de as classificar como « Unassigned ».

## Em caso de duplicados

O GA4 só desduplica o evento `purchase`, e apenas por `transaction_id`. Os módulos DataFirefly recentes já não enviam a compra do lado do navegador: se vir compras em duplicado, [atualize o módulo](https://server-side.datafirefly.com/pt/docs/troubleshooting.html).

Atualizado: 1 de setembro de 2026
