Conectar GA4

Este guia orienta você por todo o processo de configuração: abrir a conexão do GA4, autorizar a conta correta do Google, selecionar a propriedade do seu site ativo, publicar a atualização de rastreamento, confirmar que os dados estão sendo coletados e preparar a conexão para verificação do Google Search Console.

Como funciona a conexão do GA4

Uma propriedade do GA4 é o recurso do Google Analytics que coleta e relata dados de um site ou app. O Atoms usa a conta do Google que você autoriza para encontrar as contas e propriedades do Analytics às quais essa conta pode acessar. Conecte a propriedade usada pelo site publicado para o seu projeto atual no Atoms.

Há três partes na configuração:

1. Autorize uma conta do Google. Faça login na conta que pode acessar a propriedade correta do GA4 e aprove as permissões do Google solicitadas.
2. Conecte a propriedade correspondente. Selecione a conta do Analytics e a propriedade do GA4 usadas pelo site ativo do seu projeto.
3. Adicione a configuração de rastreamento, publique e verifique os relatórios. Aguarde o Atoms adicionar a configuração de rastreamento, revise e publique o site atualizado e depois confirme que a propriedade correta está conectada e recebendo dados.

A conexão do GA4 é separada do fluxo de trabalho de conteúdo SEO da Sarah. Sarah pode planejar e gerar páginas de SEO sem o GA4. A conexão é usada para relatórios do Analytics.

Uma conexão do GA4 autorizada pelo usuário também pode dar suporte à verificação automática do site quando você conectar o Google Search Console mais tarde, se a conexão atender aos requisitos do Google.

Antes de começar

Antes de conectar o Google Analytics 4 (GA4), certifique-se de que:

• Você é o proprietário do projeto. Outros colaboradores podem conseguir visualizar o projeto, mas somente o proprietário pode gerenciar a conexão do GA4.
• Você tem uma conta do Google com acesso à propriedade do GA4 usada pelo seu site.
• Você sabe qual propriedade do GA4 pertence ao site publicado. Se várias propriedades tiverem nomes parecidos, verifique primeiro o site ou o fluxo de dados da Web no Google Analytics.
• Seu site foi gerado e está publicado ou pronto para publicar. Se Marketing → Analytics informar que você deve começar a criar o site, termine de gerá-lo antes de continuar.
• Seu navegador permite pop-ups de autorização do Google vindos do Atoms.
• Qualquer tarefa atual da Sarah ou do Alex tenha sido concluída antes de você alterar a conexão de Marketing.

Você pode conectar o GA4 antes de seu domínio personalizado estar ativo. No entanto, seu site publicado deve enviar dados para a propriedade conectada antes que os relatórios do Analytics possam aparecer.

Se você planeja usar o GA4 para ajudar a verificar seu site no Google Search Console, use a mesma conta do Google para ambas as conexões. Essa conta também deve ter acesso de edição à propriedade do GA4.

Se você não conseguir acessar a propriedade, peça ao administrador do Google Analytics para conceder o acesso necessário. Consulte o guia de acesso de usuário do Analytics do Google.

Se sua conta do Google ainda não tiver uma conta do Analytics, propriedade ou fluxo de dados da Web, o Atoms poderá orientar você na criação de um durante a configuração. Você também pode criar esses itens diretamente no Google Analytics usando o guia de configuração do Analytics para sites do Google.

Permissão do Google Analytics: Use uma conta do Google que possa acessar a conta do Analytics e a propriedade do GA4 deste site. Selecionar uma propriedade existente ou um fluxo de dados da Web exige acesso a esse recurso. Criar uma conta do Analytics, propriedade do GA4 ou fluxo de dados da Web na configuração exige permissão de Editor (ou equivalente) no nível relevante do Analytics. Se um recurso estiver ausente ou você não tiver a permissão necessária, peça a um administrador do Analytics para conceder acesso ou criar o recurso primeiro no Google Analytics e depois volte ao Atoms e selecione Atualizar.

