Como o user ID do GA4 une visitas logadas entre dispositivos

O que é o user ID do GA4?

O Google Analytics 4 conta uma pessoa logada uma única vez entre sessões, dispositivos e plataformas quando o seu site envia um user ID do GA4, um identificador que o seu próprio sistema atribui no login e passa no parâmetro de configuração user_id. A página de ajuda do Google diz que o recurso permite "associate your own identifiers with individual users so you can connect their behavior across different sessions and on various devices and platforms." Envie o ID só para pessoas que fizeram login.

Sem ele, o GA4 conta dispositivos. A página de identidade de relatório do Google diz: "On websites, the device ID gets its value from the client ID", então a mesma pessoa em um celular e em um notebook aparece como dois usuários. Essa lacuna é um dos motivos pelos quais visualizações de página, sessões e usuários raramente batem entre ferramentas. Cada ferramenta define um "usuário" do seu jeito.

O Google coloca o user ID em primeiro lugar entre as suas fontes de identidade. A página de identidade de relatório afirma: "User-ID is the most accurate identity space, because it uses data you collect to identify your users." A precisão depende de quantos visitantes fazem login. Um site de conteúdo em que 5% dos leitores têm conta ganha pouco com ele, enquanto um app SaaS atrás de um login ganha muito.

Como enviar um user ID para o GA4?

Você envia um user ID para o GA4 adicionando user_id ao comando config em cada página, com um de três valores conforme o estado de login do visitante. O guia para desenvolvedores do Google define as regras:

O exemplo em gtag.js do Google é assim:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
}

Quando o ID só fica conhecido depois que a página carregou, como logo após um formulário de login, o Google recomenda gtag('set') no lugar, que "sets the user_id for all subsequent events on the page." Depois confirme que a propriedade lê o ID conferindo a identidade de relatório, explicada mais abaixo.

Quais regras um user ID do GA4 precisa seguir?

Um user ID do GA4 precisa ter 256 caracteres ou menos, ser único para uma pessoa, estável entre visitas e livre de qualquer coisa que um terceiro consiga usar para identificar essa pessoa. A página de ajuda do Google afirma: "Your user ID must not contain information that a third party could use to determine a user's identity", e diz que o uso do ID precisa seguir os Termos de Serviço do Google Analytics, "This includes avoiding the use of impermissible personally identifiable information." Não envie um endereço de e-mail puro nem um nome.

Mais quatro regras vêm das páginas de ajuda e para desenvolvedores do Google:

1. Use um ID real e único. O Google avisa que "Repeatedly setting a blank or dummy user ID can lead to inaccurate data (including permanent data loss)." Duas pessoas que compartilham um ID se fundem em um único usuário em todos os relatórios.
2. Envie null no logout, nunca uma string. O Google diz: "Don't send an empty string (""), a blank string (" "), or the quoted words "null" or "NULL"." As strings "undefined" e "null" contam como IDs reais.
3. Mantenha-o fora das dimensões personalizadas. O guia para desenvolvedores diz "Don't set custom dimensions based on user IDs" e acrescenta que user_id não deve ser definido como propriedade do usuário nem enviado como parâmetro de evento.
4. Mencione-o na sua política de privacidade. O Google lista "providing appropriate notice of your use of identifiers in your Privacy Policy" como parte da conformidade.

O ID de conta interno do seu banco de dados é a escolha segura, porque é estável e não significa nada fora do seu próprio sistema. Antes de colocá-lo no ar, compare-o com a lista de identificadores que contam como dados pessoais, porque um ID de conta estável ainda aponta para uma pessoa.

Como a identidade de relatório usa o user ID?

A identidade de relatório do GA4 decide se os relatórios usam o user ID, e só as opções Blended e Observed o leem. Você a define em Admin, em Data display, Reporting identity, e o Google descreve as três opções assim:

O Google diz que você pode "switch between the options at any time without making any permanent impact on data", porque a escolha muda os relatórios, não a coleta. Há uma contrapartida. O Google afirma que, com as duas primeiras opções, "your property must have enough activity from signed-in users to adequately obfuscate their identity. As a consequence your reports are subject to data thresholds." Se linhas começarem a sumir depois que você ativar o user ID, leia como o limite de dados do GA4 esconde linhas pequenas antes de concluir que a tag quebrou.

O que acontece com os eventos antes do login e depois do logout?

O GA4 associa um user ID aos eventos anteriores da mesma sessão assim que o ID é definido, e para de associá-lo aos eventos enviados depois do logout. O exemplo do Google é este: um visitante dispara os Events 1 e 2 sem ID, faz login e dispara o Event 3, depois faz logout e dispara o Event 4. "Events 1, 2, and 3 are now all associated with that user's ID", enquanto o Event 4 fica sem ID.

O preenchimento retroativo só alcança a sessão atual. O Google afirma: "Any data in your Analytics account collected and recorded prior to implementation won't be reprocessed and associated with a user ID." As visitas registradas antes de você colocar o user ID no ar nunca o recebem. E o Google acrescenta que "User-ID data collected in one property can't be shared or mixed with data in other properties", então um site de marketing e um app em duas propriedades não se unem.

