Conecte o Google Analytics 4 (GA4) ao seu projeto Atoms para acompanhar o tráfego do site e entender como os usuários interagem com o seu site publicado.

Este guia orienta você por todo o processo de configuração: abrir a conexão do GA4, autorizar a conta Google correta, 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 a 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 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 do seu projeto Atoms atual.

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

1. Autorize uma conta 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, em seguida, confirme que a propriedade correta está conectada e recebendo dados.

A conexão do GA4 é separada do fluxo 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 de GA4 dele.
• Você tem uma conta 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 semelhantes, 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 foi concluída antes de você alterar a conexão de Marketing.

Você pode conectar o GA4 antes de o seu domínio personalizado estar ativo. No entanto, o 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 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 dela para conceder o acesso necessário. Consulte o guia de acesso de usuários do Analytics do Google.

Se sua conta 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 criá-los diretamente no Google Analytics usando o guia de configuração do Analytics para sites do Google.

Permissão do Google Analytics: Use uma conta 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 Refresh.

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

Conectar Google Analytics 4

Abra o conector do GA4

1. Abra o projeto 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 Google; você conectará a propriedade em uma etapa posterior.

Autorizar o Google Analytics 4 em Marketing

Autorize a conta Google

1. Na janela de autorização do Google, faça login na conta Google que pode acessar a propriedade do GA4 deste site.
2. Verifique se a conta Google correta está selecionada.
3. Revise o acesso solicitado pelo Atoms. Continue apenas 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.

Conecte a propriedade do site ativo

Depois de autorizar sua conta Google, o Atoms mostra as contas e propriedades do Google Analytics às quais 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 ausente:

• Sem conta do Analytics: Se disponível, selecione Let Atoms create it for you fast, conclua a configuração do Google e, depois, volte ao Atoms e selecione Refresh.
• Sem propriedade do GA4: Selecione a conta correta do Analytics e, em seguida, 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 Google correta e se tem acesso a ela. Se ela foi criada recentemente ou compartilhada com você há pouco tempo, aguarde um momento e selecione Refresh.

Conecte a propriedade do GA4 usada pelo site ativo

Conclua a atualização de rastreamento e publique

Conectar o recurso do Google, por si só, não faz com que o site publicado comece a coletar dados. Depois que o Atoms confirma 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á estava 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 que ocorreram antes do início da coleta.

Verifique 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 foi 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 de coleta mais cedo. 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

Recupere-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 precisa de uma nova janela de autorização, da identidade Google correta ou de uma atualização depois que o acesso for concedido. Uma propriedade conectada sem dados de relatório precisa de uma verificação da tarefa de rastreamento e da publicação antes de você tentar novamente a conexão.

• A autorização ou o carregamento da conta falha: Permita pop-ups, reabra Open authorization page se essa opção for oferecida, confirme a identidade 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 e, em seguida, selecione Refresh depois que um recurso criado recentemente ou compartilhado 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ório 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 for exibido, a etapa que falhou, o status visível ou o texto do erro, 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.

Use 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 do GA4 elegível 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 de verificação manual 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 do Analytics compatível e se aplica a uma propriedade do Search Console com prefixo de URL, 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 relacionado de conteúdo e relatórios, consulte SEO Agente.