CAPI سمت سرور و ردیابی رویداد

با مسیریابی ترافیک MousePlayer از کانتینر GTM سمت سرور دامنهٔ خودتان از مسدودکنندهٔ تبلیغ و محدودیت ITP بگذرید و تحلیل عمیق تجارت الکترونیک را دنبال کنید.

1. نمای حالت‌های ردیابی

MousePlayer V2 این مورد قدرتمند را معرفی می‌کند: Event Router تا جریان داده از مرورگر کاربر به سرور ما را کنترل کنید. سه حالت جدا دارید:

  • فقط وب (پیش‌فرض): همهٔ داده را با 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

↓ Server GTM: برچسب اتصال MousePlayer

گام 1: تنظیم کارخواه و برچسب سمت سرور

در کانتینر GTM سمت سرور این الگو را وارد کنید: کارخواه دریافت . شنیدن روی مسیر اختصاصی را تنظیم کنید (مثلاً /mp_capi). سپس این مورد را وارد کنید: برچسب اتصال، اجرای آن را روی رویداد mouseplayer_batch تنظیم و کانتینر را منتشر کنید.

گام 2: تنظیم برچسب Web GTM

در کانتینر Web GTM این را وارد کنید: برچسب SDK. نوع برچسب «Configuration & Initialization» را انتخاب و این را وارد کنید: Channel ID، این حالت را انتخاب کنید: حالت ترکیبی، و نشانی نقطهٔ پایانی 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 نویسه بریده می‌شود.
حریم خصوصی داده دادهٔ شخصی را هرگز مانند ایمیل خام، نام واقعی یا رمز عبور به‌صورت پارامتر رویداد نفرستید.