Nunca cole senhas do Google, códigos de verificação, tokens de acesso ou outras credenciais no Chat.

Conectar o Google Analytics 4

Abrir o conector do GA4

1. Abra o projeto do Atoms cujo site publicado você deseja medir.
2. Selecione Marketing na barra de ferramentas do projeto.
3. Abra Analytics. Se você começar em Overview, também poderá encontrar o cartão Analytics em Marketing e selecionar Set up Analytics.
4. Selecione Authorize GA4. Isso autoriza a conta do Google; você conectará a propriedade em uma etapa posterior.

Autorize o Google Analytics 4 em Marketing

Autorizar a conta do Google

1. Na janela de autorização do Google, faça login na conta do Google que pode acessar a propriedade do GA4 deste site.
2. Verifique se a conta correta do Google está selecionada.
3. Revise o acesso solicitado pelo Atoms. Continue somente se concordar.
4. Volte ao Atoms e aguarde a conclusão da etapa de autorização.

Se o navegador bloquear a janela de autorização, permita pop-ups para o Atoms e tente novamente. Se o Atoms oferecer Open authorization page, use essa opção para continuar em uma nova aba.

Conectar a propriedade do site ativo

Depois de autorizar sua conta do Google, o Atoms mostra as contas e propriedades do Google Analytics que você pode acessar. O que você verá em seguida pode variar dependendo de quantos recursos do Analytics estão vinculados à sua conta.

1. Se o Atoms pedir que você escolha uma conta do Analytics, selecione a que contém a propriedade do seu site.
2. Selecione a propriedade do GA4 usada pelo seu site publicado. Se você não tiver certeza de qual escolher, verifique primeiro a propriedade no Google Analytics.
3. Se um fluxo de dados da Web aparecer, confirme que ele usa o endereço correto do site ativo.
4. Selecione Connect property.
5. Mantenha a página aberta até que o Atoms confirme que a conexão foi concluída.

Se alguma parte da configuração do Analytics estiver faltando:

• Sem conta do Analytics: Se disponível, selecione Let Atoms create it for you fast, conclua a configuração no Google e depois volte ao Atoms e selecione Atualizar.
• Sem propriedade do GA4: Selecione a conta correta do Analytics, depois escolha Create property in Atoms e aguarde a nova propriedade aparecer.
• Sem fluxo de dados da Web: Selecione a propriedade e escolha Quick Create em Create web stream, ou crie um manualmente em Google Analytics Admin.

Se uma conta, propriedade ou fluxo de dados que já deveria existir não aparecer, verifique se você está usando a conta correta do Google e se tem acesso a ela. Se ela tiver sido criada recentemente ou compartilhada com você há pouco tempo, aguarde um pouco e selecione Atualizar.

Conecte a propriedade do GA4 usada pelo site ativo

Concluir a atualização de rastreamento e publicar

Conectar o recurso do Google, por si só, não faz com que o site publicado comece a coletar dados. Depois que o Atoms confirmar a conexão da propriedade, ele inicia uma tarefa do projeto para adicionar a configuração de rastreamento do Analytics ao site.

1. Aguarde a conclusão da tarefa de rastreamento. Evite iniciar outra compilação ou tarefa de Marketing enquanto a atualização estiver em execução.
2. Revise a alteração concluída e visualize o site. Confirme que o site ainda carrega e se comporta como esperado.
3. Publique o projeto atualizado. Se o site já estiver ativo, certifique-se de que a versão recém-atualizada seja a versão publicada agora.
4. Abra a página inicial publicada em uma nova aba e use o site normalmente para gerar uma visita de teste.
5. Volte para Marketing → Analytics para verificar a conexão e, depois que o Google tiver processado a visita, o estado dos relatórios.

