Yandex Metrica: konfiguracja i pomoc

Wykonaj kroki opisane w sekcji Szybki start.

Otwórz "Configure" w "Module Manager". Twój licznik Yandex musi już istnieć. W tabeli gotowości pod formularzem sprawdź wymaganą konfigurację i proces roboczy ponawiający wysyłkę.

Przeglądarka korzysta ze wspólnego czytnika zgód dla sygnałów Cookies Revolution, Cookie Banner, Cookiebot, OneTrust i TCF. Przetestuj konfigurację kategorii i usług. Uprawnienie jest odczytywane podczas wysyłki i może zostać wycofane. Wykryta obsługiwana platforma CMP nadal obowiązuje po wyłączeniu przełącznika respektowania zgody w module.

Moduł sprawdza własność licznika i zasady wysyłania danych poza sklep. Śledzenie pozostaje wstrzymane, jeśli inna integracja załadowała Yandex bez wskazania swojego licznika. Usuń powielony kod licznika z motywu lub modułów.

Wszystkie przełączniki standardowych zdarzeń mają domyślnie wartość Tak. Wyłącz te, których nie potrzebujesz.

Moduł ładuje https://mc.yandex.ru/metrika/tag.js. Inicjuje licznik z defer: true, oczyszczonym adresem URL i warstwą e-commerce przypisaną do licznika o nazwie mprYandexEcommerce_COUNTER_ID. Ustawia clickmap, trackLinks, accurateTrackBounce, webvisor i trackHash na false. Nie ma tu przełączników umożliwiających włączenie tych funkcji nagrywania lub automatycznych interakcji.

Dane zakupu używają numeru referencyjnego zamówienia jako identyfikatora transakcji i zawierają dostępne identyfikatory produktów, nazwy, kategorie, ceny, ilości, wartość i walutę. Standardowe zdarzenia koszyka korzystają z potwierdzonych sygnałów handlowych, a nie z przypuszczeń na podstawie kliknięć przycisków. Obsługa listy życzeń obejmuje powiadomienia mprwishlist:add i wishlist:add z identyfikatorem produktu. Niestandardowy motyw musi emitować oczekiwane sygnały powodzenia dla standardowego śledzenia zdarzeń.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" i "Track product engagement" mają domyślnie wartość Nie. Pola "Phone target", "Chat target", "Form target" i "Engagement target" są początkowo puste. Przed włączeniem danego sygnału wpisz dokładny identyfikator celu skonfigurowany na koncie Yandex. Identyfikatory celów mogą zawierać od 1 do 64 liter, cyfr, podkreśleń lub łączników.

Zdarzenia telefoniczne podają przybliżony obszar strony, rzeczywiste rozpoczęcia czatu korzystają z obsługiwanego sygnału Tawk, a formularze kontaktowe wymagają potwierdzenia odbioru przez serwer. Wartości pól formularza kontaktowego i numery telefonów nie są wysyłane jako właściwości tych sygnałów. Nie ma tu transportu formularzy przez serwerowe API.

Użyj "Product engagement thresholds" do konfiguracji JSON. Wartości domyślne to 3 interakcje z galerią, 1 zmiana wariantu, 1 interakcja ze szczegółami lub 45 sekund, z ograniczeniem częstotliwości obsługi opcji do 1500 ms. Liczby interakcji mogą wynosić od 1 do 20, czas przebywania od 5 do 600 sekund, a ograniczenie częstotliwości od 250 do 60000 ms. Domyślna nazwa zdarzenia to high_intent_product_engagement, z wyzwoleniem raz na produkt/sesję, gdy przechowywanie jest dozwolone.

"Track custom events" ma domyślnie wartość Nie. Pole Niestandardowe reguły zdarzeń jest początkowo puste. Nazwy mogą zawierać od 1 do 64 liter, cyfr, podkreśleń lub łączników. Możesz skonfigurować do 15 różnych nazw celów. W razie potrzeby utwórz odpowiadające im cele w liczniku Yandex; moduł nie konfiguruje konta u dostawcy.

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

Używaj skonfigurowanych statycznych params. Aktywne środowisko wykonawcze ignoruje dowolne szczegóły zdarzeń DOM i dodatkowe atrybuty klikniętych elementów. Nie udostępnia starej funkcji pomocniczej window.mprymtrTrack.

