Yandex Metrica: configuración y ayuda

Sigue los pasos de Inicio rápido.

Abre "Configure" desde "Module Manager". Tu contador de Yandex ya debe existir. Usa la tabla de preparación situada bajo el formulario para revisar la configuración necesaria y el proceso de reintentos.

El navegador utiliza el lector de consentimiento compartido para las señales de Cookies Revolution, Cookie Banner, Cookiebot, OneTrust y TCF. Prueba la configuración de categorías y servicios. El permiso se lee al enviar y puede retirarse. Una CMP compatible detectada sigue aplicándose aunque el interruptor del módulo para respetar el consentimiento esté desactivado.

El módulo comprueba la propiedad del contador y la política de salida de datos de la tienda. El seguimiento permanece en pausa si otra integración ha cargado Yandex sin identificar su contador. Elimina el código duplicado del contador del tema o de otros módulos.

Todos los interruptores de eventos estándar tienen el valor Sí de forma predeterminada. Desactiva los que no necesites.

El módulo carga https://mc.yandex.ru/metrika/tag.js. Inicializa el contador con defer: true, una URL depurada y una capa de comercio electrónico específica del contador llamada mprYandexEcommerce_COUNTER_ID. Establece clickmap, trackLinks, accurateTrackBounce, webvisor y trackHash en false. Aquí no hay interruptores para activar esas funciones de grabación o interacción automática.

Los datos de compra usan la referencia del pedido como ID de transacción e incluyen los ID de producto, nombres, categorías, precios, cantidades, valor y moneda disponibles. Los eventos estándar del carrito usan señales comerciales confirmadas, no clics especulativos en botones. La compatibilidad con listas de deseos incluye las notificaciones mprwishlist:add y wishlist:add con un ID de producto. Un tema personalizado debe emitir las señales de éxito esperadas para el seguimiento estándar de eventos.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" y "Track product engagement" tienen el valor predeterminado No. "Phone target", "Chat target", "Form target" y "Engagement target" comienzan vacíos. Introduce el identificador exacto del objetivo configurado en tu cuenta de Yandex antes de activar la señal correspondiente. Los identificadores de objetivo admiten de 1 a 64 letras, números, guiones bajos o guiones.

Los eventos telefónicos indican una zona aproximada de la página, los inicios reales de chat usan la señal compatible de Tawk y los formularios de contacto necesitan una recepción confirmada por el servidor. Los valores de los formularios y los números de teléfono no se envían como propiedades de esas señales. Aquí no hay transporte de formularios por API del servidor.

Usa "Product engagement thresholds" para la configuración JSON. Los valores predeterminados son 3 interacciones con la galería, 1 cambio de variante, 1 interacción con los detalles o 45 segundos, con una limitación de frecuencia de opciones de 1500 ms. Los recuentos de interacciones admiten de 1 a 20, el tiempo de permanencia de 5 a 600 segundos y la limitación de 250 a 60000 ms. El nombre predeterminado del evento es high_intent_product_engagement, con ejecución una vez por producto/sesión cuando se permite el almacenamiento.

"Track custom events" tiene el valor predeterminado No. El campo Reglas de eventos personalizados comienza vacío. Los nombres admiten de 1 a 64 letras, dígitos, guiones bajos o guiones. Puedes configurar hasta 15 nombres de objetivo distintos. Crea los objetivos correspondientes en tu contador de Yandex cuando los necesites; el módulo no configura tu cuenta del proveedor.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img,.images-container img","params":{"event_category":"Product","event_label":"Gallery browse"}},
  {"event":"PromoLandingView","trigger":"url","contains":["/promo","/special-offer"],"params":{"event_category":"Campaign"}},
  {"event":"ContactPageView","trigger":"controller","controllers":["contact"],"modules":["contactform"],"params":{"event_category":"Lead"}},
  {"event":"SizeGuideOpen","trigger":"event","dom_event":"store:sizeguide:open","params":{"event_category":"Product","event_label":"Size guide"}}
]

document.dispatchEvent(new CustomEvent('store:sizeguide:open'));

Usa los params estáticos configurados. El entorno de ejecución activo ignora los detalles arbitrarios de eventos DOM y los atributos adicionales de los elementos pulsados. No expone la antigua función auxiliar window.mprymtrTrack.

