Серверный CAPI и отслеживание событий

Обходите блокировщики и ITP, направляя трафик через собственный серверный контейнер GTM; отслеживайте подробную торговую аналитику.

1. Обзор режимов

MousePlayer V2 предлагает мощный Event Router для управления потоком из браузера на серверы. Три режима:

  • Только веб (по умолчанию): Все данные WebSockets прямо в MousePlayer. Лучше для живого просмотра, но уязвимы к строгим блокировщикам.
  • Гибрид: Лёгкие координаты мыши и прокрутки по WebSockets для плавного просмотра; объёмные изменения DOM и события безопасно пакетами HTTP POST через серверный GTM.
  • Чистый CAPI: 100% пакетный HTTP POST. Максимальная конфиденциальность, без WebSockets, полностью собственный канал. Примечание: живой просмотр в этом режиме отключён.

2. Настройка Google Tag Manager (рекомендуется)

Проще всего Hybrid и чистый CAPI через официальные шаблоны сообщества GTM. Скачайте файлы .tpl ниже и импортируйте в рабочие пространства GTM.

Скачать шаблоны:

↓ Web GTM: тег MousePlayer SDK

↓ Server GTM: клиент приёма MousePlayer

↓ Server GTM: тег коннектора MousePlayer

Шаг 1: серверный клиент и тег

В серверный GTM импортируйте шаблон Ingest Client . Задайте свой путь прослушивания, например /mp_capi. Затем импортируйте Connector Tag, задайте запуск по событию mouseplayer_batch и опубликуйте контейнер.

Шаг 2: веб-тег GTM

В веб-контейнер импортируйте SDK Tag. Выберите «Конфигурация и инициализация» типом, введите Channel ID, выберите Гибрид и вставьте URL эндпоинта ssGTM, например https://metrics.yourdomain.com/mp_capi.

3. Ручная установка (без GTM)

При жёсткой настройке определите объект window.mp_config до загрузки сниппета.

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. Воронка электронной торговли

Отслеживайте полный путь клиента. Стандартные имена позволяют MousePlayer автоматически строить наглядные воронки в проекте. Все события совместимы с CAPI и веб-режимом.

1. view_item

Вызывайте при просмотре страницы конкретного товара.

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

Вызывайте при добавлении товара в корзину.

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

Вызывайте при переходе к оформлению.

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

Вызывайте при успешной оплате или подтверждении заказа.

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. Свои события и получение лидов

Не только торговля: формы, подписки и особые взаимодействия вашего приложения.

Получение лида (форма)

Вызывайте при успешной отправке контакта или запросе предложения.

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

Собственное взаимодействие интерфейса

Изучайте работу со сложными элементами: калькуляторами, окнами, вкладками.

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. Ограничения параметров и правила

Типы данных: Тип определяется автоматически. Передавайте числа целыми или дробными, например 150.00, а не "150.00", для числовых фильтров панели, например «Цена > 100».

Правило Описание
Длина имени события До 128 символов. Для читаемости snake_case, например user_signup.
Длина ключа параметра До 64 символов, например transaction_id.
Строки Текст обрезается до 255 символов для быстрой работы базы.
Конфиденциальность данных Не передавайте персональные данные: почту в открытом виде, реальные имена и пароли в параметрах событий.