Google Analytics Avançado (v4)

[AJ_Quick]

	Resumo	Rastreamento avançado de eventos do Google Analytics 4 para Discourse
	Link do Repositório	https://github.com/multidimension-al/discourse-google-analytics
	Guia de Instalação	Como instalar plugins no Discourse

O núcleo do Discourse envia ao Google Analytics um único page_view por navegação. Este plugin adiciona eventos para tempo de leitura, progresso de leitura e conclusão, e pode assumir opcionalmente a responsabilidade pelas visualizações de página, de modo a excluir rotas de mensagens privadas e de administração.

POR QUE NÃO USAR A TAG DE ANALÍTICAS SEO/GA INTEGRADA?

Você pode, e para muitos fóruns isso é suficiente. A tag do núcleo funciona, e este plugin opera em cima dela, em vez de substituí-la.

A diferença está no que é medido. Um page_view informa que uma URL foi carregada. Ele não pode dizer se alguém leu o que estava nela, de modo que uma leitura de vinte minutos de um tópico longo e um “bounce” instantâneo parecem idênticos nos seus relatórios. Este plugin mede quanto tempo alguém realmente leu, até onde chegou no tópico e se chegou ao final. Esses são os sinais que valem a pena para tomar decisões de conteúdo e os que tornam uma audiência de remarketing digna de ser construída.

Os próprios relatórios do Discourse (Administração → Relatórios) são um sistema separado e permanecem o melhor lugar para métricas internas. Isso se trata apenas do que chega ao Google Analytics.

Recursos

• 13 eventos da comunidade: visualizações de tópico, engajamento e marcos de progresso de leitura, conclusão de leitura, resumos por visita, busca, registro, login, criação de tópico, respostas, curtidas, marcadores
• Leitura medida em relação ao fluxo de publicações e tempo de atenção, não profundidade de rolagem
• Dois modos: estender a tag existente do núcleo ou assumir a tag e as visualizações de página
• Mensagens privadas, categorias restritas e rotas de administração não geram eventos
• Títulos de tópicos e termos de busca desativados por padrão
• Tráfego de funcionários marcável como tráfego interno do GA4, por grupo
• Página de diagnóstico e avisos no painel de administração para configuração incorreta

Configuração

1. Instalar

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/multidimension-al/discourse-google-analytics.git

Depois execute ./launcher rebuild app.

2. Escolha um modo. Administração → Configurações → Google Analytics 4.

Extensão do Núcleo (padrão) — o núcleo mantém a tag e as visualizações de página, e o plugin adiciona eventos por cima. Defina o ga universal tracking code do núcleo para o seu G-XXXXXXXXXX e o ga version para v4_gtag.

Gerenciado — o plugin assume a tag e as visualizações de página, o que permite excluir rotas de MP e administração. Limpe o ga universal tracking code do núcleo, defina o ga4 integration mode para managed e coloque seu ID em ga4 measurement id.

3. Ative discourse ga4 enabled.

4. Opcional — tráfego interno. ga4 internal traffic groups padrão para administradores e moderadores. Ele só tem efeito depois que você criar o filtro correspondente no GA4 em Administração → Configurações de dados → Filtros de dados → Tráfego interno, correspondendo a traffic_type igual a internal.

5. Verifique. Administração → Plugins → Google Analytics → Diagnóstico.

Para mover uma configuração existente de Extensão do Núcleo para Gerenciado, use Adotar configuração GA do Discourse existente na página de Diagnóstico, em vez de editar as configurações manualmente.

Configurações

Nome	Descrição
discourse ga4 enabled	Ativa o plugin. Desativado por padrão.
ga4 integration mode	core_extension (o núcleo possui a tag) ou managed (o plugin possui a tag).
ga4 measurement id	ID de Medição do GA4, para o modo gerenciado.
ga4 track page views	Envia page_view. Apenas no modo gerenciado.
ga4 track topic views	Envia discourse_topic_view uma vez por visita ao tópico.
ga4 track topic engagement	Envia discourse_topic_engaged em marcos de tempo de leitura.
ga4 engagement milestones	Segundos de leitura ativa em que disparar. Padrão 10|30|60|180.
ga4 track topic progress	Envia discourse_topic_progress em marcos de posição de leitura.
ga4 progress milestones	Porcentagens do tópico em que disparar. Padrão 25|50|75|100.
ga4 track read completion	Envia discourse_topic_read_complete quando um leitor chega ao final.
ga4 read complete min seconds	Tempo mínimo de leitura antes que o final conte como conclusão.
ga4 track read summaries	Envia discourse_topic_read_summary quando um leitor sai de um tópico.
ga4 read summary min seconds	Abaixo disso, uma visita é tratada como um “bounce” e não é resumida.
ga4 track search	Envia search quando uma busca em página completa retorna resultados.
ga4 track registration	Envia sign_up após a criação de uma conta.
ga4 track login	Envia login após um login bem-sucedido. Desativado por padrão.
ga4 track topic creation	Envia discourse_topic_created.
ga4 track replies	Envia discourse_reply_created.
ga4 track likes	Envia discourse_post_liked. Remover uma curtida não envia nada.
ga4 track bookmarks	Envia discourse_bookmark_created.
ga4 send search terms	Também envia o que foi pesquisado. Desativado por padrão — buscas em fóruns frequentemente contêm informações pessoais.
ga4 send page titles	Inclui o título da página. Desativado por padrão — em uma rota de tópico, este é o título do tópico.
ga4 track private message activity	Um evento agregado de MP sem identificadores. Desativado por padrão.
ga4 login required is restricted	Em um fórum que exige login, retém identificadores de tópico e categoria.
ga4 send trust level	Inclui o nível de confiança 0–4 como um parâmetro de evento.
ga4 internal traffic groups	Membros desses grupos são marcados como traffic_type=internal. Padrão: administradores, moderadores.
ga4 suppress in embed	Não envia nada no modo incorporado.
ga4 debug mode	Registra eventos e decisões de supressão no console do navegador.

Notas

• No modo Extensão do Núcleo, o núcleo ainda possui as visualizações de página, então URLs de MP e títulos de tópicos ainda são enviados. Apenas o modo Gerenciado muda isso.
• Não registre topic_id como uma dimensão personalizada do GA4 — ele é ilimitado e atingirá os limites de cardinalidade da propriedade.
• O próprio Discourse em Administração → Relatórios → Buscas em Alta registra cliques, então ele informa quais buscas falharam. O GA4 não pode. É por isso que ga4 send search terms está desativado por padrão.