Inicialización de etiquetas
Consejo
Para trabajar con la API de JavaScript se requieren conocimientos de HTML y JavaScript. Si no conoce estos idiomas, contacte a su desarrollador web o webmaster.
Vaya a https://mc.yandex.ru/metrika/tag.js
y descargue la biblioteca de JavaScript, porque es necesaria tenerla para que tag funcione.
El código para habilitar la biblioteca está disponible en la página de edición de la etiqueta. La biblioteca puede cargarse de manera asíncrona (opción recomendada) o sincrónica, pero su funcionalidad es la misma.
Para crear y gestionar una etiqueta, utilice el método ym
. Se crea en el código de la descarga:
(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
(window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");
ym
requiere el ID de la etiqueta y el nombre de la función que se está llamando. El método también puede recibir argumentos de la función invocada. Por ejemplo, para inicializar una etiqueta, necesita pasar el ID de la etiqueta, el nombre de la función init
y una matriz de parámetros:
ym(XXXXXX, "init", {clickmap: true, webvisor: true});
Si no desea pasar parámetros a la función, la inicialización se ve así:
ym(XXXXXX, "init", {});
La parte del código que contiene los parámetros de inicialización principales se genera en la página Configuración. La lista completa de parámetros de inicialización se muestra en la tabla.
Las funciones que se pueden llamar a través del método ym
se describen en la referencia de métodos.
Parámetros de inicialización de etiquetas
Nombre |
Valor predeterminado |
Tipo |
Descripción |
|
|
Booleano | Número |
Tasa de rebote precisa El parámetro puede aceptar estos valores:
|
|
|
Booleano |
Si se debe registrar el contenido del iframe sin una etiqueta en una ventana secundaria. |
|
|
Booleano |
Recopilar datos de clic en mapa o no |
|
|
Booleano |
Si se debe deshabilitar el envío automático de datos durante la inicialización de la etiqueta. |
|
|
Booleano | Cadena | Matriz |
Recolección de datos de comercio electrónico.
|
|
: |
Objeto | Matriz |
Parámetros de sesión transmitidos durante la inicialización de etiquetas. Para transmitir los parámetros de sesión en otro momento, use el método params. |
|
— |
Objeto |
Parámetros de usuarios del sitio que se transmiten al inicializar la etiqueta. Para transmitir los parámetros en cualquier otro momento, utilice el método userParams. |
|
|
Booleano |
Seguimiento de cambios de hash en la barra de direcciones del navegador |
|
|
Booleano |
Rastrear clics en enlaces de salida. |
|
— |
Matriz |
Indica un dominio de confianza para registrar el contenido de un iframe secundario Contiene la dirección del dominio de la ventana principal |
|
|
Número |
Tipo de etiqueta. 1 para YAN |
|
|
Booleano |
Utilizar Reproducir sesión o no |
|
|
Booleano |
Si se debe verificar si la etiqueta está lista. |
|
|
Booleano |
Registros de títulos. Si los títulos contienen datos privados, el parámetro debe establecerse en |
Cómo comprobar la inicialización de etiquetas
Puede usar un evento de JavaScript especial para averiguar si la etiqueta está lista para operar. Sin embargo, debe agregar el parámetro triggerEvent
configurado true
en el fragmento de código:
ym(XXXXXX, "init", {triggerEvent: true});
Para jQuery, puede usar el siguiente ejemplo de código en el momento de inicialización de etiquetas:
jQuery(document).on('yacounterXXXXXXinited', function () {
console.log('tag yaCounterXXXXXX ready');
});
Cómo habilitar una etiqueta con el sistema de administración de etiquetas
También puede habilitar las etiquetas de Yandex Metrica utilizando sistemas de gestión de etiquetas (también denominados distribuidores de etiquetas o contenedores de etiquetas). Estos sistemas permiten almacenar todo el código HTML/JavaScript necesario en un servidor externo y conectarlo con páginas web a través de pequeños fragmentos de código. Esto significa que puede realizar cambios en el código conectado sin modificar el código de las páginas web.
Por lo general, los sistemas de administración de etiquetas admiten dos tipos de código integrado para etiquetas: JavaScript e imágenes. Yandex Metrica admite ambos tipos de etiquetas. Para integrarlas usando sistema de administración de etiquetas, use fragmentos de código de la página de Configuración (bajo la pestaña Etiqueta).
<script type="text/javascript">
(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
(window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");
ym(XXXXXX, "init",{<parámetros de inicialización>});
</script>
<img src="https://mc.yandex.ru/watch/XXXXXX" style="position:absolute; left:-9999px;" alt="" />
Aquí, XXXXXX
es el número de etiqueta de Yandex Metrica.
Los datos recopilados pueden variar según el tipo de etiqueta. Para obtener más información, consulte Datos recopilados por la etiqueta de Yandex Metrica.
Dentro de cada etiqueta, puede conectar múltiples contadores a la vez, similar a lo que se describe en la sección Instalación de varias etiquetas en un sitio.
Enlaces útiles |
Capacitación en línea |