Сервер жағындағы CAPI және оқиғаларды бақылау

MousePlayer трафигін өз бірінші тараптық серверлік GTM контейнеріңіз арқылы бағыттап, жарнама бұғаттағыштары мен ITP шектеулерін айналып өтіңіз және электрондық сауданы терең талдаңыз.

1. Бақылау режимдеріне шолу

MousePlayer V2 қуатты оқиға маршрутизаторын ұсынады. Ол пайдаланушы браузерінен серверлерімізге дерек ағынын басқаруға мүмкіндік береді. Үш бөлек режимнің бірін таңдай аласыз:

  • Тек веб (әдепкі): Барлық деректі WebSockets арқылы тікелей MousePlayer жүйесіне жібереді. Нақты уақыттағы тікелей көрініске ең ыңғайлы, бірақ қатаң жарнама бұғаттағыштарына осал.
  • Аралас режим: Екі тәсілдің артықшылықтарын біріктіреді. Жеңіл тінтуір/айналдыру координаттарын бірқалыпты тікелей көрініс үшін WebSockets арқылы жібереді. Көлемді DOM өзгерістері мен арнайы оқиғалар топтамаға жиналып, серверлік GTM арқылы HTTP POST көмегімен қауіпсіз жіберіледі.
  • Таза CAPI: 100% HTTP POST топтамалауы. Ең жоғары құпиялық, WebSockets жоқ, толық бірінші тараптық. Ескерту: бұл режимде тікелей көрініс өшірулі.

2. Google Tag Manager баптауы (ұсынылады)

Аралас не таза CAPI режимін орнатудың ең оңай жолы — ресми GTM қауымдастық үлгілерімізді қолдану. Төмендегі .tpl файлдарын жүктеп алып, GTM жұмыс кеңістіктеріңізге импорттаңыз.

Үлгілерді жүктеп алу:

↓ Web GTM: MousePlayer SDK тегі

↓ Server GTM: MousePlayer Ingest Client

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

1-қадам: серверлік клиент пен тегті баптау

Серверлік GTM контейнеріңізге Ingest Client үлгісін импорттаңыз. Арнайы жолды тыңдайтындай баптаңыз (мысалы, /mp_capi). Содан кейін Connector Tagимпорттап, мына оқиғада іске қосылатындай баптаңыз: mouseplayer_batch және контейнерді іске қосыңыз.

2-қадам: веб-GTM тегін баптау

Веб-GTM контейнеріңізге SDK Tagимпорттаңыз. Tag Type ретінде «Configuration & Initialization» таңдап, мына мәнді енгізіңіз: Channel ID, режим ретінде Аралас режимтаңдаңыз да, 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 және тек веб режимдерімен толық үйлесімді.

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 таңбаға дейін қысқартылады.
Деректер құпиялығы Оқиға параметрі ретінде ашық электрондық пошта, нақты ат немесе құпиясөз сияқты жеке деректерді жібермеңіз .