Серверны CAPI і адсочванне падзей

Абыходзьце блакіроўшчыкі і ITP, накіроўваючы трафік праз свой серверны кантэйнер GTM першага боку, і атрымлівайце глыбокую аналітыку камерцыі.

1. Агляд рэжымаў

MousePlayer V2 прапануе магутны Event Router для кіравання патокам даных з браўзера на серверы. Ёсць тры рэжымы:

  • Толькі вэб (па змаўчанні): Усе даныя праз WebSocket непасрэдна ў MousePlayer. Найлепш для жывога прагляду, але ўразліва да моцных блакіроўшчыкаў.
  • Гібрыдны рэжым: Лепшае з абодвух: лёгкія каардынаты мышы/пракруткі праз WebSocket для плаўнага прагляду, цяжкія змены DOM і падзеі — бяспечнымі пакетамі HTTP POST праз серверны GTM.
  • Чысты CAPI: 100% пакеты HTTP POST. Максімальная прыватнасць, без WebSocket, цалкам першы бок. Заўвага: жывы прагляд тут выключаны.

2. Налада Google Tag Manager (рэкамендуецца)

Самы просты спосаб — афіцыйныя шаблоны супольнасці GTM. Спампуйце файлы .tpl ніжэй і імпартуйце ў прасторы GTM.

Спампаваць шаблоны:

↓ Вэб-GTM: тэг MousePlayer SDK

↓ Серверны 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 перад загрузкай кода адсочвання.

<!-- 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. Ліміты і правілы параметраў

Тыпы даных: MousePlayer вызначае тып аўтаматычна. Перадавайце цэлыя або дробавыя лікі (напрыклад, 150.00, не "150.00") для лікавай фільтрацыі (напрыклад, «Цана > 100») на панэлі.

Правіла Апісанне
Даўжыня назвы падзеі Да 128 сімвалаў. Выкарыстоўвайце snake_case для чытэльнасці (напрыклад, user_signup).
Даўжыня ключа параметра Да 64 сімвалаў на ключ (напрыклад, transaction_id).
Радковыя значэнні Тэкставыя параметры абразаюцца да 255 сімвалаў дзеля прадукцыйнасці базы.
Прыватнасць даных Ніколі не перадавайце асабістыя даныя (PII), напрыклад адкрытую пошту, сапраўдныя імёны або паролі, у параметрах падзей.