# Google Analytics

> Ligar o Google Analytics 4 da comunidade, os eventos que a Memberfy envia (visitas, vitrine, checkout, compra, reembolso, cadastro, login e lista de espera), a chave secreta da API do Measurement Protocol para as compras pagas com a página fechada, e o que nunca é enviado.

Com o **ID do Google Analytics** da comunidade, a Memberfy envia ao **seu** Google Analytics 4 as visitas e o caminho de quem compra, da vitrine até a compra. Você vê no GA4 de onde vêm as vendas, que plano mais converte e onde as pessoas desistem do checkout.

Fica em **Administração › Configurações › Geral**, no bloco **Configurações Gerais**.

## Quem pode

**Proprietário** e **administrador**, os mesmos que abrem **Configurações**.

## Como funciona

### O que vai para o seu GA4

Só com o ID preenchido. Os nomes são os eventos recomendados do GA4, então os relatórios de **Monetização** e de **Funil** do Google funcionam sem configurar nada:

| Evento | Quando |
|---|---|
| `page_view` | Cada página aberta, uma vez, com o endereço limpo (sem parâmetros e sem os códigos de convite ou de oferta) |
| `view_item_list` e `select_item` | A pessoa vê a lista de produtos ou planos (catálogo, [Loja](/espacos/loja), planos) e clica num deles |
| `view_item` | A pessoa abre a página de um produto |
| `begin_checkout` | Começa o [checkout](/pagamentos/checkout) |
| `add_payment_info` | Escolhe a forma de pagamento (PIX, boleto ou cartão) |
| `purchase` | A compra foi paga: com o número do pedido, o valor, a moeda, o cupom e os itens (produto, plano ou adicional). Vale também para adicionais, troca de plano, ofertas de [downsell](/monetizacao/downsell) e produtos gratuitos (valor 0) |
| `refund` | Um [reembolso](/pagamentos/reembolsos-e-contestacoes) |
| `sign_up` e `login` | Alguém cria a conta ou entra |
| `generate_lead` | Alguém entra numa lista de espera |

Cada pedido conta **uma vez só**: recarregar a página de confirmação, abrir outra aba ou pagar o PIX depois não repete a compra.

### O que nunca vai

Nenhum dado pessoal: nem nome, nem e-mail, nem documento, nem telefone, nem o id da pessoa. Os eventos levam só o que foi visto ou comprado e quanto custou.

### A chave secreta da API (Measurement Protocol)

Sem a chave, a compra só chega ao GA4 se a pessoa ainda estiver com a página aberta quando o pagamento é confirmado. Um PIX ou boleto pago depois, com a página fechada, um cartão que ficou em análise e as renovações das assinaturas ficam de fora.

Com a **Chave secreta da API (Measurement Protocol)**, a própria Memberfy envia ao seu GA4 a compra de todo pedido pago e todo reembolso, mesmo sem ninguém com a página aberta. O GA4 reconhece o mesmo pedido vindo do navegador e da Memberfy e **não conta a compra duas vezes**.

- É opcional.
- Depois de salva, a chave **nunca volta a aparecer**: a tela mostra só **Configurada** e os 4 últimos caracteres, com **Substituir** e **Remover**.
- Tem de 8 a 100 caracteres: letras, números, `_` e `-`.

## Passo a passo: ligar o Google Analytics

*Papel: proprietário ou administrador.*

1. No Google Analytics, crie uma propriedade GA4 com um fluxo da Web e copie o **ID da métrica** (`G-…`).
2. Na Memberfy, **Administração › Configurações › Geral**, cole em **ID do Google Analytics**.
3. **Salvar Alterações**. As visitas e o caminho de compra passam a aparecer no seu GA4.

## Passo a passo: a chave secreta da API

*Papel: proprietário ou administrador.*

1. No GA4: **Administrador › Fluxos de dados ›** o seu fluxo da Web **› Chaves secretas da API do Measurement Protocol › Criar**. Dê um nome (por exemplo, *Memberfy*) e copie o **Valor do secret**.
2. Na Memberfy, **Administração › Configurações › Geral**, cole em **Chave secreta da API (Measurement Protocol)**.
3. **Salvar chave**. A tela passa a mostrar **Configurada ••••** e os 4 últimos caracteres.

Para trocar, **Substituir**; para parar de enviar pelo servidor, **Remover**.

## Exemplo

**Curso vendido no PIX.** A Bia vende o curso *Excel do Zero* por R$ 297. Um comprador gera o PIX, fecha a página e paga pelo celular uma hora depois. Sem a chave, essa venda não aparece no GA4. Com a chave, o `purchase` chega com o pedido, o valor e o item *Excel do Zero*, e o relatório de **Monetização** do GA4 bate com as vendas da Memberfy.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| *A chave tem de 8 a 100 caracteres: letras, números, _ e -.* | Copie de novo o **Valor do secret** no GA4, sem espaços |
| As compras não aparecem | Confira o **ID do Google Analytics** (`G-…`, do mesmo fluxo da chave). No GA4, as compras levam até 24 horas para entrar nos relatórios; em **Tempo real**, aparecem em minutos |
| Perdi a chave | Ela não volta a aparecer. Crie outra no GA4 e use **Substituir** |

## Perguntas frequentes

**Preciso da chave?**
Não. Sem ela, o GA4 recebe as visitas e as compras feitas com a página aberta. Com ela, recebe todas.

**O ID do Google Analytics mede a comunidade inteira?**
Mede o app da comunidade: a vitrine, os espaços, o checkout e as páginas de produto.

**Posso usar outro rastreador?**
Pela tela, só o Google Analytics.

## Pelo assistente e pela API

- Pelo assistente de IA: [`update_community_settings`](/mcp/ferramentas-comunidade#update-community-settings) com `ga_api_secret` grava a chave; o assistente nunca a repete, só diz que está configurada e os 4 últimos caracteres.
- Pela API: `PATCH /api/communities/{id}/settings` com `gaApiSecret` (`null` apaga). `GET /api/communities/settings` devolve `googleAnalyticsId`, `gaApiSecretConfigured` e `gaApiSecretLast4`, nunca a chave.

## Relacionados

- [Configurações gerais](/configuracoes/configuracoes-gerais)
- [Checkout](/pagamentos/checkout)
- [Vendas](/pagamentos/vendas)