MarkerViewДокументацияУстановка на сайт
Разделы документации

Установка на сайт

Подключение через тег-менеджер

Как загрузить виджет через Яндекс Тег Менеджер или Google Tag Manager и отдельно указать место для отзывов.

Диспетчер тегов удобно использовать для одной глобальной загрузки MarkerView. Он решает только первую часть установки: место показа (#reviews-widget или #reviews-homepage) всё равно нужно добавить в CMS или шаблон страницы.

Ниже приведён путь для Яндекс Тег Менеджера. В другом диспетчере названия отличаются, но принцип тот же: пользовательский HTML, триггер страниц и обязательная публикация контейнера.

Перед началом

  1. В MarkerView обновите каталог и откройте Виджет → Конструктор → Подключение.
  2. Скопируйте сформированный сниппет полностью. Не сокращайте его до одного <script src>: конфигурация перед ним содержит адрес данных и публичные параметры вашего пространства.
  3. Убедитесь, что счётчик Яндекс Метрики установлен на сайте. Только владелец счётчика может включить Тег Менеджер; для этого в Настройки → Счётчик нужно включить Яндекс Тег Менеджер и функцию Пользовательский HTML.

Для MarkerView Cloud отдельный сервер не нужен. При self-hosted сначала завершите развёртывание и HTTPS-настройку, затем используйте сниппет из админ-панели собственного экземпляра.

Шаг 1. Добавьте якоря на сайт

В шаблон карточки товара поставьте:

<div id="reviews-widget"></div>

Если тема не выдаёт правильный SKU в Product JSON-LD, разработчик должен вывести артикул текущего товара явно:

<div id="reviews-widget" data-article="АРТИКУЛ_ТЕКУЩЕГО_ТОВАРА"></div>

На главной странице используйте <div id="reviews-homepage"></div>. Тег Менеджер не создаёт якорь в нужной части макета и не знает, какое поле CMS является артикулом.

Если URL карточек не начинается с /products/, разработчик должен указать реальный productPathPrefix в конфигурации скопированного сниппета. Триггер диспетчера тегов сам это ограничение loader не меняет.

Шаг 2. Создайте тег

  1. В Метрике откройте Тег Менеджер → Теги.
  2. Нажмите Добавить тег.
  3. Задайте понятное имя, например «MarkerView — виджет отзывов».
  4. Выберите шаблон Пользовательский HTML и вставьте актуальный сниппет MarkerView.
  5. Добавьте триггер показа. Самый простой вариант — загрузка на всех страницах: loader MarkerView обрабатывает главную и URL товаров, а на остальных страницах ничего не монтирует. Если политика сайта требует узкого правила, настройте условия URL для главной и карточек и обязательно проверьте переходы без полной перезагрузки страницы.
  6. Сохраните тег.

Пользовательский HTML должен быть разрешён владельцем счётчика. По официальной документации максимальный размер такого тега — 32 000 символов; сниппет MarkerView копируется как есть.

Шаг 3. Проверьте и опубликуйте

  1. Используйте режим предварительного просмотра Тег Менеджера и откройте живую карточку.
  2. Убедитесь, что тег сработал и в DOM есть якорь.
  3. В Тег Менеджере нажмите Опубликовать, укажите название и описание версии и подтвердите публикацию.
  4. Откройте сайт вне режима предпросмотра. Ожидаемый результат: на карточке виден товарный виджет, на главной — общая витрина.

Сохранённый, но не опубликованный тег посетители не получают. Это самая частая причина отсутствия виджета.

Частые ошибки

  • Нет варианта «Пользовательский HTML»: владелец счётчика не включил эту функцию.
  • Тег сработал, но виджета нет: отсутствует якорь, не определён артикул либо домен магазина не разрешён в MarkerView.
  • Работает после перезагрузки, но не при переходе между товарами: проверьте триггер и SPA-навигацию; глобальная однократная загрузка предпочтительнее повторной вставки скрипта.
  • Две загрузки: сниппет остался в CMS и добавлен в контейнер. Оставьте один способ.
  • Тест работает только у администратора: опубликована не версия контейнера, а лишь включён предпросмотр.

Официальные источники