Como configurar o agrupamento de conteúdo do GA4 com um parâmetro

O que é o agrupamento de conteúdo do GA4?

O Google Analytics 4 faz o agrupamento de conteúdo do GA4 por meio de um único parâmetro de evento, content_group, que a sua tag envia com os eventos de uma página para que a dimensão Content group mostre as páginas em grupos com os nomes que você escolher. A página de ajuda do Google sobre grupos de conteúdo diz que eles "let you categorize pages and screens into custom buckets" para que você possa "see metrics for related groups of information." O exemplo do Google coloca as páginas de roupas masculinas em um grupo e as de roupas femininas em outro. Use o recurso quando um relatório com centenas de URLs soltas esconde a pergunta que você realmente faz, como o desempenho do blog em comparação com a documentação ou com as páginas de preços.

As páginas de ajuda atuais do Google chamam o recurso de "content groups". Content grouping é o nome antigo que as pessoas ainda pesquisam, e ele descreve a mesma tarefa: um rótulo de categoria por página.

O esquema da Data API define a dimensão em uma linha: Content group é "A category that applies to items of published content. Populated by the event parameter content_group." Essa segunda frase é todo o mecanismo. O GA4 não lê a estrutura das suas URLs nem as categorias do seu CMS. Ele mostra a string que a sua tag enviou nesse parâmetro, e nada quando a tag não enviou nada.

Como definir o content_group com a tag do Google?

Você configura o agrupamento de conteúdo do GA4 com a tag do Google adicionando content_group ao comando config de cada página, com o nome do grupo como valor. A página de ajuda do Google dá este padrão para uma página de roupas masculinas:

gtag('config', 'G-XXXXXX', {
  'content_group': 'mens'
});

Uma página de roupas femininas recebe o mesmo código com 'womens'. A referência do config do gtag documenta uma segunda forma, que define o valor para todos os streams da página, gtag('set', 'content_group', '/news/sports'), ao lado da forma para um único stream, gtag('config', 'STREAM_ID', { 'content_group': '/news/sports' }).

A ordem importa. A referência do config diz que send_page_view vem como true por padrão, então o snippet padrão envia um page_view assim que o config roda. Coloque o valor de content_group dentro dessa chamada de config, ou chame set antes dela, para que o page_view leve o grupo. Na prática, a fonte mais limpa para o valor é o template da página: o CMS já sabe se uma página é um post do blog, uma página de documentação ou uma página de produto, então escreva isso no snippet no lado do servidor.

Como definir grupos de conteúdo no Google Tag Manager?

Você define grupos de conteúdo no Google Tag Manager com uma variável RegEx Table que compara o caminho da página e devolve um nome de grupo, e depois passa essa variável como o campo content_group da sua tag do GA4. A página de ajuda do Google divide o processo em duas fases.

1. No Google Tag Manager, vá em Variables e clique em New, em User-Defined Variables.
2. Escolha Variable Configuration, depois Regex Table, e dê à variável o nome "Content Group".
3. Defina a Input Variable como {{Page Path}}.
4. Adicione uma linha por grupo, com uma expressão regular como padrão e o nome do grupo como saída.
5. Selecione Set Default Values e digite "Other group" como valor padrão para quando nada corresponder.
6. Em Advanced Settings, desmarque Full Matches Only e Enable Capture Groups and Replace Functionality, e salve.
7. Abra a sua tag do GA4, que a página do Google chama de tag "Google Analytics: GA4 Configuration", e em Fields to Set adicione uma linha com Field Name content_group e Value {{Content Group}}.
8. Salve e publique o contêiner.

A tabela de exemplo do Google associa /mens a "Men's clothing page" e /womens a "Women's clothing page." Com Full Matches Only desmarcado, um padrão como /mens é uma correspondência parcial, então também pega um caminho como /blog/mens-style. Teste cada padrão com as suas URLs reais no modo Preview antes de publicar.

