Conectando o Google Analytics (GA4)
Conecte sua conta do Google Analytics 4 ao Opus Growth.
Antes de começar
- Acesso de leitor na propriedade do GA4 é suficiente para relatórios; marcar conversões ou vincular o Google Ads exige acesso de editor.
- A conexão lê seus relatórios e só altera uma configuração do GA4 quando você aprova (conversões, dimensões personalizadas, vínculo com o Google Ads).
- Ela é independente do seu token do Google Ads e não interfere nele.
Etapas da conexão
- Execute a ferramenta. Diga ao seu assistente
connect_ga4. Ele retorna um link de autorização de uso único vinculado à sua conta; nada está conectado ainda nesta etapa. - Abra o link. O link é válido por uma hora. Abra-o em um navegador no qual você esteja conectado como a pessoa que tem acesso à conta do Google Analytics 4.
- Conceda o acesso. Aprove as permissões solicitadas na tela do Google Analytics 4. Essa é a tela de consentimento do próprio Google Analytics 4, então o login acontece lá, não conosco.
- Selecione uma conta. Suas contas são listadas após a autorização. Marque as que você quer gerenciar e salve; todas as operações seguintes são executadas na conta que você escolheu.
- Confirme. Execute
ga4_list_properties; se suas propriedades aparecerem na lista, a conexão está pronta.
Permissões solicitadas
openidhttps://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
Nada além desta lista é solicitado, e o token é armazenado criptografado. Se você recusar qualquer permissão na tela de consentimento, o fluxo é interrompido e nenhum token é gravado.
Observações
- Uma conexão separada; seu token do Google Ads não é alterado.
- Suas propriedades do GA4 são listadas com
ga4_list_properties. - Os relatórios são lidos; as configurações do GA4 só mudam com alterações que você aprova (conversões, dimensões personalizadas, vínculo com o Google Ads).
Solução de problemas
Por que as conversões do GA4 não batem com as do Google Ads?
Os dois sistemas contam o mesmo evento de formas diferentes: o Google Ads atribui a conversão ao dia do clique, e o GA4 ao dia em que a conversão aconteceu. Modelagem, janela de atribuição e fuso horário também podem variar. Uma pequena diferença é esperada; uma diferença grande geralmente indica uma tag ausente ou instalada em duplicidade.
Por que o relatório em tempo real é diferente do relatório padrão?
O tempo real mostra os últimos minutos sem processamento, enquanto os relatórios padrão se estabilizam após o processamento. É normal ver números diferentes ao comparar os dois ao mesmo tempo.
Por que o link diz que a conexão é inválida ou expirou?
Um link de autorização expira uma hora após ser gerado e só pode ser usado uma vez; abrir um link que já foi usado gera o mesmo erro. Execute a ferramenta de conexão novamente e você receberá um novo link para continuar.
Selecionei várias contas, mas só uma foi salva. Por quê?
Os planos Grátis e Pro conectam uma conta de anúncios por plataforma; gerenciar várias é um recurso do plano Agência. Mesmo que você marque mais de uma na tela de seleção, apenas a primeira é mantida ao salvar. Para trabalhar como agência, é preciso fazer upgrade do plano; depois disso, você atualiza a seleção pelo seletor de contas do painel, que reutiliza o token armazenado, então você nunca precisa autorizar de novo.
Autorizei com o usuário errado. O que acontece?
O acesso armazenado se limita às contas que o usuário autorizador consegue ver; uma conta que esse usuário não alcança também não fica visível para nós. Desconecte pelo painel e conecte novamente com o usuário correto, e o token antigo será excluído.
Desconexão
Abra o painel, encontre o Google Analytics 4 em plataformas conectadas e escolha desconectar.
O token armazenado é excluído imediatamente, não apenas ocultado, então não conseguimos mais acessar a conta.
Reconectar depois significa executar connect_ga4 novamente e passar pela
autorização do zero. Desconectar não exclui nada dentro da sua
conta do Google Analytics 4.