Yandex Metrica : installation et aide

Suivez les étapes du Démarrage rapide.

Ouvrez "Configure" depuis "Module Manager". Votre compteur Yandex doit déjà exister. Utilisez le tableau de préparation sous le formulaire pour vérifier la configuration requise et le worker de nouvelle tentative.

Le navigateur utilise le lecteur de consentement partagé pour les signaux de Cookies Revolution, Cookie Banner, Cookiebot, OneTrust et TCF. Testez la configuration de vos catégories et services. L’autorisation est lue lors de l’envoi et peut être retirée. Une CMP prise en charge et détectée reste applicable même lorsque l’option de respect du consentement du module est désactivée.

Le module vérifie l’appartenance du compteur et la politique des envois sortants de la boutique. Le suivi reste suspendu si une autre intégration a chargé Yandex sans identifier son compteur. Supprimez les doublons de code du compteur dans le thème ou les modules.

Tous les événements standard sont activés sur Oui par défaut. Désactivez ceux dont vous n’avez pas besoin.

Le module charge https://mc.yandex.ru/metrika/tag.js. Il initialise le compteur avec defer: true, une URL nettoyée et une couche e-commerce propre au compteur nommée mprYandexEcommerce_COUNTER_ID. Il définit clickmap, trackLinks, accurateTrackBounce, webvisor et trackHash sur false. Aucun interrupteur ne permet ici d’activer ces fonctions d’enregistrement ou d’interaction automatique.

Les données d’achat utilisent la référence de commande comme identifiant de transaction et incluent les identifiants produit, noms, catégories, prix, quantités, valeur et devise disponibles. Les événements de panier standard utilisent des signaux commerciaux confirmés, pas des clics de bouton spéculatifs. La prise en charge des listes d’envies inclut les notifications mprwishlist:add et wishlist:add avec un identifiant produit. Un thème personnalisé doit émettre les signaux de réussite attendus pour le suivi standard des événements.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" et "Track product engagement" sont sur Non par défaut. "Phone target", "Chat target", "Form target" et "Engagement target" sont initialement vides. Saisissez l’identifiant exact de l’objectif configuré dans votre compte Yandex avant d’activer le signal correspondant. Les identifiants d’objectif acceptent de 1 à 64 lettres, chiffres, traits de soulignement ou traits d’union.

Les événements téléphoniques indiquent une zone approximative de la page, les démarrages réels de chat utilisent le signal Tawk pris en charge et les formulaires de contact nécessitent une réception confirmée par le serveur. Les valeurs des formulaires de contact et les numéros de téléphone ne sont pas envoyés comme propriétés de ces signaux. Aucun transport de formulaire par API serveur n’est disponible ici.

Utilisez "Product engagement thresholds" pour la configuration JSON. Les valeurs par défaut sont 3 interactions avec la galerie, 1 changement de déclinaison, 1 interaction avec les détails ou 45 secondes, avec une limitation des options de 1500 ms. Les nombres d’interactions acceptés vont de 1 à 20, le temps de présence de 5 à 600 secondes et la limitation de 250 à 60000 ms. Le nom d’événement par défaut est high_intent_product_engagement, avec un déclenchement unique par produit/session lorsque le stockage est autorisé.

"Track custom events" est sur Non par défaut. Le champ Règles d’événements personnalisées est initialement vide. Les noms acceptent de 1 à 64 lettres, chiffres, traits de soulignement ou traits d’union. Vous pouvez configurer jusqu’à 15 noms d’objectif distincts. Créez les objectifs correspondants dans votre compteur Yandex si nécessaire ; le module ne configure pas votre compte fournisseur.

