سرور پر CAPI اور ایونٹ ٹریکنگ

MousePlayer ٹریفک اپنے فرسٹ پارٹی Server-Side GTM کنٹینر سے بھیج کر اشتہار روکنے والے ٹولز اور ITP کی پابندیوں سے بچیں، اور ای کامرس کا گہرا تجزیہ ٹریک کریں۔

1. ٹریکنگ موڈز کا جائزہ

MousePlayer V2 میں طاقتور یہ نظام ہے: ایونٹ راؤٹر جو صارف کے براؤزر سے ہمارے سرورز تک ڈیٹا کا بہاؤ آپ کے اختیار میں دیتا ہے۔ تین موڈز منتخب کر سکتے ہیں:

  • Web Only (طے شدہ): تمام ڈیٹا WebSockets سے براہِ راست MousePlayer تک پہنچتا ہے۔ حقیقی وقت کے لائیو نظارے کے لیے بہترین، مگر سخت اشتہار روکنے والے ٹولز سے متاثر ہو سکتا ہے۔
  • Hybrid Mode: دونوں کی خوبیاں۔ ہلکے ماؤس/اسکرول نقاط ہموار لائیو نظارے کے لیے WebSockets سے بھیجتا ہے، جبکہ بھاری DOM تبدیلیاں اور حسبِ ضرورت ایونٹس جمع ہو کر آپ کے Server-Side GTM سے محفوظ HTTP POST کے ذریعے جاتے ہیں۔
  • Pure CAPI: 100% HTTP POST کی مجموعی ترسیل۔ زیادہ سے زیادہ رازداری، صفر WebSockets، مکمل فرسٹ پارٹی۔ توجہ: اس موڈ میں لائیو نظارہ بند ہے۔

2. Google Tag Manager کی ترتیب (تجویز کردہ)

Hybrid یا Pure CAPI موڈ اپنانے کا آسان ترین طریقہ ہمارے سرکاری GTM Community Templates ہیں۔ نیچے دی گئی اس قسم کی فائلیں ڈاؤن لوڈ کریں: .tpl اور اپنے GTM ورکاسپیسز میں درآمد کریں۔

سانچے ڈاؤن لوڈ کریں:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

مرحلہ 1: سرور کے کلائنٹ اور ٹیگ کی ترتیب

Server-Side GTM کنٹینر میں یہ سانچہ درآمد کریں: Ingest Client۔ اسے حسبِ ضرورت راستہ سننے کو مقرر کریں (مثلاً /mp_capi)۔ پھر یہ درآمد کریں: Connector Tag، اسے اس ایونٹ پر چلائیں: mouseplayer_batch، اور کنٹینر نافذ کریں۔

مرحلہ 2: Web GTM ٹیگ کی ترتیب

Web GTM کنٹینر میں یہ درآمد کریں: SDK Tag۔ ٹیگ کی قسم “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 اور 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' });

حسبِ ضرورت UI تعامل

سمجھیں کہ صارفین کیلکولیٹرز، مکالموں یا ٹیب بدلنے جیسے پیچیدہ عناصر کیسے استعمال کرتے ہیں۔

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. پیرامیٹرز کی حدود اور رہنمائی

ڈیٹا کی قسم: MousePlayer خود پیرامیٹر کی قسم پہچانتا ہے۔ اعداد صحیح یا اعشاری صورت میں بھیجیں (مثلاً 150.00، یہ نہیں: "150.00") تاکہ ڈیشبورڈ میں جدید عددی فلٹرنگ ہو سکے (مثلاً “Price > 100”)۔

اصول تفصیل
ایونٹ نام کی لمبائی زیادہ سے زیادہ 128 حروف۔ آسان قرأت کے لیے snake_case استعمال کریں (مثلاً user_signup)۔
پیرامیٹر کلید کی لمبائی ہر کلید نام کے لیے زیادہ سے زیادہ 64 حروف (مثلاً transaction_id)۔
متنی قدریں ڈیٹابیس کی بہتر کارکردگی کے لیے متنی پیرامیٹرز 255 حروف تک محدود کیے جاتے ہیں۔
ڈیٹا کی رازداری ایونٹ پیرامیٹرز میں نہ بھیجیں: ذاتی شناخت کی معلومات (PII)، مثلاً خام ایمیل پتے، حقیقی نام یا پاسورڈ۔