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:
-
Cree e instale el código de etiqueta en su sitio, si aún no está instalado.
-
Al inicializar la etiqueta, establezca el parámetro
defer
entrue
. Esto es necesario para desactivar el envío automático de datos sobre vistas. Para registrar impresiones de página, use la funciónhit
, 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 })
-
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ónhit
: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 llamadaoptions.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.
CopiadoEjemplo 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.
Enlaces útiles |
Capacitación en línea |
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.