CAPI בצד השרת ומעקב אירועים

עקיפת חוסמי פרסומות ומגבלות ITP באמצעות ניתוב תעבורת MousePlayer דרך מכולת GTM משלך בצד השרת ובדומיין צד ראשון, ומעקב אחר ניתוח מסחר אלקטרוני מעמיק.

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 Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

שלב 1: הגדרת הלקוח והתג בצד השרת

במכולת GTM בצד השרת יש לייבא את התבנית Ingest Client ולהגדיר האזנה בנתיב מותאם (למשל /mp_capi). לאחר מכן יש לייבא את Connector Tag ולהגדיר הפעלה באירוע mouseplayer_batch ואז לפרוס את המכולה.

שלב 2: הגדרת תג Web GTM

במכולת Web GTM יש לייבא את SDK Tag. יש לבחור “Configuration & Initialization” כסוג התג, להזין את Channel ID, לבחור Hybrid Mode ולהדביק את URL נקודת הקצה 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 תווים כדי להבטיח ביצועים מיטביים בבסיס הנתונים.
פרטיות נתונים אין לשלוח מידע מזהה אישי (PII) כגון כתובות דוא״ל גולמיות, שמות אמיתיים או סיסמאות כפרמטרי אירוע.