د سرور اړخ CAPI او د پېښو تعقیب

د MousePlayer تګ راتګ د خپل لومړۍ خوا د سرور اړخ GTM کانټینر له لارې په لېږلو د اعلان بندوونکو او ITP محدودیتونو څخه تېر شئ او د برېښنايي سوداګرۍ ژوره شننه تعقیب کړئ.

1. د تعقیب د حالتونو عمومي کتنه

MousePlayer V2 پیاوړی دا وړاندې کوي: د پېښو لېږدوونکی چې اجازه درکوي کنټرول کړئ معلومات ستاسو د کارن له براوزر څخه زموږ سرورونو ته څنګه ځي. له دریو بېلو حالتونو ټاکنه کولی شئ:

  • یوازې وېب (اصلي): ټول معلومات د WebSocket له لارې مستقیم MousePlayer ته لېږي. د ریښتیني وخت ژوندۍ کتنې لپاره غوره، خو د پیاوړو اعلان بندوونکو پر وړاندې زیان‌من دی.
  • ګډ حالت: د دواړو ګټې. د موږک/رغړولو سپک مختصات د WebSocket له لارې د نرمې ژوندۍ کتنې لپاره لېږي، خو د DOM درانه بدلونونه او خپلې پېښې په ډلو کې د HTTP POST له لارې ستاسو د سرور اړخ GTM څخه په خوندي ډول لېږي.
  • خالص CAPI: 100% HTTP POST ډله‌ییز لېږل. تر ټولو ډېر محرمیت، صفر WebSocket، بشپړ د لومړۍ خوا. یادونه: ژوندۍ کتنه په دې حالت کې بنده ده.

2. د Google Tag Manager تنظیم (سپارښتل شوی)

د ګډ یا خالص CAPI حالتونو د پلي کولو تر ټولو اسانه لاره زموږ د GTM رسمي ټولنیزو بېلګو کارول دي. لاندې دا ښکته کړئ: .tpl دوتنې، او خپلو GTM کاري چاپېریالونو ته یې واردې کړئ.

بېلګې ښکته کړئ:

↓ Web GTM: د MousePlayer SDK نښه

↓ Server GTM: د MousePlayer د معلوماتو اخیستلو مراجع

↓ Server GTM: د MousePlayer د نښلوونکي نښه

ګام 1: د سرور اړخ مراجع او نښه تنظیم کړئ

د خپل سرور اړخ GTM کانټینر کې دا وارد کړئ: Ingest Client بېلګه. په خپله لار یې اورېدو ته وټاکئ (لکه، /mp_capi). بیا دا وارد کړئ: Connector Tag، داسې یې تنظیم کړئ چې په دې فعاله شي: mouseplayer_batch پېښه، او خپل کانټینر خپور کړئ.

ګام 2: د وېب GTM نښه تنظیم کړئ

په خپل Web GTM کانټینر کې دا وارد کړئ: SDK Tag. د Tag Type په توګه «Configuration & Initialization» وټاکئ، خپل دا ولیکئ: Channel ID، وټاکئ Hybrid Mode، او د خپل 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' });

خپل د UI تعامل

پوه شئ چې کارنان له پېچلو عناصرو لکه حسابوونکو، کړکیو یا د ټب له بدلوونکو سره څنګه تعامل کوي.

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) لکه خامې برېښنالیک پتې، رښتیني نومونه یا پټنومونه د پېښو د پارامترونو په توګه.