Сервердик CAPI жана окуяларды көзөмөлдөө

MousePlayer трафигин өзүңүздүн биринчи тараптын сервердик GTM контейнери аркылуу өткөрүп, жарнама бөгөттөгүчтөрдү жана ITP чектөөлөрүн айланып өтүңүз; электрондук сооданын терең аналитикасын көзөмөлдөңүз.

1. Көзөмөлдөө режимдерине сереп

MousePlayer V2 маалыматтын колдонуучу браузеринен серверлерибизге агышын башкарган күчтүү Окуя багыттагычын киргизет. Үч өзүнчө режимден тандай аласыз:

  • Web Only (демейки): Бардык маалыматты WebSocket аркылуу түз MousePlayerге жөнөтөт. Чыныгы убакыттагы түз көрүнүш үчүн эң жакшы, бирок күчтүү жарнама бөгөттөгүчтөргө алсыз.
  • Hybrid режими: Эки тараптын артыкчылыгы. Жеңил чычкан/жылдыруу координаттарын жылмакай түз көрүнүш үчүн WebSocket аркылуу жөнөтөт, оор DOM өзгөрүүлөрү жана ыңгайлаштырылган окуялар топтолуп, сервердик GTMиңиз аркылуу HTTP POST менен коопсуз өткөрүлөт.
  • Pure CAPI: 100% HTTP POST топтоо. Эң жогорку купуялык, WebSocket жок, толугу менен биринчи тарапта. Эскертүү: бул режимде түз көрүнүш өчүк.

2. Google Tag Manager жөндөөсү (сунушталат)

Hybrid же Pure CAPI режимин ишке ашыруунун эң оңой жолу — расмий GTM Community үлгүлөрүбүздү колдонуу. Төмөндөгү .tpl файлдарын жүктөп, GTM жумуш мейкиндиктериңизге импорттоңуз.

Үлгүлөрдү жүктөө:

↓ Web GTM: MousePlayer SDK теги

↓ Server GTM: MousePlayer кабыл алуу кардары

↓ Server GTM: MousePlayer туташтыргыч теги

1-кадам: сервердик кардарды жана тегди жөндөө

Сервердик GTM контейнериңизге Кабыл алуу кардары үлгүсүн импорттоңуз. Ыңгайлаштырылган жолду угууга коюңуз (мисалы, /mp_capi). Андан кийин Туташтыргыч тегин импорттоп, mouseplayer_batch окуясында иштөөгө жөндөп, контейнерди жайгаштырыңыз.

2-кадам: Web GTM тегин жөндөө

Web GTM контейнериңизге SDK теги үлгүсүн импорттоңуз. Тег түрү катары «Configuration & Initialization» тандап, Channel ID киргизиңиз, андан соң Hybrid режимин тандап, ssGTM чекит URL дарегин киргизиңиз (мисалы, 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 жана Web-Only режимдери менен толук шайкеш.

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), мисалы чийки электрондук почта дарегин, чыныгы атты же сырсөздү окуя параметрлеринде жөнөтпөңүз .