O que dá para fazer com os dados de user ID no GA4?

Com os dados de user ID no GA4, você pode comparar usuários logados e deslogados, abrir a linha do tempo de um único usuário na exploração de usuário, criar públicos de remarketing e exportar linhas no nível do usuário para o BigQuery. A página de boas práticas do Google lista esses usos.

Dois detalhes de consentimento importam aqui. O Google afirma que, quando você coleta user IDs e vincula o BigQuery, "that information is exported to BigQuery regardless of the consent status of your users." E, para remarketing, "If you are using User-ID, then Analytics only includes the user identifier and the device identifier for the last device associated with each logged-in user."

O Flowsery identifica usuários entre dispositivos?

O Flowsery identifica um usuário logado quando o seu app chama flowsery.identify({ userId, email, name }) pelo SDK npm, mas no modo sem cookies ele não liga um visitante anônimo entre dias nem entre dispositivos. Depois dessa chamada, a API de visitantes do Flowsery devolve o userId, o nome e o email no campo profile do visitante, e esse campo é null para visitantes anônimos. O modo sem cookies funciona de outro jeito. A página inicial do Flowsery diz "Visitor IDs are hashed and rotate daily", e a página de tracking sem cookies diz: "Visitors are grouped into sessions using anonymized, salted hashes that rotate daily. No persistent IDs ever leave the device." Como o hash muda todo dia, uma pessoa anônima que visita pelo celular hoje e pelo notebook amanhã aparece como dois visitantes. O guia de tracking sem cookies explica como as ferramentas sem cookies contam visitantes sem um ID armazenado. Assim como o user ID do GA4, a chamada identify do Flowsery usa um ID que o seu próprio sistema atribui no login, então só cobre pessoas logadas.

Perguntas frequentes

Posso usar um endereço de e-mail como user ID do GA4?

Não. O Google afirma que o user ID "must not contain information that a third party could use to determine a user's identity" e pede que você evite informações de identificação pessoal não permitidas. Use um ID de conta interno do seu banco de dados no lugar.

Qual é o tamanho máximo de um user ID do GA4?

Um user ID precisa ter 256 caracteres ou menos. O Google indica o mesmo limite na página de ajuda do User-ID e na tabela de limites de coleta de eventos.

Devo registrar user_id como dimensão personalizada?

Não. O guia para desenvolvedores do Google diz "Don't set custom dimensions based on user IDs", porque os valores únicos causam alta cardinalidade, o que prejudica a precisão dos relatórios. Use a identidade de relatório e a exploração de usuário para trabalhar com dados no nível do usuário.

O que devo enviar quando um usuário faz logout?

Envie null. O Google diz para não enviar uma string vazia, uma string em branco nem as palavras "null" ou "NULL" entre aspas. Para visitantes que nunca fizeram login, não envie o parâmetro.

O GA4 aplica o user ID a dados anteriores à configuração?

Não. O Google afirma que os dados coletados antes da implementação "won't be reprocessed and associated with a user ID." Dentro de uma sessão, os eventos enviados antes do login passam a ter o ID assim que ele é definido.

Por que meus relatórios do GA4 perderam linhas depois que ativei o user ID?

O Google afirma que as identidades de relatório Blended e Observed deixam os relatórios "subject to data thresholds" quando a atividade de usuários logados é baixa demais "to adequately obfuscate their identity." O Google também diz que trocar a identidade de relatório não tem efeito permanente nos dados, então você pode comparar o mesmo relatório em Device based para ver o que o limite removeu.

Como o GA4 conta uma pessoa no celular e no notebook?

Só quando as duas visitas enviam o mesmo user ID. Sem ele, o GA4 pega o ID do dispositivo a partir do client ID nos sites, então o celular e o notebook aparecem como dois usuários. Se o ID for enviado após o login nos dois dispositivos e a identidade de relatório for Blended ou Observed, o GA4 conta uma pessoa.

Devo enviar o user ID com gtag config ou gtag set?

Use config com user_id em cada página quando o ID já é conhecido no carregamento. Use gtag('set') quando o ID só aparece depois do carregamento, como logo após um formulário de login, porque ele "sets the user_id for all subsequent events on the page." Nos dois casos, envie null após o logout.

Qual identidade de relatório do GA4 usa o user ID?

Blended e Observed usam as duas. Blended segue a ordem user ID, ID do dispositivo e modelagem, e Observed vai do user ID ao ID do dispositivo. Device based usa só o ID do dispositivo e ignora o user ID. Você pode alternar entre as opções a qualquer momento, sem impacto permanente nos dados.

Posso juntar os dados de user ID do GA4 com o meu CRM?

Sim, pela exportação para o BigQuery, que traz user_pseudo_id e user_id. Quando você coleta user IDs e vincula o BigQuery, essa informação é exportada independentemente do status de consentimento dos seus usuários. Confira isso com a sua política de privacidade antes de montar a junção.