Yandex.Metrica Inspector, extensión para el debug de implementaciones con Chrome

A medias entre la curiosidad y el aburrimiento, me puse a programar una extensión para Chrome (me meto yo solo en cada embolado). Como punto de partida, un script que suelo usar para hacer debug de implementaciones de Yandex.Metrica (el original de la propia herramienta me parece bastante espartano) y que quería mejorar. Y ya puestos en harina, a ver si conseguía que se publicara oficialmente. Bueno, para bien o para mal, la extensión de marras ya está publicada y disponible en la Chrome Web Store con el nombre de Yandex.Metrica Inspector.

Yandex.Metrica Inspector

En breve, esta extensión permite revisar la información que envía un sitio web a Yandex.Metrica y comprobar que los datos que se envían, igual que el cómo y cuando se envían, son correctos. Desde la vista de herramientas para desarrolladores del navegador, puedes ver toda la actividad generada por tu código de seguimiento de Metrica.

Los eventos que muestra la extensión:

  • Página vista (init method)
  • Página vista ‘virtual’ (hit method)
  • Enlace externo (extLink method)
  • Descarga de fichero (file method)
  • Objetiv os (reachGoal method)
  • Parámetros de sesión (params method)
  • Parámetros de usuario (userParams method)
  • ID de usuario (setUserID method)
  • No rebote (notBounce method)
  • Ecommerce
    • Detalle de producto (detail)
    • Añadir al carrito (add)
    • Eliminar del carrito (remove)
    • Compra / Transacción (purchase)

Para cada tipo de datos, puedes ver la información más relevante (título de la página, URL de referencia, anchor text, parámetros de sesión…). Puedes ver la extensión en funcionamiento en este vídeo de demostración con un par de sitios de prueba.

En la URL https://yminspector.antoniolite.com/ puedes encontrar algo más de información.

Si quieres probar la extensión, aquí puedes descargar Yandex.Metrica Inspector para Chrome.

Plantilla de Yandex Metrica para GTM (07.2020)

Una pequeña revisión de mi plantilla personalizada de Yandex Metrica para Google Tag Manager.

Estos son los cambios más destacados:

  • Añadidas las opciones para indicar coste de objetivo (order_price y currency) en los eventos de hit, reachGoal, file y extLink
  • Reorganización de algunos bloques de campos (por ejemplo, los parámetros de sesión ahora se muestran ocultos por defecto para aquellos eventos que los admiten como opcionales; la configuración de comercio electrónico, parámetros de usuario y extensiones de fichero también se muestran ocultos por defecto en la inicialización de la etiqueta)
  • Solución de pequeños bugs
  • Optimización de código

Descarga de la plantilla personalizada

Yandex Metrica Content Reports

Plugin WordPress de etiquetado JSON-LD para los informes de contenido en Yandex Metrica

Los informes de contenido en Yandex Metrica ha sido una de las muchas características que Yandex ha añadido a su herramienta de analítica web durante este 2019. Y probablemente, es la que más me gusta a fecha de hoy, más que la grabación de sesiones, o incluso más que el análisis de formularios (la que ha sido mi favorita hasta la fecha).

Si quieres saber más sobre estos informes de contenido, puedes leer un artículo que publiqué en septiembre (Informes de contenido en Yandex Metrica), aunque desde entonces ha habido novedades en esta función, como los informes de autores y temas (topics).

En este artículo presento un plugin para WordPress que te permitirá enviar datos a estos informes. Así pues, los comentarios que voy a ir haciendo están escritos pensando en que tu sitio web funciona con WordPress.

Configurando los informes

Para disponer de estos informes de contenido en tu cuenta de Metrica es necesario que hagas dos cosas:

  1. Activar estos informes en la configuración del contador de Metrica (si ya tienes insertado el código de seguimiento en tu sitio web, no hace falta que lo actualices)
  2. Empezar a enviar los datos sobre tus contenidos

Para enviar datos de tus contenidos tienes que disponer de algún tipo de marcado de datos en tu código. Para esto, puedes hacerlo con Open Graph, Microdata o JSON-LD.

Supongo que es una cuestión personal cómo hacerlo, pero la opción de microdata me parece poco práctica si ya tienes montado el sitio y el código de tu plantilla no incluye este marcado. Añadirlo puede ser algo costoso. La opción de Open Graph tampoco me convence demasiado, pues si usas este etiquetado pensando en la información que recupera Facebook cuando se comparte tu contenido, por ejemplo, te puede interesar tener algo distinto a lo que usarías para los informes de contenido.

