Como definir propriedades de usuário do GA4 e usá-las em relatórios

O que são as propriedades de usuário do GA4?

O Google Analytics 4 usa as propriedades de usuário do GA4 para descrever a pessoa por trás dos eventos, como o nível do plano, o idioma preferido ou a função, e aplica cada valor a todos os eventos posteriores desse usuário. A página de ajuda do Google as define como "attributes that describe groups of your user base", com preferências de idioma e localizações geográficas como exemplos. Use-as para fatos que valem em muitos eventos e deixe os detalhes de cada ação nos parâmetros de evento.

Uma propriedade de usuário só aparece nos relatórios depois que você a registra como dimensão personalizada com escopo de usuário. O Google diz isso com todas as letras: "To report on the data you collect through user properties, create user-scoped custom dimensions." A página de ajuda sobre dimensões personalizadas acrescenta que "User properties become aliases for user-scoped custom dimension slots", então você trabalha com nomes que fazem sentido, como customer_tier, em vez de vagas numeradas.

O GA4 também preenche sozinho um conjunto de dimensões de usuário, como Country, Language e Device category. Essas dimensões predefinidas cobrem os casos comuns. As propriedades de usuário personalizadas servem para fatos que só o seu site conhece, como se um visitante está em um plano gratuito ou pago.

Qual é a diferença entre propriedades de usuário e parâmetros de evento?

As propriedades de usuário descrevem o usuário e seguem para os eventos futuros, enquanto os parâmetros de evento descrevem um evento e param nele. A página do Google sobre dimensões personalizadas traça a linha em duas frases: os parâmetros de evento "provide more details about these actions, like which link was clicked", e "User properties tell you more about the users themselves."

O limite de 36 caracteres no valor pede rótulos curtos de categoria, não texto livre. Se você ainda está decidindo quais dados merecem uma vaga, comece pelas decisões que eles devem orientar, como mostra o guia de implementação de analytics personalizado.

Como definir propriedades de usuário com gtag?

Você define propriedades de usuário com a Google tag chamando o comando set com um objeto user_properties, que aplica os valores a todos os eventos da página. A página de ajuda do Google dá este exemplo:

gtag('set', 'user_properties', {
  favorite_composer: 'Mahler',
  favorite_instrument: 'double bass',
  season_ticketholder: 'true'
});

Para limitar os valores a um único fluxo de dados, o Google mostra o mesmo objeto dentro de um comando config: gtag('config', 'STREAM_ID', { 'user_properties': { ... } }). Execute a chamada assim que a página souber o valor, por exemplo logo depois do login.

A página de ajuda do Google lista mais duas formas de defini-las:

1. Google Tag Manager. Em uma tag Google Analytics 4 Event, "add a row in the User Properties section for each parameter you want to include."
2. Firebase para apps mobile. Depois de instalar o SDK do Google Analytics for Firebase, siga a documentação "Set user properties" do Firebase.

O código do servidor pode enviar propriedades de usuário pelo Measurement Protocol em um objeto user_properties, em que cada propriedade tem um campo value. O guia para desenvolvedores do Google observa que dá para enviar propriedades de usuário sem nenhum evento e que "Google Analytics uses the most recent value of a user property for each user."

Como usar uma propriedade de usuário do GA4 em relatórios?

Você usa uma propriedade de usuário do GA4 em relatórios criando uma dimensão personalizada com escopo de usuário em Admin, em Data display, Custom definitions, com o papel de Editor ou superior na propriedade. O procedimento do Google:

1. Em Admin, em Data display, clique em Custom definitions.
2. Abra a aba Custom dimensions e clique em Create custom dimensions.
3. Digite um nome para a dimensão. Hífens não são permitidos, mas sublinhados e espaços são.
4. Defina Scope como User. O Google diz que o escopo não pode ser alterado depois de salvo.
5. Digite o nome da propriedade de usuário exatamente como o seu código o envia. Esse campo também fica fixo depois de salvo.
6. Clique em Save.

