Quatro minutos para criar a conta de serviço. Dezasseis meses de histórico do Search Console preenchidos na primeira sincronização. Dois segundos para um domínio já verificado e com permissões. E dois meses — o número que gera mais pedidos de suporte do que os outros três juntos, porque é a janela de retenção de dados predefinida do GA4, e quase ninguém se lembra de verificar isso antes de ligar.
A configuração em si é rápida: uma credencial em Definições → Contas Google, dois botões de ligação em Gestão de Domínios, e depois esquece-se praticamente que esta página existe. Mas esse número de dois meses merece uma explicação completa, porque explica por que razão alguns domínios mostram, logo no primeiro dia, um histórico do Analytics rico e útil, enquanto outros mostram quase nada durante semanas — e isso não é um erro da plataforma.
Uma credencial, concedida uma única vez
Carrega uma chave de conta de serviço Google — um ficheiro JSON, não um login pessoal. Uma identidade de robô, não um token OAuth humano que expira ou deixa de funcionar quando alguém muda a palavra-passe. A Google Cloud emite-a uma vez e ela continua a funcionar até ser eliminada, o que também é o motivo pelo qual a plataforma sincroniza às 3 da manhã sem ninguém ter sessão iniciada.
Criar uma leva cerca de quatro minutos se nunca o fez: projeto novo ou existente, IAM & Admin → Contas de Serviço → Criar, transferir a chave. A permissão importa mais do que o menu suspenso faz parecer — conceda apenas Leitor na propriedade do Search Console e na propriedade do Analytics, nada acima disso. Já vi equipas concederem Editor por ser a opção do topo, e seis meses depois ninguém consegue explicar por que razão uma conta robô tem acesso de escrita à configuração do GA4. Apenas leitura é o correto; a plataforma nunca toca nas suas definições.
Uma chave cobre todos os domínios sob esse projeto do Google Cloud. Se é uma agência a gerir uma dúzia de sites de clientes, isso é um argumento a favor de uma conta de serviço por cliente em vez de uma só para tudo — encerrar a colaboração com um cliente passa a ser apagar uma chave, e não auditar que domínios partilharam silenciosamente credenciais com alguém que acabou de sair.
Search Console: rápido quando é rápido, incómodo quando não é
- Abra Ligar num domínio. O Search Console e o Analytics têm cada um um cartão, e o Analytics tem um atalho "igual ao Search Console", porque uma chave normalmente cobre ambos.
- Já verificado com a sua conta de serviço com acesso concedido? Instantâneo — uma verificação de permissão, feita em cerca de dois segundos.
- Ainda não verificado: verificação automática de DNS se fornecer a chave de API do seu fornecedor de domínio (Cloudflare, Route 53, entre outros), ou um registo TXT manual que adiciona você mesmo.
É no caminho manual que as pessoas ficam impacientes. A propagação varia mesmo — noventa segundos numa vez, quatro horas noutra, dependendo do TTL e da cache dos resolvers. A plataforma faz verificações periódicas, por isso adicione o registo e prossiga com o resto do seu dia. Se passar um dia inteiro sem verificação, raramente é propagação; é geralmente um erro de digitação no valor ou o registo colocado na zona errada (raiz em vez de subdomínio, ou vice-versa). Execute um `dig TXT` contra o que está realmente ativo antes de culpar a Google.
O caminho da chave de API salta tudo isso ao escrever o registo por si, mas significa dar a uma ferramenta terceira acesso de escrita ao seu DNS — e se esse DNS gerir tráfego de produção, não me parece descabido hesitar. O caminho manual custa alguns minutos à partida e garante que nunca mais tem de pensar nisso.
Analytics, e o intervalo de retenção que ninguém avisa
O Analytics liga-se por deteção em vez de verificação — a plataforma procura uma propriedade GA4 existente no domínio e liga-se se a sua conta de serviço tiver acesso, uma vez que as permissões do GA4 já são controladas do lado da Google. Pode criar uma propriedade se não existir nenhuma, mas só deixe fazer isso em sites genuinamente novos. Se migrou do Universal Analytics ou tem uma propriedade com anos de histórico, ligue-se explicitamente a essa. Uma propriedade nova com três dias de dados é um ponto de partida muito pior do que uma com nove anos e padrões sazonais já consolidados, e o ciclo de otimização depende desse histórico mais do que o fluxo de ligação dá a entender.
Aqui está o intervalo que apanha as pessoas desprevenidas: o Search Console faz um preenchimento retroativo de até dezasseis meses de dados de pesquisa na primeira sincronização, porque a Google mantém esse histórico do lado do servidor independentemente de quando se ligou. O GA4 não tem uma garantia equivalente — o seu preenchimento retroativo está limitado pela definição de retenção de dados da própria propriedade, e essa definição tem por predefinição dois meses, a menos que alguém na sua organização a tenha alterado. Assim, um domínio pode mostrar dezasseis meses de impressões e cliques no momento em que se liga, e dois meses de sessões, no mesmo dia exato, do mesmo processo de configuração. Isto não é uma falha de sincronização. É a predefinição de retenção da Google a fazer exatamente o que está configurada para fazer, e a correção — se quiser mais de dois meses a partir daqui — é alterar a janela de retenção diretamente nas definições da propriedade GA4, e não em nada do lado desta plataforma. Vale a pena verificar antes de ligar, não depois de ficar confuso com a discrepância.
Propriedades partilhadas e o que acontece depois
Mais uma particularidade do Analytics: se a sua organização gere uma única propriedade GA4 a recolher dados de cinco sites — comum quando alguém configurou o rastreamento há anos e ninguém o separou desde então — a ligação continua a funcionar bem, mas cada consulta é filtrada por nome de anfitrião nos bastidores. Não é uma caixa de verificação, nem algo que se possa desativar por acidente. É por isso que o painel mostra sempre os números deste domínio e nunca o total combinado da propriedade.
Assim que ambas as ligações forem estabelecidas, a sincronização corre diariamente num horário que controla (veja o capítulo sobre horários), e as análises de loja juntam-se automaticamente a tudo o que for construído na plataforma. A linha do domínio mostra pendente, parcial ou ativa — "parcial" significa que uma das duas ligações está ativa e a outra não, e essa é a sua deixa para ir verificar qual cartão está a vermelho em vez de confiar no estado agregado.
Onde é que isto realmente falha
Quase todos os pedidos de suporte que já vi caem em três categorias, nenhuma delas exótica. Um: a chave da conta de serviço é válida mas está associada ao projeto errado do Google Cloud, pelo que a verificação de permissão devolve vazio mesmo com a chave a carregar sem problemas. Dois: ninguém adicionou de facto o e-mail da conta de serviço — algo como [email protected] — como Leitor nas próprias definições de acesso do Search Console ou do GA4; carregar a chave na plataforma não lhe concede nada do lado da Google. Três, mais dissimulado: um domínio é religado sob uma nova conta de serviço depois de a antiga ser eliminada, mas o agendamento continua a falhar silenciosamente contra credenciais obsoletas durante uma semana antes de alguém reparar que os números pararam de atualizar.
Nenhum destes é um erro da plataforma — são o custo normal de um robô precisar de permissão em dois produtos Google separados, e o próprio modelo da Google não torna isso óbvio. Reserve quinze minutos para o seu primeiro domínio, não os dois minutos que o fluxo sugere. Todos os domínios seguintes são rápidos, porque tanto a credencial como o hábito adquirido transitam.
