Los plugins son scripts que mejoran la funcionalidad de analytics.js para ayudar a medir la interacción del usuario. Los plugins suelen ser específicos para un conjunto de funciones que pueden no ser necesarias para todos los usuarios de Google Analytics, como el comercio electrónico o la medición entre dominios, y por lo tanto no se incluyen en analytics.js por defecto.
Esta guía explica cómo requerir y utilizar los plugins de analytics.js.
Requerir plugins
El comando require toma el nombre de un plugin y lo registra para su uso con la cola de comandos ga(). Si el plugin acepta opciones de configuración, esas opciones se pueden pasar como argumento final al comando require.
La siguiente es la firma completa del comando require:
ga('require', pluginName, );Por ejemplo, así es como se requeriría el plugin Enhanced Ecommerce para su uso con el rastreador por defecto:
ga('require', 'ec');Y así es como requerirías el plugin Advertising Features para un tracker llamado «myTracker» y pasarías una opción de configuración que anule el valor del nombre de la cookie por defecto:
ga('myTracker.require', 'displayfeatures', { cookieName: 'display_features_cookie'});Cargar el código del plugin
El comando require inicializa los métodos del plugin para su uso con la cola de comandos ga(), pero no carga el script del plugin en sí. Si está utilizando un plugin de terceros, o escribiendo un plugin usted mismo, tendrá que añadir manualmente el código del plugin a la página.
El método recomendado para añadir el código del plugin a la página es a través de una etiqueta <script> con el atributo async establecido para asegurarse de que no bloquea la carga de otras características en su sitio.
El siguiente código requiere y carga un hipotético plugin de seguimiento de enlaces:
<script>ga('create', 'UA-XXXXX-Y', 'auto');ga('require', 'linkTracker');ga('send', 'pageview');</script><!--Note: plugin scripts must be included after the tracking snippet. --><script async src="/path/to/link-tracker-plugin.js"></script>Esperando a que se carguen los plugins
Debido a que tanto la biblioteca analytics.js como los plugins analytics.js se cargan de forma asíncrona, puede ser un reto saber cuándo los plugins están completamente cargados y listos para ser utilizados.
La biblioteca analytics.js resuelve este problema deteniendo la ejecución de la cola de comandos cuando encuentra un comando require para un plugin que aún no está cargado. Una vez cargado el plugin, la ejecución de la cola continúa de forma normal.
Como resultado, es extremadamente importante que pruebes los plugins que estás utilizando para asegurarte de que se cargan y ejecutan correctamente. Si un plugin no se carga o tiene un error, impedirá que se ejecuten todos los comandos posteriores de analytics.js.
Llamada a los métodos de los plugins
Después de requerir un plugin, sus métodos estarán disponibles para su uso con la cola de comandos ga(). Esta es la firma de comandos para llamar a los métodos de los plugins:
ga('methodName', ...args);Por ejemplo, el método addProduct del plugin Enhanced Ecommerce se puede llamar así:
ga('ec:addProduct', { 'id': 'P12345', 'quantity': 1});O en un rastreador con nombre añadiendo el nombre del rastreador a la cadena de comandos:
ga('myTracker.ec:addProduct', { 'id': 'P12345', 'quantity': 1});Si has leído todas las guías de esta sección, deberías estar familiarizado con la mayoría de las funciones de analytics.js. La siguiente guía explica cómo depurar tus implementaciones de analytics.js para detectar más fácilmente los errores y ver exactamente lo que está haciendo tu código.