As páginas do Google discordam sobre a ordem. A página sobre coleta de dados de usuário diz para criar a dimensão "Before you set user properties", enquanto a página sobre a criação da dimensão diz para adicionar a propriedade ao código primeiro e confirmá-la no card "Users by User property" do relatório Realtime. O Google diz que a dimensão chega aos relatórios depois de 24 a 48 horas, então registre-a no mesmo dia em que a propriedade entra no ar. Depois que ela existe, você pode usá-la em comparações, filtros, explorações e condições de públicos.

Quais limites se aplicam às propriedades de usuário do GA4?

Uma propriedade padrão do GA4 aceita 25 propriedades de usuário e uma propriedade do Google Analytics 360 aceita 100, com nomes de até 24 caracteres e valores de até 36 caracteres. A página de limites de coleta do Google afirma que o Analytics "doesn't process the 26th user property" em uma propriedade padrão.

Os nomes seguem mais três regras do guia para desenvolvedores e das páginas de ajuda do Google:

• Nomes reservados. first_open_time, first_visit_time, last_deep_link_referrer, user_id e first_open_after_install não podem ser usados.
• Prefixos reservados. Os nomes não podem começar com google_, ga_ ou firebase_.
• Diferença entre maiúsculas e minúsculas. O Google avisa que "setting two user properties whose names differ only in case results in two distinct user properties being logged."

Uma quarta armadilha está na dimensão personalizada. O Google diz que "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text." Um código de nível como 94E40 vira notação científica, então comece os códigos com uma letra.

Quais propriedades de usuário o GA4 coleta automaticamente?

O GA4 coleta automaticamente um conjunto de dimensões de usuário predefinidas, e o Google diz que, com gtag.js ou o SDK, "you don't need to write additional code to collect" essas dimensões. Em sites, elas incluem Age, Gender, Interests, Language, Country, Region, City, Browser, Device category, Device brand, Operating system e Platform. Os fluxos de app acrescentam App store, App version, Device model e New/Established.

Não gaste uma das suas 25 vagas copiando essas dimensões. A página do Google sobre dimensões personalizadas com escopo de usuário diz: "Don't create a custom user property if a predefined user dimension already exists."

Age, Gender e Interests têm um porém. O Google diz que você "must meet the Analytics data thresholds to see demographic and interest data", e o Google retém essas linhas quando um grupo é pequeno o bastante para identificar pessoas. A página sobre limite de dados do GA4 explica quando isso acontece e o que reduz o problema.

Quando uma propriedade de usuário do GA4 começa a valer?

Uma propriedade de usuário do GA4 vale a partir do momento em que é definida para todos os eventos futuros desse usuário, inclusive em sessões posteriores, e nunca para eventos anteriores. Nas palavras do Google: "The user property will not apply to events that happened before the user property was set."

Se um visitante lê cinco páginas e só depois recebe customer_tier no cadastro, essas cinco visualizações de página ficam sem nível. Defina a propriedade em cada carregamento de página de um usuário logado.

O GA4 também remove duplicatas. O Google diz que o Analytics coleta uma propriedade de usuário quando ela é "set for the first time on a page" ou quando o valor muda, então repetir a mesma chamada set em uma página não envia dados extras.

As propriedades de usuário do GA4 podem conter dados pessoais?

As propriedades de usuário do GA4 não podem conter informações de identificação pessoal, porque a política do Google proíbe o envio desse tipo de dado. A página de ajuda do Google afirma que suas "policies mandate that no data be passed to Google that Google could use or recognize as personally identifiable information (PII)" e cita "email addresses, personal mobile numbers, and social security numbers" como exemplos. A lista de recursos que exigem cuidado especial inclui "All custom dimensions", o que abrange toda propriedade de usuário registrada.

Limite os valores a categorias como pro, trial ou admin. Para um identificador de conta estável, o Google indica o recurso User-ID em vez de uma propriedade de usuário, e a página sobre dimensões personalizadas desaconselha "a custom dimension for a unique ID per user." Mesmo um ID que não nomeia ninguém ainda pode contar como dado pessoal pela legislação de privacidade, como explica o guia sobre identificadores de analytics e dados pessoais.

Como o Flowsery anexa detalhes a um usuário logado?

