Google Analytics (GA) es un servicio gratuito ofrecido por Google que puede realizar un seguimiento de diversos datos anónimos sobre los usuarios que visitan una página web, como por ejemplo qué página es visitada cuántas veces y durante cuánto tiempo. Puede generar muchos informes pormenorizados sobre el comportamientos de dichos usuarios, y es una herramienta clave para entender las necesidades de los usuarios y lo que esperan de cualquier material online. Integrar Google Analytics en una documentación HTML resulta muy útil para obtener conocimientos precisos sobre lo que buscan los visitantes, y es algo que se puede hacer muy fácilmente con el potente sistema de plantillas de HelpNDoc.

Seguimiento de visitas a la documentación HTML con Google Analytics

Paso 1: Obtener el código de seguimiento de Google Analytics

Es necesario un código de seguimiento específico para que Google Analytics sepa qué dominio se está analizando actualmente. Para obtener el código del dominio en el que se colocará la documentación online, sólo tienes que ir a la página de ajustes de Google Analytics del dominio y copiar el código suministrado. Debería ser parecido a este fragmento de código con un valor setAccount personalizado:

<script>

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-123456-7']);
  _gaq.push(['_trackPageview']);

  (function() {
   var ga = document.createElement('script');
   ga.type = 'text/javascript'; ga.async = true;
   ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www')
            + '.google-analytics.com/ga.js';
   var s = document.getElementsByTagName('script')[0];
   s.parentNode.insertBefore(ga, s); })();

</script>

Paso 2: Insértalo en la plantilla HelpNDoc

HelpNDoc ofrece un modo muy conveniente de controlar los resultados HTML de la documentación generada: no hay más que crear o editar una plantilla para ordenarle a HelpNDoc que genere la documentación de una determinada manera. Para ello, copiaremos la plantilla HTML predeterminada y añadiremos nuestro código de seguimiento donde proceda:

  • Como mejor práctica, se recomienda no editar las plantillas predeterminadas incluidas en el directorio de instalación de HelpNDoc: sólo tienes que copiar la plantilla HTML predeterminada de C:\Archivos de Programa\IBE Software\HelpNDoc\templates\html\default a la carpeta de plantillas personales, situada en Mis Documentos\HelpNDoc\templates\html\default
  • Ahora podemos cambiar el nombre de la plantilla: renombra la carpeta de default a analytics y edita el archivo template.info para dar un nuevo nombre a la plantilla, como por ejemplo plantilla HTML con Google Analytics
  • Por último, añade el código de seguimiento en la sección de cabecera HTML de nuestros temas editando el archivo topics.pas.html y añade el código Google Analytics anterior en la sección de cabecera del archivo de la plantilla HTML

Paso 3: Publica tu documentación para recopilar estadísticas

Ahora podemos generar la documentación HTML desde cualquier proyecto HelpNDoc, especificando la plantilla recién creada en la ventana de generación, subirla al servidor web ¡y listo!: Google Analytics recopilará datos para ti y te ofrecerá informes muy sencillos de interpretar y potentes con una indicación clara de lo que están haciendo los usuarios con tu documentación online.


Categorías: artículos