Cada variável e cada campo que você adiciona é mais uma linha para conferir quando você audita um contêiner do GTM, então mantenha a tabela curta.

A etapa 5 é a que as pessoas pulam, e ela compensa. Um valor padrão faz com que toda página tenha algum grupo, então as páginas que não correspondem a nenhuma regra aparecem como "Other group" em vez de ficarem sem grupo.

Qual método de configuração combina com o seu site?

O método certo depende de onde ficam as categorias das suas páginas: nos templates, nos caminhos das URLs ou no código do app. O Google documenta três métodos.

As regras por caminho no Tag Manager são as mais rápidas de colocar no ar, e quebram no dia em que alguém muda a estrutura das URLs. Os valores definidos no template com gtag tomam tempo de um desenvolvedor uma vez e depois acompanham o conteúdo para onde ele for. Escolha o método que corresponde ao lugar onde está a verdade sobre cada página.

Onde os grupos de conteúdo aparecem nos relatórios do GA4?

Os grupos de conteúdo aparecem na dimensão Content group, que o Google diz que você seleciona no relatório Pages and screens ou adiciona a uma exploração. No relatório Pages and screens, escolher Content group como dimensão mostra uma linha por grupo em vez de uma linha por página. Em uma exploração, adicione Content group como dimensão e combine-a com métricas como views, ou com o caminho da página para ver quais URLs ficam em cada grupo. Uma linha de grupo responde a perguntas sobre seções. Para uma página só, uma análise de landing page que parte das páginas de entrada responde mais.

Leia as métricas de grupo com o mesmo cuidado das métricas de página. As views de um grupo são contagens de page_view, enquanto sessões e usuários são contados de outra forma. A diferença está explicada em pageviews vs sessões vs usuários, e vale para uma linha de grupo exatamente como vale para uma página.

Os grupos de conteúdo cobrem apenas os dados coletados depois que você adiciona o parâmetro. A dimensão é preenchida pelo parâmetro de evento, e a página de ajuda do Google não descreve nenhuma forma de atribuir grupos a eventos enviados sem ele. Publique a mudança na tag antes do início do período que interessa a você.

Por que a dimensão Content group mostra (not set)?

A dimensão Content group mostra (not set) em dois casos que o Google documenta: quando você a combina com eventos coletados automaticamente, como session_start e first_visit, e quando um evento envia content_group com valor vazio. O artigo do Google sobre (not set) explica o primeiro caso: "automatically collected events don't accept the content_group parameter. Thus, there's no valid data for this combination." Para o segundo, ele dá o exemplo content_group: "".

Esse segundo caso é uma exceção que vale guardar. Na maioria das dimensões, um valor vazio aparece em branco, e só um valor ausente aparece como (not set). Content group mostra os dois como (not set), como explicado em not set no GA4. Daí saem duas correções:

• Não leia Content group junto com contagens de session_start ou first_visit. Combine a dimensão com métricas baseadas em page_view.
• Nunca envie uma string vazia. Defina um grupo padrão, como o "Other group" do Google, para as páginas que não correspondem a nenhuma regra.

Como adicionar mais de um grupo de conteúdo?

Você adiciona mais grupos de conteúdo criando seus próprios parâmetros personalizados, como content_group2 e content_group3, e registrando cada um como dimensão personalizada. O exemplo do Google usa um grupo de nível superior para Men's clothing, depois content_group2 para Apparel e content_group3 para Shirts.

Só o content_group alimenta a dimensão Content group nativa. Os níveis extras são dimensões personalizadas comuns com escopo de evento, então cada um gasta uma vaga da cota explicada em dimensões personalizadas do GA4, e cada um começa vazio até o parâmetro ser enviado e a dimensão ser registrada. Mantenha a cardinalidade baixa: alguns poucos nomes de seção dividem um relatório com clareza, enquanto um valor por artigo transforma o grupo em uma segunda cópia do caminho da página.