Resultado esperado: O Atoms mostra a propriedade pretendida como conectada, a atualização de rastreamento está presente na versão publicada e o site ativo começa a enviar novas atividades para essa propriedade. Conectar o GA4 não cria dados históricos para atividades ocorridas antes do início da coleta.

Verificar se a conexão funcionou

1. Volte para Marketing → Analytics.
2. Confirme que a configuração do Google Analytics 4 não mostra mais o prompt inicial de conexão.
3. Verifique se a conta ou propriedade conectada corresponde ao site ativo.
4. Se a área de relatórios do Analytics estiver disponível, abra-a e escolha um intervalo de datas recente.
5. Se o site for novo, visite o site publicado e volte mais tarde para verificar se há dados processados.

Um relatório vazio não significa necessariamente que a autorização falhou. Trate o estado da propriedade conectada e o estado dos relatórios como verificações separadas. Confirme que a tarefa de rastreamento foi concluída, que a versão atualizada está publicada e que a mesma propriedade está recebendo eventos do site ativo. O Google observa que muitos relatórios padrão do GA4 podem levar de 24 a 48 horas para serem preenchidos após o início da coleta; use o Google Analytics Realtime quando precisar de uma verificação mais cedo da coleta. Consulte o guia de verificação de coleta de dados do Google.

Revise os relatórios do Analytics depois que os dados do GA4 estiverem disponíveis

Recuperar-se de uma falha na conexão do GA4

Use o estado que falhou para escolher a próxima ação segura. Uma falha na autorização ou na lista de recursos geralmente exige uma nova janela de autorização, a identidade correta do Google ou uma atualização depois que o acesso for concedido. Uma propriedade conectada sem dados de relatório exige verificar a tarefa de rastreamento e a publicação antes de tentar novamente a conexão.

• Falha na autorização ou no carregamento da conta: Permita pop-ups, reabra Open authorization page se essa opção for oferecida, confirme a identidade do Google pretendida e tente novamente uma vez.
• Uma conta, propriedade ou fluxo está ausente: Confirme o acesso necessário e a permissão de Editor para criação, depois selecione Atualizar quando um recurso criado recentemente ou compartilhado com você ficar disponível.
• A propriedade conecta, mas o rastreamento ou os relatórios falham: Aguarde a conclusão da tarefa de rastreamento, visualize e publique a versão mais recente, confirme que a propriedade conectada corresponde ao site ativo e use o Google Analytics Realtime ou o atraso de relatórios documentado antes de tentar novamente.

Se a mesma etapa ainda falhar após uma nova tentativa, entre em contato com o Suporte do Atoms ou com o administrador do seu Espaço de Trabalho. Inclua o nome do projeto, o nome da propriedade conectada se ele for exibido, a etapa que falhou, o texto de status ou erro visível, o horário aproximado e uma captura de tela com informações sensíveis ocultadas. Nunca inclua senhas, códigos de verificação, tokens de acesso, códigos OAuth ou outras credenciais.

Usar o GA4 com o Google Search Console

A verificação do Search Console baseada no Google Analytics é condicional. No Atoms, Auto Verify via Google Analytics exige uma conexão elegível do GA4 autorizada pelo usuário. Uma configuração gerenciada de GA4 criada pelo Atoms não pode usar essa ação de verificação automática. O GA4 não é necessário se você usar um dos métodos manuais de verificação do Google.

Para configurar e verificar seu site no Search Console, consulte Connect Google Search Console para ver as etapas completas e os requisitos.

O método de verificação do Analytics do Google também exige uma página inicial pública contendo a tag compatível do Analytics e se aplica a uma propriedade de prefixo de URL do Search Console, não a uma propriedade de domínio. Se a verificação automática não estiver disponível porque a configuração do GA4 é gerenciada pelo Atoms ou porque algum requisito do Google não foi atendido, continue com Verify manually in Google Search Console. Consulte os requisitos de verificação de propriedade do site do Google.

Para o fluxo de trabalho relacionado de conteúdo e relatórios, consulte SEO Agente.