[
  {"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'));

Utilisez les params statiques configurés. L’environnement d’exécution actif ignore les détails arbitraires des événements DOM et les attributs supplémentaires des éléments cliqués. Il n’expose pas l’ancien utilitaire window.mprymtrTrack.

Une règle URL compare les fragments configurés au chemin. Une règle de contrôleur nécessite controllers ; son environnement d’exécution peut également faire correspondre les modules fournis. Une règle d’événement DOM sans nom écoute mprymtr:custom. once vaut par défaut false pour les clics et true pour les règles URL, de contrôleur et d’événement DOM. Actualisez les sélecteurs et les noms de route après des modifications du thème ou du processus de commande.

L’envoi côté serveur nécessite le consentement d’analyse de l’acheteur, un acheteur qui n’est pas membre du personnel et un ClientID Yandex capturé dans la requête de l’acheteur lui-même. Le module lit le ClientID dans le cookie _ym_uid ; il n’utilise pas l’ancienne valeur mprymtr_client_id et n’invente jamais de ClientID. Le ClientID doit être numérique, de 3 à 64 chiffres.

À la validation de la commande, le module enregistre le consentement et le ClientID de l’acheteur et met en file les achats admissibles. Le worker revérifie les paramètres actuels, l’appartenance du compteur, les règles d’envoi sortant, les données de l’acheteur enregistrées et les retraits de consentement. Un achat dont les données d’acheteur sont manquantes ou inconnues est suspendu. Les cookies de l’exécution cron ou du navigateur d’un employé ne servent jamais d’identité de l’acheteur.

L’intégration réserve un canal d’achat par commande et par compteur. Une réservation serveur empêche un achat en double dans le navigateur, et une réservation navigateur empêche l’admission côté serveur. Le reçu local est une identité métier boutique/commande, plutôt qu’un identifiant d’événement SDK.

Assurez-vous que votre exécuteur cron MPR partagé exécute :

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

Le fournisseur est yandex_measurement_protocol dans la file de conversions partagée. Le worker s’exécute dans le contexte de chaque boutique activée. Le tableau de préparation affiche les nombres d’éléments en attente, en cours d’envoi, envoyés et en échec, ainsi que l’enregistrement du worker. Un worker enregistré signifie seulement que la tâche est planifiée ; les nombres d’éléments envoyés et en échec montrent les résultats d’envoi.

Vérifiez dans le tableau de préparation l’ID du compteur, l’état d’activation, le consentement, les règles personnalisées, le token, la file et le worker. Ouvrez un navigateur client normal avec le consentement approprié et inspectez la requête du tag ainsi que la couche e-commerce propre au compteur.

Testez les consultations de page, objectifs produit/catégorie, modifications de panier réussies, liste d’envies, commande, recherche, inscription et achat test selon les options activées. Vérifiez la référence de transaction, les produits, la valeur et la devise. Testez séparément le refus et le retrait du consentement.

Si aucun compteur ne se charge, vérifiez l’état d’activation, la valeur positive de l’ID du compteur, l’appartenance, l’autorisation d’analyse/de service, la politique personnel/exclusion, les ressources locales, les SDK en double et les requêtes bloquées. L’absence de Webvisor est normale dans cette branche.

Si un objectif personnalisé manque, vérifiez sa configuration dans Yandex, le nom configuré, le sélecteur et la route. Placez les paramètres autorisés dans la règle JSON plutôt que dans les attributs de données ou event.detail.

Si un achat côté serveur est suspendu, vérifiez le token, le _ym_uid d’origine, les données enregistrées de l’acheteur et du personnel, l’état du retrait, la réservation du canal et le résultat du worker. Un achat provenant d’un navigateur sans ClientID ne peut pas être envoyé par le serveur.

Réglez "Enable Yandex Metrica" sur Non et enregistrez pour suspendre le suivi. Désinstallez via "Module Manager" pour supprimer son menu, son enregistrement cron et la configuration du module. La table de file partagée est conservée si un autre module utilise le package de conversions ; sinon, son utilitaire de désinstallation la supprime. Ne supprimez pas manuellement les tables partagées de consentement et de canaux d’achat que la désinstallation conserve. Gérez le compteur et les rapports historiques dans Yandex.

Utilisez les noms des paramètres ci-dessus lorsqu’une capture de référence diffère de votre version installée.