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

accurateTrackBounce

true

Booleano | Número

Tasa de rebote precisa El parámetro puede aceptar estos valores:

  • true — Habilitar la tasa de rebote precisa, con un evento de no rebote registrado después de 15 000 ms (15 s).
  • false — No habilitar la tasa de rebote precisa.
  • <N> (entero) — Habilitar la tasa de rebote precisa. Los eventos que no son de rebote se registran después de <N> ms.

childIframe

false

Booleano

Si se debe registrar el contenido del iframe sin una etiqueta en una ventana secundaria.

clickmap

true

Booleano

Recopilar datos de clic en mapa o no

defer

false

Booleano

Si se debe deshabilitar el envío automático de datos durante la inicialización de la etiqueta.

ecommerce

false

Booleano | Cadena | Matriz

Recolección de datos de comercio electrónico.

  • true: habilita la recopilación de datos para el comercio electrónico. Equivalente al valor de dataLayer (si la opción está habilitada en Yandex Metrica). Los datos se transfiere a través de un arreglo de JavaScript llamado dataLayer en el espacio de nombres global (window.dataLayer).
  • false: deshabilita la recopilación de datos para el comercio electrónico.
  • <objectName> (Cadena): habilita la recopilación de datos para el comercio electrónico. Los datos se transmiten a través de una matriz JavaScript llamada <objectName> en el espacio de nombres global (ventana.<objectName>).
  • <array> (Matriz): habilita la recopilación de datos para el comercio electrónico. Los datos se transmiten a través de un JavaScript <array>

params

:

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.

userParams

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.

trackHash

false

Booleano

Seguimiento de cambios de hash en la barra de direcciones del navegador

trackLinks

true

Booleano

Rastrear clics en enlaces de salida.

trustedDomains

Matriz

Indica un dominio de confianza para registrar el contenido de un iframe secundario Contiene la dirección del dominio de la ventana principal

tipo

0

Número

Tipo de etiqueta. 1 para YAN

webvisor

false

Booleano

Utilizar Reproducir sesión o no

triggerEvent

false

Booleano

Si se debe verificar si la etiqueta está lista.

sendTitle

true

Booleano

Registros de títulos. Si los títulos contienen datos privados, el parámetro debe establecerse en false durante la inicialización: sendTitle: false.

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.

Chatee con nosotros

Escriba un correo electrónico

Tome en cuenta: Nuestro equipo de soporte nunca iniciará llamadas hacia usted. No siga las instrucciones de personas que le llamen y se presenten como el equipo de soporte de Yandex Metrica.