O Flowsery anexa detalhes a um usuário logado com uma única chamada identify(), que a documentação do SDK descreve como uma forma de "Identify the current visitor with user details." O exemplo documentado passa um ID de usuário, e-mail e nome: flowsery.identify({ userId: 'user_123', email: 'user@example.com', name: 'John Doe' }). A API de visitantes do Flowsery então devolve o ID, o nome e o e-mail desse usuário em um campo de perfil, que fica nulo para visitantes anônimos. O tráfego anônimo funciona de outro jeito. Com a opção "Cookieless", o Flowsery roda com um hash de visitante que muda todo dia e não guarda dados pessoais, então não liga um visitante anônimo entre dias ou dispositivos. Os eventos personalizados aceitam metadados opcionais: a tag de script registra um com window.flowsery("signup") e o SDK npm com flowsery.trackEvent('signup'), como parte do tracking de metas e eventos do Flowsery. Os eventos aparecem no feed de eventos em tempo real do Flowsery assim que disparam, sem nenhuma etapa de registro no meio.

Perguntas frequentes

Qual é a diferença entre uma propriedade de usuário e uma dimensão personalizada com escopo de usuário?

Uma propriedade de usuário é o valor que o seu código envia, como customer_tier. Uma dimensão personalizada com escopo de usuário é o registro no Admin do GA4 que torna essa propriedade visível nos relatórios. Você precisa das duas, e o Google diz que a dimensão chega aos relatórios 24 a 48 horas depois de criada.

Quantas propriedades de usuário uma propriedade do GA4 pode ter?

Uma propriedade padrão pode ter 25 propriedades de usuário e uma propriedade do Google Analytics 360 pode ter 100. O Analytics não processa a 26ª propriedade de usuário em uma propriedade padrão. As dimensões personalizadas com escopo de usuário seguem os mesmos tetos de 25 e 100.

As propriedades de usuário do GA4 valem para eventos passados?

Não. O Google diz que uma propriedade de usuário vale para todos os eventos futuros desse usuário, inclusive em sessões posteriores, mas "will not apply to events that happened before the user property was set." Defina a propriedade assim que souber o valor.

Como mudar uma propriedade de usuário do GA4?

Envie a propriedade de novo com o valor novo. O guia para desenvolvedores do Google diz que o Analytics "uses the most recent value of a user property for each user", e o GA4 coleta a propriedade de novo sempre que o valor muda. Os eventos anteriores mantêm o valor que tinham quando foram enviados.

Posso usar user_id como nome de propriedade de usuário?

Não. user_id é um dos cinco nomes reservados, junto com first_open_time, first_visit_time, last_deep_link_referrer e first_open_after_install. Os nomes também não podem começar com google_, ga_ ou firebase_. Use o recurso User-ID para IDs de conta.

Onde verifico se uma propriedade de usuário está chegando?

Abra o relatório Realtime e olhe o card "Users by User property". O Google diz que o card "shows the number of people who are grouped into each user property." Confirme a propriedade ali antes de montar relatórios com ela.

Posso definir propriedades de usuário do GA4 no Google Tag Manager?

Sim. Em uma tag Google Analytics 4 Event, adicione uma linha na seção User Properties para cada propriedade que quiser enviar. Depois registre cada uma como dimensão personalizada com escopo de usuário, ou ela não aparecerá nos relatórios.

Por que minha propriedade de usuário do GA4 não aparece nos relatórios?

Uma propriedade de usuário fica fora dos relatórios até que a dimensão personalizada dela exista e tenha terminado de ser processada. O Google informa que a dimensão chega aos relatórios de 24 a 48 horas após a criação. Confira se o escopo é User e se o nome da propriedade é exatamente o que o seu código envia, pois os dois ficam fixos depois de salvos.

Uma propriedade de usuário do GA4 pode conter um e-mail?

Não. A política do Google proíbe enviar dados que ela possa reconhecer como informações de identificação pessoal e cita endereços de e-mail como exemplo. Mantenha os valores em categorias curtas como pro, trial ou admin.

Devo criar uma propriedade de usuário para Country ou Language?

Não precisa. O GA4 já coleta dimensões de usuário predefinidas como Country, Language e Device category, e o Google orienta a não criar uma personalizada se uma predefinida já cobre o dado. Guarde suas 25 vagas para informações que só o seu site conhece.