GTM интеграция и CAPI

1. Преглед на режимите за проследяване

MousePlayer V2 въвежда мощен маршрутизатор на събития, който ви позволява да контролирате потока на данни от браузъра на потребителя към сървърите ни. Можете да избирате между три различни режима:

Само уеб (по подразбиране): Предава всички данни чрез WebSocket връзки директно към MousePlayer. Най-подходящ за изглед на живо в реално време, но уязвим към агресивно блокиране на реклами.
Хибриден режим: Най-доброто от двата свята. Изпраща леки координати на мишката/превъртането чрез WebSocket връзки за плавен изглед на живо, а обемните DOM промени и персонализирани събития се пакетират и насочват сигурно през сървърния ви GTM с HTTP POST.
Pure CAPI: 100% пакетна обработка с HTTP POST. Максимална поверителност, без WebSocket връзки, изцяло от първа страна. Забележка: изгледът на живо е изключен в този режим.

2. Настройване на Google Tag Manager (препоръчително)

Най-лесният начин за внедряване на хибриден или Pure CAPI режим е чрез официалните ни шаблони от общността на GTM. Изтеглете файловете .tpl по-долу и ги импортирайте в работните си пространства в GTM.

Изтегляне на шаблони:

↓ Уеб GTM: SDK маркер за MousePlayer

↓ Сървърен GTM: клиент за приемане на MousePlayer

↓ Сървърен GTM: свързващ маркер за MousePlayer

Стъпка 1: конфигуриране на сървърния клиент и маркер

В сървърния си GTM контейнер импортирайте шаблона Клиент за приемане. Настройте го да слуша на собствен път (напр. /mp_capi). След това импортирайте Свързващ маркер, конфигурирайте го да се задейства при събитието mouseplayer_batch и внедрете контейнера си.

Стъпка 2: конфигуриране на уеб GTM маркера

В уеб GTM контейнера си импортирайте SDK маркер. Изберете „Конфигурация и инициализиране“ като тип маркер, въведете своя Channel ID, изберете Хибриден режим и поставете URL адреса на ssGTM крайната си точка (напр. https://metrics.yourdomain.com/mp_capi).

3. Ръчно инсталиране (без GTM)

Ако предпочитате да зададете скрипта директно в кода, трябва да дефинирате обекта window.mp_config преди зареждането на кода за проследяване.

<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. Ограничения на параметрите и указания

Типове данни: MousePlayer автоматично открива типовете параметри. Изпращайте числа като цели или с плаваща запетая (напр. 150.00, не "150.00"), за да позволите разширено числово филтриране (напр. „Цена > 100“) в таблото.

Правило	Описание
Дължина на името на събитието	Най-много 128 знака. Използвайте snake_case за най-добра четимост (напр. `user_signup`).
Дължина на ключа на параметъра	Най-много 64 знака в името на ключа (напр. `transaction_id`).
Текстови стойности	Текстовите параметри се съкращават до 255 знака за оптимална производителност на базата данни.
Поверителност на данните	Никога не изпращайте лични данни (PII) като необработени имейл адреси, истински имена или пароли като параметри на събития.

Как можем да помогнем?