Los complementos son secuencias de comandos que mejoran la funcionalidad de analytics.js para ayudar a medir la interacción del usuario. Por lo general, los complementos son específicos para un conjunto de funciones que pueden no ser necesarios para todos los usuarios de Google Analytics, como el comercio electrónico o la medición multidominio. Por lo tanto, no se incluyen en analytics.js de forma predeterminada.
En esta guía, se explica cómo requerir y usar los complementos de analytics.js.
Solicita complementos
El comando require toma el nombre de un complemento y lo registra para usarlo con la cola de comandos de ga(). Si el complemento acepta opciones de configuración, esas opciones se pueden pasar como argumento final al comando require.
A continuación, se muestra la firma completa del comando require:
ga('[trackerName.]require', pluginName, [pluginOptions]);
Por ejemplo, a continuación, se muestra cómo requeriría el complemento Enhanced Ecommerce para usar el seguimiento predeterminado:
ga('require', 'ec');
A continuación, se muestra cómo requerir el complemento Funciones de publicidad para un rastreador denominado &Tracker e pasar una opción de configuración que anule el valor predeterminado del nombre de la cookie:
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
Cómo cargar el código del complemento
El comando require inicializa los métodos del complemento para su uso con la cola de comandos de ga(), pero no carga la secuencia de comandos del complemento. Si usas un complemento de terceros o si escribes un complemento por tu cuenta, tendrás que agregar manualmente el código del complemento a la página.
El método recomendado para agregar un código de complemento a la página es a través de una etiqueta <script> con el atributo async establecido para garantizar que no se bloquee la carga de otras funciones del sitio.
El siguiente código requiere y carga un complemento de seguimiento de vínculos hipotético:
<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 que se carguen los complementos
Debido a que la biblioteca de analytics.js y los complementos de analytics.js se cargan de forma asíncrona, puede ser un desafío saber cuándo están completamente listos y listos para usarse.
La biblioteca analytics.js resuelve este problema al detener la ejecución de la cola de comandos cuando encuentra un comando require para un complemento que todavía no se cargó. Una vez que se carga el complemento, la ejecución de las colas continúa con normalidad.
Por lo tanto, es muy importante que pruebes los complementos que usas para asegurarte de que se carguen y se ejecuten correctamente. Si un complemento no se carga o tiene un error, impedirá que se ejecuten todos los comandos de analytics.js posteriores.
Métodos del complemento de llamada
Después de requerir un complemento, sus métodos estarán disponibles para su uso con la cola de comandos de ga(). Esta es la firma del comando para llamar a métodos de complementos:
ga('[trackerName.][pluginName:]methodName', ...args);
Por ejemplo, el método addProduct del complemento de Comercio electrónico mejorado se puede llamar de la siguiente manera:
ga('ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
En un monitor con nombre, agrega el nombre del monitor a la string de comando:
ga('myTracker.ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
Próximos pasos
Si leyó todas las guías de esta sección, debería estar familiarizado con la mayoría de las funciones de analytics.js. En la siguiente guía, se explica cómo depurar sus implementaciones de analytics.js para detectar errores con más facilidad y ver exactamente qué está haciendo su código.