Como o Flowsery mostra páginas sem um parâmetro de grupo de conteúdo?

O Flowsery mostra as páginas diretamente a partir do seu script, com páginas mais visitadas, páginas de entrada e filtros por página, fonte, campanha ou meta, e os funis dele são montados a partir de "the pages or events" que você escolhe como etapas. A página de analytics de landing page descreve a comparação de "pages by qualified visits, conversion rate, drop-off point, and revenue." O tracking de receita do Flowsery atribui as compras às campanhas, páginas e referenciadores que as geraram. As páginas de produto do Flowsery não citam um parâmetro de grupo de conteúdo, então a forma de comparar seções ali é filtrar por página ou adicionar essas páginas como etapas de funil, não enviar um rótulo de categoria.

Perguntas frequentes

O agrupamento de conteúdo está disponível no GA4?

Sim. O GA4 chama o recurso de content groups e o faz funcionar com o parâmetro de evento content_group. Você define o parâmetro na tag do Google, no Google Tag Manager ou em um evento screen_view do Firebase, e lê o valor na dimensão Content group.

Onde encontro os grupos de conteúdo no GA4?

Selecione a dimensão Content group no relatório Pages and screens ou adicione-a a uma exploração. A dimensão só contém valores de eventos que levaram o parâmetro content_group.

Por que meu grupo de conteúdo do GA4 mostra (not set)?

O Google documenta duas causas. A dimensão mostra (not set) quando combinada com eventos coletados automaticamente, como session_start e first_visit, que não aceitam o parâmetro. Ela também mostra (not set) quando um evento envia content_group como string vazia.

Os grupos de conteúdo do GA4 valem para dados antigos?

A dimensão Content group é preenchida pelo parâmetro de evento content_group, então os eventos enviados antes de você adicionar o parâmetro não têm grupo. A página de ajuda do Google não descreve nenhuma forma de atribuir grupos depois. Adicione o parâmetro antes do período sobre o qual você quer gerar relatórios.

Quantos grupos de conteúdo o GA4 pode ter?

O GA4 tem uma única dimensão Content group nativa, alimentada por content_group. Para mais níveis, o Google diz para criar parâmetros personalizados como content_group2 e content_group3 e registrá-los como dimensões personalizadas. Cada um usa uma vaga de dimensão personalizada.

Posso definir grupos de conteúdo do GA4 sem editar código?

Sim, com o Google Tag Manager. Crie uma variável RegEx Table em {{Page Path}}, defina um valor padrão como "Other group" e adicione-a como campo content_group na sua tag do GA4. Publique o contêiner para começar a enviá-lo.

O que é o parâmetro content_group no GA4?

É o parâmetro de evento que preenche a dimensão Content group. Sua tag o envia com os eventos de uma página, e o GA4 informa a string que ele carrega. O GA4 não lê a estrutura das suas URLs nem as categorias do seu CMS.

Agrupamento de conteúdo é o mesmo que grupos de conteúdo no GA4?

É o mesmo recurso com dois nomes. As páginas de ajuda atuais do Google dizem "content groups", e content grouping é o nome antigo que as pessoas ainda pesquisam. Nos dois casos, é um rótulo de categoria por página, definido pelo parâmetro content_group.

O agrupamento de conteúdo do GA4 funciona em aplicativos móveis?

Sim. Com o SDK do Firebase, você envia o parâmetro content_group em um evento screen_view. A página do Google sobre grupos de conteúdo não traz exemplo de código para isso, e você lê o resultado no relatório Pages and screens.

Por que meu grupo de conteúdo do Tag Manager bate com as páginas erradas?

Com Full Matches Only desmarcado, um padrão da RegEx Table é uma correspondência parcial. Um padrão como /mens também captura um caminho como /blog/mens-style. Teste cada padrão com suas URLs reais no modo Preview antes de publicar.