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, planos) e clica num deles |
view_item | A pessoa abre a página de um produto |
begin_checkout | Começa o 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 e produtos gratuitos (valor 0) |
refund | Um reembolso |
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.
- No Google Analytics, crie uma propriedade GA4 com um fluxo da Web e copie o ID da métrica (
G-…). - Na Memberfy, Administração › Configurações › Geral, cole em ID do Google Analytics.
- 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.
- 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.
- Na Memberfy, Administração › Configurações › Geral, cole em Chave secreta da API (Measurement Protocol).
- 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_settingscomga_api_secretgrava a chave; o assistente nunca a repete, só diz que está configurada e os 4 últimos caracteres. - Pela API:
PATCH /api/communities/{id}/settingscomgaApiSecret(nullapaga).GET /api/communities/settingsdevolvegoogleAnalyticsId,gaApiSecretConfiguredegaApiSecretLast4, nunca a chave.