CAPI на страната на серверот & следење настани

Заобиколете ги блокаторите на реклами и ограничувањата на ITP со насочување на сообраќајот на MousePlayer преку вашиот сопствен GTM-контејнер од прва страна на серверот и следете детална аналитика за е-трговија.

1. Преглед на режимите за следење

MousePlayer V2 воведува моќен пренасочувач на настани што ви овозможува да контролирате како течат податоците од прелистувачот на корисникот до нашите сервери. Може да изберете од три различни режими:

  • Само веб (стандардно): Ги пренесува сите податоци преку WebSockets директно до MousePlayer. Најдобро за непречен приказ во реално време, но ранливо на силни блокатори на реклами.
  • Хибриден режим: Најдоброто од двата света. Испраќа лесни координати на глувче/лизгање преку WebSockets за непречен приказ во живо, додека обемните измени на DOM и приспособените настани се групираат и безбедно се насочуваат преку вашиот серверски GTM со HTTP POST.
  • Само CAPI: 100% HTTP POST-групирање. Максимална приватност, без WebSockets, целосно од прва страна. Забелешка: приказот во живо е оневозможен во овој режим.

2. Поставување Google Tag Manager (препорачано)

Најлесниот начин за воведување Хибриден или Само 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 пред вчитувањето на исечокот за следење.

<!-- 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 знаци за оптимални перформанси на базата на податоци.
Приватност на податоците Лични податоци не испраќајте како параметри на настани, на пример необработени адреси за е-пошта, вистински имиња или лозинки.