Así pues, me quedo con JSON-LD, porque básicamente se reduce a insertar una etiqueta de SCRIPT en tu código, y esto se puede hacer fácilmente con WordPress sin tener que tocar mucho el código.

Yandex Metrica JSON-LD Schema

Así es como he llamado a un plugin para WordPress que he desarrollado, bastante básico pero funcional para lo que se necesita.

Se encarga de generar el marcado JSON-LD para que Yandex Metrica pueda mostrar los informes de contenido.

Estos son los elementos que incluye este marcado de datos:

  • Post
    • Título
    • Descripción (300 primeros caracteres)
    • URL
    • Imagen destacada
    • Categoría
    • Etiquetas
    • Fecha de publicación
    • Fecha de actualización
  • Autor
    • Nombre
    • URL
    • Avatar
  • Publisher
    • Nombre
    • URL
    • Logo

Realmente, en los informes de Yandex Metrica solo veremos parte de estos datos, pero de este modo el JSON-LD pasa la validación de las herramientas de comprobación de datos estructurados de Yandex y Google.

Lo he estado probando durante algo más de una semana en un par de sitios centrados en generar contenido, y cumple su cometido muy dignamente.

Instalación y configuración del plugin

El plugin se instala y se activa como cualquier otro plugin de WordPress. En esta primera versión tiene una configuración básica que te permite indicar los datos del elemento “publisher”. Si no configuras estos datos (nombre, url, logo) se usarán el nombre del sitio web, la URL del sitio web y una imagen sencilla generada con placeholder.com que mostrará el nombre del sitio web.

Plugins para el marcado de datos hay muchos, pero ninguno me convenció para pasarle los datos a Yandex Metrica, de ahí que preparase este. Para evitar conflictos, este plugin tiene una opción para desactivar esta característica de Yoast SEO (de momento solo incluye a este). Suelo usar este plugin y necesitaba deshabilitar esta opción para que solo se generase el JSON-LD preparado para Yandex Metrica. Si usas Yoast SEO, es recomendable marcar esta opción en la configuración.

Ahora, algunas cuestiones a tener en cuenta. Primero, si tu post tiene más de una categoría solo se pasa una. Si usas Yoast SEO y has marcado alguna de las categorías como principal, será esta. Si no, la primera categoría (recuperadas en orden alfabético). Y segunda cuestión, aunque en el JSON-LD se incluyen las etiquetas del post, tal como indica Yandex Metrica en su documentación oficial, de momento no se registran en los informes de temas (topics). No estoy seguro de si esto es un bug, porque el JSON-LD parece correcto y pasa la validación de Yandex, pero no se muestran estos temas en los informes. Si el marcado de datos lo haces como microdata, entonces funciona sin problemas.

24/06/2020: Hace ya unos días que este problema con el JSON-LD ha quedado resuelto y Yandex Metrica ya recupera las etiquetas del artículo para incluirlas en los informes de contenido.

26/06/2020: el plugin se ha publicado oficialmente en el repositorio de plugins de WordPress con el nombre de JSON-LD Schema for Yandex Metrica

Próximas versiones

Tengo algunas ideas con las que mejorar el plugin, pero por ahora hace lo que necesitaba que hiciera. Si las circunstancias lo permiten, iré añadiendo algunas mejoras en el plugin. Y por supuesto, todo comentario y opinión con ánimo constructivo será bien recibido.

Descargar Yandex Metrica JSON-LD Schema

Puedes descargar el plugin Yandex Metrica JSON-LD Schema, y si necesitas ayuda para configurar los informes de contenido, puedes dejar un comentario o contactar conmigo.

Primera versión: 02.12.2019
Publicado en el repositorio de WordPress.org: 26.06.2020

Informes de contenido en Yandex Metrica

Nuevos informes de contenido en Yandex Metrica

Sin mucho ruido, han aparecido nuevos informes de contenido en Yandex Metrica. Todo pasa por tener un buen etiquetado de nuestros contenidos para que podamos disponer de información relacionada con autores y temas (topics).

Yandex Metrica tiene bastante bien documentado cómo implementar este etiquetado:

https://yandex.ru/support/metrica/publishers/schema-org/json-ld.html

También puedes echar un ojo a un artículo que escribí hace poco sobre los informes de contenido en Yandex Metrica, donde puedes encontrar algunos enlaces de utilidad.

Plantilla de Yandex Metrica para GTM (09.2019)

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:

https://www.antoniolite.com/2019/06/plantilla-de-yandex-metrica-para-gtm/

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
  • Optimización de código

Descarga de la plantilla personalizada