Una regla de URL compara los fragmentos configurados con la ruta. Una regla de controlador necesita controllers; su entorno de ejecución también puede encontrar coincidencias en los modules indicados. Una regla de evento DOM sin nombre escucha mprymtr:custom. once tiene el valor predeterminado false para clics y true para reglas de URL, controlador y eventos DOM. Actualiza los selectores y los nombres de ruta después de cambiar el tema o el proceso de pago.

El envío desde el servidor necesita el consentimiento analítico del comprador, un comprador que no sea personal y un ClientID de Yandex capturado de la propia solicitud del comprador. El módulo lee el ClientID de la cookie _ym_uid; no usa el antiguo valor mprymtr_client_id y nunca inventa un ClientID. El ClientID debe ser numérico, de 3 a 64 dígitos.

Al validar el pedido, el módulo guarda el consentimiento y el ClientID del comprador y pone en cola las compras aptas. El proceso vuelve a comprobar los ajustes actuales, la propiedad del contador, las reglas de salida, los datos guardados del comprador y las retiradas de consentimiento. Una compra con datos del comprador ausentes o desconocidos queda en espera. Las cookies de la ejecución cron o del navegador de un empleado nunca se usan como identidad del comprador.

La integración reserva un canal de compra por pedido y contador. Una reserva del servidor evita una compra duplicada del navegador, y una reserva del navegador impide la admisión al servidor. El comprobante local es una identidad comercial de tienda/pedido, en lugar de un ID de evento del SDK.

Asegúrate de que tu ejecutor cron compartido de MPR ejecute:

task: send_yandex_measurement_protocol
callable: mpryandexmetrica::cronProcessYandexMeasurementProtocolQueue
schedule: every:300
context: any
timeout: 30

El proveedor es yandex_measurement_protocol en la cola de conversiones compartida. El proceso se ejecuta en el contexto de cada tienda activada. La tabla de preparación muestra los recuentos de elementos pendientes, en envío, enviados y fallidos, y si el proceso está registrado. Un proceso registrado solo significa que la tarea está programada; los recuentos de enviados y fallidos muestran los resultados de la entrega.

Revisa en la tabla de preparación el ID del contador, el estado de activación, el consentimiento, las reglas personalizadas, el token, la cola y el proceso. Abre un navegador de cliente normal con el consentimiento correspondiente e inspecciona la solicitud de la etiqueta y la capa de comercio electrónico específica del contador.

Prueba las visitas de página, objetivos de producto/categoría, cambios correctos del carrito, lista de deseos, pago, búsqueda, registro y una compra de prueba según los interruptores activados. Revisa la referencia de la transacción, los productos, el valor y la moneda. Prueba por separado el rechazo y la retirada del consentimiento.

Si no se carga ningún contador, comprueba el estado de activación, el valor positivo del ID del contador, la propiedad, el permiso de analítica/servicio, la política de personal/exclusión, los recursos locales, los SDK duplicados y las solicitudes bloqueadas. La ausencia de Webvisor es normal en esta rama.

Si falta un objetivo personalizado, revisa su configuración en Yandex, el nombre configurado, el selector y la ruta. Incluye los parámetros permitidos en la regla JSON en lugar de usar atributos de datos o event.detail.

Si una compra desde el servidor queda en espera, revisa el token, el _ym_uid original, los datos guardados de comprador y personal, el estado de retirada, la reserva del canal y el resultado del proceso. Una compra desde un navegador que no tenía ClientID no se puede enviar desde el servidor.

Establece "Enable Yandex Metrica" en No y guarda para pausar el seguimiento. Desinstala desde "Module Manager" para eliminar su menú, el registro cron y la configuración del módulo. La tabla de cola compartida se conserva si otro módulo usa el paquete de conversiones; en caso contrario, su función de desinstalación elimina esa tabla. No elimines manualmente las tablas compartidas de consentimiento y canales de compra que la desinstalación conserva. Gestiona el contador y los informes históricos en Yandex.

Usa los nombres de los ajustes anteriores cuando una captura de referencia difiera de tu versión instalada.