Reguła URL dopasowuje skonfigurowane fragmenty do ścieżki. Reguła kontrolera wymaga controllers; jej środowisko wykonawcze może też dopasować podane modules. Reguła zdarzenia DOM bez nazwy nasłuchuje mprymtr:custom. once domyślnie wynosi false dla kliknięć i true dla reguł URL, kontrolera i zdarzeń DOM. Aktualizuj selektory i nazwy tras po zmianach motywu lub procesu zamówienia.

Wysyłka z serwera wymaga zgody kupującego na analitykę, kupującego, który nie jest pracownikiem, oraz Yandex ClientID przechwyconego z własnego żądania kupującego. Moduł odczytuje ClientID z pliku cookie _ym_uid; nie używa starej wartości mprymtr_client_id i nigdy nie tworzy ClientID. ClientID musi być liczbą o długości od 3 do 64 cyfr.

Przy walidacji zamówienia moduł zapisuje zgodę i ClientID kupującego i dodaje kwalifikujące się zakupy do kolejki. Proces roboczy ponownie sprawdza aktualne ustawienia, własność licznika, reguły wysyłki, zapisane dane kupującego i wycofane zgody. Zakup z brakującymi lub nieznanymi danymi kupującego jest wstrzymywany. Pliki cookie z uruchomienia cron ani z przeglądarki pracownika nigdy nie są używane jako tożsamość kupującego.

Integracja rezerwuje jeden kanał zakupu na zamówienie i licznik. Rezerwacja serwerowa zapobiega zduplikowanemu zakupowi w przeglądarce, a rezerwacja przeglądarkowa uniemożliwia dopuszczenie po stronie serwera. Lokalne potwierdzenie ma biznesową tożsamość sklepu/zamówienia, a nie identyfikator zdarzenia SDK.

Upewnij się, że wspólny mechanizm cron MPR wykonuje:

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

Dostawca ma nazwę yandex_measurement_protocol we wspólnej kolejce konwersji. Proces roboczy działa w kontekście każdego włączonego sklepu. Tabela gotowości pokazuje liczbę pozycji oczekujących, wysyłanych, wysłanych i zakończonych błędem oraz informację o rejestracji procesu roboczego. Zarejestrowany proces oznacza tylko, że zadanie jest zaplanowane; wyniki dostarczenia pokazują liczby pozycji wysłanych i zakończonych błędem.

Sprawdź w tabeli gotowości identyfikator licznika, stan włączenia, zgodę, niestandardowe reguły, token, kolejkę i proces roboczy. Otwórz zwykłą przeglądarkę klienta z odpowiednią zgodą i sprawdź żądanie tagu oraz warstwę e-commerce przypisaną do licznika.

Zgodnie z ustawieniami przełączników przetestuj odsłony stron, cele produktów/kategorii, udane zmiany koszyka, listę życzeń, proces zamówienia, wyszukiwanie, rejestrację i zakup testowy. Sprawdź numer referencyjny transakcji, produkty, wartość i walutę. Osobno przetestuj odmowę i wycofanie zgody.

Jeśli licznik się nie ładuje, sprawdź stan włączenia, dodatnią wartość identyfikatora licznika, własność, zgodę na analitykę/usługę, zasady dotyczące pracowników i rezygnacji ze śledzenia, lokalne zasoby, powielone SDK oraz zablokowane żądania. Brak Webvisor w tej gałęzi jest oczekiwany.

Jeśli brakuje niestandardowego celu, sprawdź jego konfigurację w Yandex, skonfigurowaną nazwę, selektor i trasę. Umieść dozwolone parametry w regule JSON zamiast w atrybutach danych lub event.detail.

Jeśli zakup po stronie serwera jest wstrzymany, sprawdź token, oryginalny _ym_uid, zapisane dane kupującego i pracownika, stan wycofania zgody, rezerwację kanału i wynik procesu roboczego. Zakupu z przeglądarki, która nie miała ClientID, nie można wysłać z serwera.

Ustaw "Enable Yandex Metrica" na Nie i zapisz, aby wstrzymać śledzenie. Odinstaluj moduł przez "Module Manager", aby usunąć jego menu, rejestrację cron i konfigurację modułu. Wspólna tabela kolejki zostaje zachowana, jeśli inny moduł korzysta z pakietu konwersji; w przeciwnym razie jego funkcja odinstalowująca usuwa tę tabelę. Nie usuwaj ręcznie wspólnych tabel zgód i kanałów zakupów, które odinstalowanie zachowuje. Zarządzaj licznikiem i raportami historycznymi w Yandex.

Jeśli referencyjny zrzut ekranu różni się od zainstalowanej wersji, kieruj się powyższymi nazwami ustawień.