Cómo instalar y configurar la etiqueta para sitios SPA

Inicialización de etiquetas

Para usar una etiqueta de Yandex Metrica en sitios SPA, siga estos pasos:

  1. Cree e instale el código de etiqueta en su sitio, si aún no está instalado.

  2. Al inicializar la etiqueta, establezca el parámetro defer en true. Esto es necesario para desactivar el envío automático de datos sobre vistas. Para registrar impresiones de página, use la función hit, como se describe en la sección 3.
    Ejemplo de inicialización de la etiqueta:

    ym(XXXXXX, 'init', {
        defer: true,
        clickmap:true,
        trackLinks:true,
        accurateTrackBounce:true
    })
    
  3. Para asegurarse de que Yandex Metrica registre los cambios importantes en la página, analice la lógica de su web e inserte la función hit en las partes adecuadas de su código, de modo que se active cada vez que considere que la página ha cambiado.
    Invoque la función hit:

    ym(XXXXXX, 'hit', url[, options]);
    

    Parámetros que se pueden pasar en la función hit:

    Parámetro

    Valor predeterminado

    Tipo

    Descripción

    url

    Cadena de caracteres

    La URL de la página desde la cual se realizó la vista. Si no se proporciona la URL, se utilizará el valor de window.location.href

    opciones

    Objeto

    campos de opciones

    options.callback

    Función

    La función de retorno de llamada a invocar después de enviar datos de vista de página

    options.ctx

    Objeto

    Contexto accedido por la palabra clave this en la función de devolver llamada

    options.params

    Objeto

    Parámetros de sesión

    options.referer

    Cadena de caracteres

    La URL desde la que el usuario cargó el contenido de la página actual

    options.title

    document.title

    Cadena de caracteres

    Título de la página actual

    Campos para el objeto options.params:

    order_price

    Doble

    Ingresos por meta. Puede establecer el costo en una moneda o unidades convencionales.

    moneda

    Cadena de caracteres

    Use este campo si desea pasar el costo de la meta en moneda. Yandex Metrica reconoce un código de moneda de tres letras ISO 4217.

    Si elige una moneda diferente, se enviarán valores nulos en lugar de monedas e importes.

    Ejemplo de invocación de la función hit
    ym(XXXXXX, 'init', {});
    //...
    ym(XXXXXX, 'hit', '#contacts',{params:{
        title: 'Información de contacto',
        referer: 'http://example.com/#main'
    }});
    

Envío de conversiones

Para rastrear eventos del sitio que no cambian la URL de la página, use la función reachGoal:

ym(XXXXXX, 'reachGoal', 'TARGET_NAME);

Ejemplos de configuración de objetivos en el fragmento de código.

Transmisión de parámetros de sesión y parámetros de usuario

ym(XXXXXX, 'params', {param1: 'param_value1'})
ym(XXXXXX, 'userParams', {param1: 'param_value1'})

Transmisión de datos de comercio electrónico

Para transmitir datos, habilite el comercio electrónico en Yandex Metrica.

Para recopilar correctamente los datos de comercio electrónico, debe asegurarse de llamar la función hit cuando el usuario carga una página nueva.

Ejemplo de envío de datos de comercio electrónico
dataLayer.push({
    "ecommerce": {
        "purchase": {
            "actionField": {
               "id": "TRX987"
            },
            "products": [
                {
                    "id": "25341",
                    "name": "Sudadera con gorro de Yandex (hombre)",
                    "price": 1345.26,
                    "brand": "Yandex",
                    "category": "Ropa/Ropa de hombre/Sudaderas",
                    "variant": "Anaranjado"
                },
                {
                    "id": "25314",
                    "name": "Sudadera con gorro de Yandex (mujer)", 
                   "price": 1543.62,
                    "brand": "Yandex",
                    "category": "Ropa/Ropa de mujer/Sudadera",
                    "variant": "Blanco",
                    "quantity": 3
                }
            ]
        }
   }
});

Cómo habilitar Reproducir sesión, clics en mapas, mapas de enlaces y Análisis de formularios

Puede conectar Reproducción de sesión, mapas de clics y mapas de enlaces a un sitio SPA. El mapa de desplazamiento, el análisis de formularios y la Reproducción de Sesión 1.0 no son compatibles.

Desactivación de Yandex Metrica en SPA

Para desactivar Yandex Metrica, use el método .destruct() en la instancia de la etiqueta. Este método solo funciona en la nueva versión del código de la etiqueta de Yandex Metrica.

  • Para etiquetas inicializadas a través del constructor Ya.Metrika2:

    // Inicializar la etiqueta
    const counter = new Ya.Metrika2(counterId);
    
    //  Desinicializar la etiqueta
    counter.destruct()    
    
  • Si la inicialización ocurre con configuraciones:

    // Inicializar la etiqueta
    const counter = new Ya.Metrika2({
      id: counterId,
      trackLinks: true
    });
    
    // Desinicializar la etiqueta
    counter.destruct()    
    

Use el método destruct solo para detener Yandex Metrica.

Chatee con nosotros

Escriba un correo electrónico

Si no pudo comprobar la etiqueta de manera independiente, siga estas recomendaciones.

Esto puede suceder por los siguientes motivos:

  • La etiqueta no está instalada correctamente. Por ejemplo, el CMS modificó el código de la etiqueta. Vuelva a instalar la etiqueta o comuníquese con el servicio de asistencia técnica de su CMS (sistema de administración de contenido).
  • Los scripts rotos están impidiendo que la etiqueta de Yandex Metrica funcione en el sitio. Puede comprobarlo en la consola del navegador.
Las recomendaciones no fueron útiles

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.

Esto significa que la información se está transmitiendo a Yandex Metrica. Sin embargo, los datos posiblemente no aparezcan en los informes por alguna de los siguientes motivos:

  • Los datos se envían a una etiqueta con un número diferente.
  • Hay filtros muy estrictos definidos en la pestaña Filtros de la configuración de la etiqueta. Elimine los filtros innecesarios.
  • La pestaña Filtros en la configuración de la etiqueta tiene el filtro No contar mis sesiones habilitado. Esto significa que la etiqueta no registra sus propias sesiones. Intente acceder al sitio con su navegador en modo “incógnito”.
Las recomendaciones no fueron útiles

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.


Cargando una de las páginas de un sitio cuando un usuario navega a ella. Las visitas a la página también incluyen las actualizaciones de la página, las actualizaciones del sitio AJAX y el envío de datos mediante el método hit.