He actualizado la plantilla personalizada de Yandex Metrica para Google Tag Manager que publiqué en junio. Si quieres leer el artículo original con la información y descripción completa de las características de la plantilla, lo tienes en este enlace:
En lo que respecta a la actualización, estos son los cambios más destacados:
Inicialización de la etiqueta
Hay disponibles nuevos parámetros de configuración cuando se inicializa la etiqueta. Todos ellos son opcionales.
childIframe
Con este parámetro indicamos que queremos grabar el contenido que se esté mostrando en un iframe, siempre que la ventana principal y la página que carga el iframe esté bajo el mismo dominio.
trustedDomains
En relación al anterior, con este parámetro indicamos en la página que se carga en el iframe aquellos dominios de confianza que podrán grabar los contenidos con webvisor. Por ejemplo, si la ventana principal y la del iframe son son de distintos dominios o subdominios de un mismo dominio.
userParams
Podemos enviar parámetros de usuario con la inicialización de la etiqueta, y seguimos pudiendo enviar parámetros de usuario en cualquier momento con el método userParams.
triggerEvent
Con este parámetro, Metrica lanza un evento “yacounterXXXXXXinited” (donde XXXXXX es el ID de tu contador) para que sepamos cuándo está operativo nuestro contador de Metrica. Podemos vincular alguna función JavaScript / jQuery a este evento, como por ejemplo:
$(document).on('yacounterXXXXXXinited', function() {
console.log('yaCounterXXXXXX ya está disponible');
});
Otros cambios
Hay otros cambios en la plantilla personalizada para Yandex Metrica:
Solucionado bug con el método setUserId
Solucionado bug al añadir extensiones de fichero para monitorizar
Mejoras en la interfaz de configuración de la etiqueta
Aunque Yandex Metrica permite crear segmentos, informes y dashboards personalizados, es posible que en algunos proyectos necesitemos más libertad a la hora de trabajar con los datos que registra Metrica.
Hay que recordar que Yandex Metrica no aplica muestreo y tenemos acceso a los datos en bruto de nuestros contadores.
La API de Yandex Metrica es bastante potente. He hablado sobre ella en algún evento de analítica web, está muy bien documentada y es sencilla de usar. Pero últimamente he estado probando Logs API con contadores de Metrica, y creo que las posibilidades son increíbles, ya que básicamente te llevas los datos que quieres para hacer luego lo que necesites con ellos.
Y con este artículo quiero hacerte una introducción a Logs API para que puedas realizar peticiones para generar un log con los datos que quieras. Yandex te sugiere, obviamente, que una vez tengas los datos conectes con ClickHouse, pero lo cierto es que puedes llevártelos donde quieras.
Paso 1: registra una aplicación con Yandex OAuth
Esto es obligatorio, aunque muy sencillo. Sin registrar una aplicación, no podremos obtener un token de acceso y sin el token de acceso, las llamadas a la API de Yandex (sea la de Metrica o la de Logs) nos dirán que el acceso no está autorizado.
Empieza en la página de Yandex OAuth y registra una aplicación
https://oauth.yandex.com/
Rellena todos los datos, selecciona Web services como plataforma en la que usarás la aplicación que estás registrando. Indica que la URL de retorno (Callback URL) será la de desarrollo, y marca los permisos que necesites. Para el objetivo de lo que estoy contando, basta con los permisos de acceso a las estadísticas de los contadores de Yandex Metrica.
Cuando tengas registrada la aplicación, verás que te muestra tres datos:
ID
Password
Callback URL
Necesitarás el ID para obtener el token con el que harás luego las llamadas a la API.
Para obtener el token, ve a esta dirección, cambiando ID por el ID de la aplicación que acabas de registrar:
Con esto, obtenemos lo que Yandex llama el Debugging token, aunque si lo que vas a hacer depende únicamente de tu lado, este token de desarrollo puede valer sin más.
Al visitar esa URL, te devolverá el token de acceso, una cadena alfanumérica que nos servirá para autenticar las llamadas que haremos a la API.
Y así, ya podemos continuar preparando la parte en la que recuperaremos los datos de nuestros contadores de Metrica.
Paso 2: consulta los logs que has solicitado
Además del token de acceso, vamos a necesitar el ID del contador de Yandex Metrica del que vamos a recuperar datos. Lo tienes en el listado de códigos que tienes creados en Yandex Metrica.
Antes de solicitar formalmente que se procesen los datos que necesitemos, podemos consultar la viabilidad de nuestra petición. En el resultado de la llamada a la API encontraremos si es posible o no, y si no hay problemas, le mandaremos la solicitud en el paso siguiente.
Una vez que hayamos comprobado que nuestra solicitud de datos se puede procesar, ya podemos enviar la solicitud formal para que se prepare nuestro log.
Ahora tendríamos dos logs solicitados / creados si hacemos la petición del paso 1, cada uno con un requestID diferente (obviamente).
Paso 5: consulta el estado de tu solicitud
Si hemos solicitado muchos datos, es posible que tarde un tiempo en procesar la solicitud. Con esta llamada a la API podemos comprobar si la solicitud está procesada y los datos están disponibles.
Una vez que tengamos procesada la solicitud de log, podemos disponer de los datos. Los puedes guardar en un fichero de texto, meterlos en base de datos…
He pixelado la imagen, pero básicamente ya te lo imaginas… texto separado por tabuladores que puedes importar fácilmente a Excel o una base de datos tipo MySQL. A partir de aquí, imaginación para exprimir los datos.
Limitaciones
Tienes que usar el token de acceso en todas las peticiones que hagas a la API.
El volumen máximo de datos que se puede transmitir en cada solicitud es de 10 GB por cada contador de Metrica.
Los datos del día actual pueden no estar completos. Además, en algunas solicitudes puedes recibir un mensaje de error que la fecha (date2) debe ser anterior al día actual. Yandex recomienda en la documentación que user el día anterior como límite para recuperar los datos.
El pasado mes, Yandex Metrica añadía una novedad su herramienta: informes de contenido. Una serie de informes pensados principalmente para medios online o sitios web centrados en generar contenido.
Los informes de contenido permiten analizar en tiempo real los contenidos publicados: noticias, artículos, entradas de blog, valoraciones, recetas y páginas de tipo pregunta-respuesta.
Configuración
Los informes se deben activar en la configuración de la etiqueta de Yandex Metrica, e indicar el tipo de marcado que tenemos en nuestro contenido. El marcado es la clave para disponer de estos informes, pues Metrica solo tendrá en cuenta las páginas que tengan este marcado.
Podemos elegir entre tipo Schema.org, microdata o Schema.org, json-ld. Si nuestro sitio web no tiene alguno de estos tipos de marcado semántico, corre por nuestra cuenta ponerlo en marcha. Con WordPress, por ejemplo, es bastante sencillo con algún plugin como Schema.
Para comprobar si nuestras páginas cumplen con el marcado en cuestión, podemos usar alguna herramienta de validación o comprobación de datos estructurados:
Con esto, según Yandex, es cuestión de unas pocas horas que en nuestra cuenta de Metrica aparezcan los informes de contenido.
Dashboard
Los informes de contenido cuenta con un dashboard en el que vamos a ver en tiempo real el número de usuarios, páginas vistas, tiempo medio de lectura y una métrica llamada recirculation, que viene a ser el porcentaje de usuarios que leen más de una página porque se supone que encontraron interesante nuestro contenido.
El apartado de contenido popular muestra una lista de las páginas más populares junto con algunas otras métricas.
Contenidos
Los informes de contenido nos muestran detalles bastante útiles sobre nuestras publicaciones. Además de las fuentes de tráfico, páginas vistas, usuarios, tiempo en pantalla y recirculación, tenemos una métrica que nos indicará el porcentaje de vistas a una página que llegaron hasta el final (haciendo scroll), así como la proporción de usuarios que accedieron desde un dispositivo móvil (tablet o smartphone).
De este modo resulta muy sencillo encontrar qué páginas son las que generan más engagement, bien sea por que los usuarios llegan hasta el final de esa página, o porque siguen leyendo otros contenidos y se quedan en nuestro sitio web.
Contenido
Desde el informe de contenidos podemos ver el detalle de cualquiera de nuestras páginas. Resulta interesante los embudos de «Full scroll» y «Full read». El primero muestra cuántos usuarios se han desplazado hasta el final del texto y el segundo cuántos usuarios leyeron completamente el texto. Supongo que este último valor se calcula en función del tiempo que dedica el usuario a esa página. También podemos ver a qué otros contenidos se fueron los usuarios desde esa página, el dispositivo desde el que accedieron y el listado completo de enlaces que sirvieron como fuente de tráfico para llegar hasta la página en cuestión.
En resumen, se trata de una nueva característica muy interesante y útil para sitios web que estén basados en contenidos. En ocasiones puede resultar complicado valorar el éxito que tienen los contenidos que publicamos, y con estos nuevos informes, Yandex Metrica ayuda un poco a dar con aquellos contenidos que mejor funcionan.
Más información sobre los nuevos informes de contenido de Yandex Metrica:
Una de las últimas características disponibles en Yandex Metrica es la grabación de iframes en Session Replay (grabación de sesiones).
Para que puedas ver el contenido del iframe en la grabación de sesiones, es necesario que la página contenedora del iframe y la página que se muestra en el iframe tengan el mismo código de seguimiento de Yandex Metrica.
La página que se muestra en el iframe contará como una página vista en los informes de Metrica. Si no quieres que esa página se tenga en cuenta como una página individual (ya se está mostrando en el iframe y registrará como página vista la que lo contiene), puedes inicializar el código de seguimiento de Metrica en el contenido del iframe con el parámetro defer: false, para así evitar que al inicializar el código envíe la página vista por defecto.
En esta captura de pantalla se puede observar cómo las páginas mostradas dentro del iframe, sin el parámetro defer: false, se registran como página vista, sumando en el total de páginas vistas en la sesión, con un tiempo en la página de 0:00 segundos. Ya es decisión tuya si las excluyes como página vista o no.
Y en este vídeo se ve el resultado de un pequeño experimento que carga páginas en un iframe, insertando el código de seguimiento con Google Tag Manager y/o Yandex Metrica, con y sin el parámetro defer. Las páginas en iframe sin código de seguimiento de Metrica, no quedaron grabadas en Session Replay, y las que no tenían el parámetro defer se registraron como página vista en la sesión.
Las plantillas personalizadas son una de las últimas características que han aparecido en Google Tag Manager. Y de haber aparecido un par de meses antes, me hubieran ahorrado una cantidad de tiempo enorme implementando Yandex.Metrica en un proyecto reciente.
La plantilla sobre la que trata este artículo es una plantilla para implementar el código de seguimiento de Yandex.Metrica a través de Google Tag Manager. Su interfaz está en español y tiene casi todas las opciones y características que tiene disponibles Metrica para su código de seguimiento:
Para inicializar el código de seguimiento de Metrica. Se pueden configurar las principales opciones y características sin tener que editar el contador en la administración de nuestra cuenta de Metrica. No obstante, hay algunas cosas que deberías dejar configuradas cuando crees el contador y otras que tendrás que hacer impepinablemente en la interfaz de Metrica.
Te recomiendo que en la configuración de tu contador dejes marcadas las opciones para la grabación de sesiones, envío de datos de comercio electrónico y divisa por defecto tal como lo necesites. Respecto a la grabación de sesiones, tienes que usar Session Replay 2.0, ya que esta plantilla no es compatible con el código anterior de Metrica. También has de indicar si quieres grabar las pulsaciones de teclado en la grabación de sesiones (siempre lo puedes desactivar de forma específica usando el CSS que indica Metrica para estos casos).
Para habilitar los informes de comercio electrónico en Metrica, tienes que habilitar esta opción en el código de seguimiento, y además incluir en el código de tu página el dataLayer (que puede ser el mismo que uses para Google Tag Manager / Google Analytics).
Filtros y objetivos, lógicamente, los tienes que seguir creando desde la interfaz de Metrica, así como exclusión de visitas propias o la activación y gestión de las notificaciones que puedes tener sobre el estado del sitio web configurado.
Sobre el debug de Yandex.Metrica, lo puedes activar en las opciones de inicialización, pero solo funcionará si el contenedor de GTM está en modo de vista previa.
Envia información sobre la consecución de un objetivo. Previamente lo has tenido que definir en la interfaz de Metrica. Cuidado con el nombre del objetivo, ha de coincidir con lo que hayas puesto en Metrica. Importe y divisa son opcionales, en las divisas he añadido Euro, Dólar americano, Rublo y Libra esterlina (puedes añadir lo que necesites editando la plantilla o vía variable de GTM).
Si se trata de un objetivo de comercio electrónico (venta), puedes enviar el ID del objetivo usando el dataLayer, no hace falta usar reachGoal. En este caso, no se usa el nombre del objetivo, si no el ID numérico del objetivo (lo obtienes igualmente de la interfaz de Metrica).
Si has configurado el código de seguimiento para que registre enlaces salientes, puede que no uses esta opción, aunque la tienes disponible para enviar a Metrica datos de enlaces externos que puedas usar vía ajax o técnicas similares. El único parámetro obligatorio es la URL del enlace externo. Si no pasas el título de la página, Metrica registrará document.title como valor por defecto.
Como el método anterior, si has configurado el registro de descarga de ficheros en el código de seguimiento de Metrica, puede que no necesites esta opción. En la configuración del código de seguimiento puedes añadir extensiones de fichero que quieras registrar de forma automática, si la que necesites no está incluida en las numerosas extensiones de fichero que registra Metrica por defecto.
Los parámetros de sesión están disponibles como opciones en los métodos init, hit, reachGoal, file y extLink. Puedes usar hasta 10 niveles en los parámetros de sesión, aunque tendrás que echarle algo de imaginación para usar más de 2 niveles con la tabla que te permite crear GTM.
Fácil. Enviar el ID de usuario interno que utilices en tu sitio web. Puedes enviarlo en cualquier momento durante una sesión para asociar el clientID de Metrica con el ID de usuario que especifiques.
Metrica permite pasar parámetros de usuario y recomienda pasar datos de usuario que no cambien de una sesión a otra y que no contengan datos personales como el nombre del usuario. Para comprender un poco mejor la diferencia entre parámetros de usuario y parámetros de sesión, puedes echar un ojo a esta página donde explican cómo se procesan y almacenan los datos.
¿Y el resto de métodos?
Del resto de métodos (getClientID, addFileExtension y notBounce), el único que no está disponible en esta plantilla es getClientID. Los otros dos, addFileExtension y notBounce he decidido incluirlos como opciones en la configuración para la inicialización del código de seguimiento y se ejecutan, en caso de estar configurados, en el momento de inicializar el código de Yandex Metrica.
