Google Analytics avanzado (v4)

[AJ_Quick]

	Resumen	Seguimiento avanzado de eventos de Google Analytics 4 para Discourse
	Enlace al repositorio	https://github.com/multidimension-al/discourse-google-analytics
	Guía de instalación	Cómo instalar plugins en Discourse

El núcleo de Discourse envía a Google Analytics una única page_view por navegación. Este plugin añade eventos para el tiempo de lectura, el progreso de lectura y la finalización, y puede asumir opcionalmente la propiedad de las vistas de página para excluir las rutas de mensajes privados y administración.

¿POR QUÉ NO USAR LA ETIQUETA DE ANALÍTICAS SEO/GA INTEGRADA?

Puedes hacerlo, y para muchos foros es suficiente. La etiqueta del núcleo funciona, y este plugin se ejecuta sobre ella en lugar de reemplazarla.

La diferencia radica en lo que se mide. Una page_view te indica que se cargó una URL. No puede decirte si alguien leyó lo que había en ella, por lo que una lectura de veinte minutos de un tema largo y una rebote instantáneo se ven idénticos en tus informes. Este plugin mide cuánto tiempo leyó realmente alguien, hasta dónde llegó en el tema y si alcanzó el final. Esas son las señales valiosas para tomar decisiones de contenido, y las que hacen que valga la pena construir una audiencia de remarketing.

Los propios informes de Discourse (Administración → Informes) son un sistema separado y siguen siendo el mejor lugar para las métricas internas. Esto solo se trata de lo que llega a Google Analytics.

Características

• 13 eventos de la comunidad: vistas de temas, hitos de interacción y progreso de lectura, finalización de lectura, resúmenes por visita, búsqueda, registro, inicio de sesión, creación de temas, respuestas, me gusta y marcadores
• La lectura se mide en función del flujo de publicaciones y el tiempo de atención, no la profundidad de desplazamiento
• Dos modos: extender la etiqueta existente del núcleo, o poseer la etiqueta y las vistas de página
• Los mensajes privados, las categorías restringidas y las rutas de administración no generan ningún evento
• Los títulos de temas y los términos de búsqueda están desactivados por defecto
• El tráfico del personal puede marcarse como tráfico interno de GA4, por grupo
• Página de diagnóstico y advertencias en el panel de administración para configuraciones incorrectas

Configuración

1. Instalar

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

Luego ejecuta ./launcher rebuild app.

2. Elige un modo. Administración → Ajustes → Google Analytics 4.

Extensión del núcleo (predeterminado) — el núcleo conserva la etiqueta y las vistas de página, y el plugin añade eventos encima. Establece el ga universal tracking code del núcleo en tu G-XXXXXXXXXX y ga version en v4_gtag.

Gestionado — el plugin posee la etiqueta y las vistas de página, lo que le permite excluir las rutas de MP y administración. Borra el ga universal tracking code del núcleo, establece ga4 integration mode en managed y coloca tu ID en ga4 measurement id.

3. Activa discourse ga4 enabled.

4. Opcional — tráfico interno. ga4 internal traffic groups tiene por defecto a administradores y moderadores. Solo surte efecto una vez que crees el filtro correspondiente en GA4 bajo Administración → Configuración de datos → Filtros de datos → Tráfico interno, coincidiendo traffic_type con internal.

5. Verifica. Administración → Plugins → Google Analytics → Diagnóstico.

Para pasar una configuración existente de Extensión del núcleo a Gestionado, usa Adoptar configuración GA de Discourse existente en la página de Diagnóstico en lugar de editar los ajustes a mano.

Ajustes

Nombre	Descripción
discourse ga4 enabled	Habilita el plugin. Desactivado por defecto.
ga4 integration mode	core_extension (el núcleo posee la etiqueta) o managed (el plugin la posee).
ga4 measurement id	ID de medición de GA4, para el modo gestionado.
ga4 track page views	Enviar page_view. Solo modo gestionado.
ga4 track topic views	Enviar discourse_topic_view una vez por visita al tema.
ga4 track topic engagement	Enviar discourse_topic_engaged en hitos de tiempo de lectura.
ga4 engagement milestones	Segundos de lectura activa en los que disparar. Predeterminado 10|30|60|180.
ga4 track topic progress	Enviar discourse_topic_progress en hitos de posición de lectura.
ga4 progress milestones	Porcentajes del tema en los que disparar. Predeterminado 25|50|75|100.
ga4 track read completion	Enviar discourse_topic_read_complete cuando un lector alcanza el final.
ga4 read complete min seconds	Tiempo de lectura mínimo antes de que el final cuente como finalización.
ga4 track read summaries	Enviar discourse_topic_read_summary cuando un lector abandona un tema.
ga4 read summary min seconds	Por debajo de este valor, una visita se trata como un rebote y no se resume.
ga4 track search	Enviar search cuando una búsqueda de página completa devuelve resultados.
ga4 track registration	Enviar sign_up después de que se cree una cuenta.
ga4 track login	Enviar login después de un inicio de sesión exitoso. Desactivado por defecto.
ga4 track topic creation	Enviar discourse_topic_created.
ga4 track replies	Enviar discourse_reply_created.
ga4 track likes	Enviar discourse_post_liked. Eliminar un me gusta no envía nada.
ga4 track bookmarks	Enviar discourse_bookmark_created.
ga4 send search terms	También enviar lo que se buscó. Desactivado por defecto — las búsquedas en foros a menudo contienen información personal.
ga4 send page titles	Incluir el título de la página. Desactivado por defecto — en una ruta de tema, este es el título del tema.
ga4 track private message activity	Un evento agregado de MP que no lleva identificadores. Desactivado por defecto.
ga4 login required is restricted	En un foro que requiere inicio de sesión, retener identificadores de tema y categoría.
ga4 send trust level	Incluir el nivel de confianza 0–4 como parámetro de evento.
ga4 internal traffic groups	Los miembros de estos grupos se marcan como traffic_type=internal. Predeterminado: administradores, moderadores.
ga4 suppress in embed	No enviar nada en modo de incrustación.
ga4 debug mode	Registrar eventos y decisiones de supresión en la consola del navegador.

Notas

• En el modo Extensión del núcleo, el núcleo sigue poseyendo las vistas de página, por lo que las URLs de MP y los títulos de temas aún se envían. Solo el modo Gestionado cambia eso.
• No registres topic_id como una dimensión personalizada de GA4 — es ilimitado y alcanzará los límites de cardinalidad de la propiedad.
• El propio informe de Discourse en Administración → Informes → Búsquedas en tendencia registra las clics a través, por lo que te dice qué búsquedas fallaron. GA4 no puede hacerlo. Por eso ga4 send search terms está desactivado por defecto.