גשר GTM & גשר אירועי GA4

חיבור הטלמטריה הכמותית של Google Analytics 4 להקלטות הסשנים האיכותניות של MousePlayer, באמצעות סנכרון dataLayer דו-כיווני וממשקי API תואמי GA4.

1. סקירת ארכיטקטורה & יכולות

ניתוח אינטרנט מודרני סובל לעיתים מהפרדת נתונים בסיסית: פלטפורמות כמותיות (כגון Google Analytics 4) מדווחות מה קרה באתר, בעוד כלי הקלטת סשנים איכותניים מסבירים למה זה קרה. הגשר MousePlayer GTM & GA4 Bridge מבטל את הפער באמצעות יצירת ערוץ סנכרון דו-כיווני בסביבת הריצה של JavaScript בדפדפן.

כשהאפשרות מופעלת, סקריפט המעקב מאתחל שני מודולי ליבה ייעודיים:

  • מייצא הקלטות סשנים (initGa4SessionBridge): שולח אוטומטית את מזהה סשן ההקלטה הפעיל (mp_session_id) וקישור ישיר לניגון (mp_session_url) לשכבת הנתונים של האתר מיד עם יצירת הסשן.
  • קולט אירועי GA4 (initDataLayerBridge): מחבר מאזין שאינו דורס את מערך שכבת הנתונים. כל אירוע מסחר אלקטרוני או התנהגות מותאם שנשלח עבור GA4 משוכפל מיד לבסיס הנתונים האנליטי של MousePlayer כאירוע מותאם (ce), כולל כל הפרמטרים המספריים והטקסטואליים.

תמיכה באובייקט dataLayer מותאם: אם יישום אינטרנט משתמש בשם מותאם למערך JavaScript במקום השם הרגיל dataLayer (למשל xyzDataLayer), המנוע מתאים את עצמו דינמית לפרמטר שהוגדר gtm_datalayer_name ללא צורך בשינויי קוד ידניים.

2. ערך עסקי אסטרטגי

שילוב קישורי הקלטות ישירות בצינורות ניתוח ארגוניים מספק כמה יתרונות תפעוליים משמעותיים:

יכולת עסקית השפעה תפעולית
שיפור שיעור המרה (CRO) מאפשר לאנליסטים לזהות נקודות חיכוך במשפכי המרה של GA4 ולפתוח מיד הקלטות של משתמשים שנטשו סלים בשלבי תשלום מסוימים.
ייחוס הכנסות & ביקורת אפשר לבדוק עסקאות מסחר אלקטרוני בעלות ערך גבוה באמצעות צפייה במסלולי המצביע, בלחיצות ובמצבי אזור התצוגה המדויקים שהובילו לרכישה.
האצת איתור תקלות טכניות צוותי הנדסת QA יכולים לקשר אירועי חריגות JavaScript ב-GA4 או יומני שגיאות API ישירות להקלטות חזותיות של המסך, ללא צורך בשחזור ידני של באגים.
פתרון פניות תמיכה פניות תמיכה שמכילות מזהי סשן מאפשרות לנציגים לצפות בסשן המדויק של הלקוח, וכך לקצר מאוד את זמן הפתרון.

3. מדריך הגדרת Google Tag Manager

לקליטת ה-URL של ההקלטה ב-Google Tag Manager ולהעברתו ל-Google Analytics 4 יש להגדיר שלושה פריטי GTM נפרדים:

שלב 1: יצירת משתני שכבת נתונים

בסביבת העבודה של GTM יש לעבור אל Variables → User-Defined Variables וליצור שני משתנים מסוג Data Layer Variable:

  • שם משתנה: dlv - mp_session_id • שם משתנה שכבת נתונים: mp_session_id
  • שם משתנה: dlv - mp_session_url • שם משתנה שכבת נתונים: mp_session_url

שלב 2: יצירת טריגר ההפעלה

יש לעבור אל Triggers → New ולבחור את סוג הטריגר Custom Event. יש להגדיר את הפרמטרים הבאים:

  • שם אירוע: mp_session_ready
  • טריגר זה מופעל על: All Custom Events

שלב 3: הגדרת תג אירוע GA4

יש ליצור תג חדש מסוג Google Analytics: GA4 Event להעברת קישור הסשן לנכס GA4:

# GA4 Event Tag Configuration Tag Type: Google Analytics: GA4 Event Configuration Tag: [Select standard GA4 Configuration Tag] Event Name: mp_recording_ready # Event Parameters: | Parameter Name | Value | |-----------------|---------------------------| | mp_session_id | {{dlv - mp_session_id}} | | mp_session_url | {{dlv - mp_session_url}} | Triggering: Fire on Custom Event -> mp_session_ready

4. הגדרת חקירות (דוחות מותאמים) ב-GA4

לאחר פרסום תג GTM, GA4 מתחיל לקבל את ה-URL של ההקלטה כפרמטר אירוע. כדי לנתח נתונים אלה בדוחות חקירה מותאמים, תחילה יש לרשום את הפרמטר כממד מותאם.

רישום ממדים מותאמים בניהול GA4

בממשק Google Analytics 4 יש לעבור אל Admin → Data display → Custom definitions וללחוץ על Create custom dimension:

  • שם ממד: MousePlayer Session URL
  • היקף: Event (או Session אם הוא מצורף לפרמטרים ברמת הסשן)
  • פרמטר אירוע: mp_session_url

בניית חקירה לבדיקת סשנים

בחלק Explore של GA4 יש ליצור חקירה חדשה מסוג Free form לבדיקת מסעות משתמשים בודדים:

  • שורות: הוספת Event name, Transaction ID (למסחר אלקטרוני), או Landing page.
  • עמודות / ממדים: יש לכלול את הממד המותאם החדש MousePlayer Session URL.
  • ערכים: הוספת Event count או Total users.

טבלת הדוח שנוצרת מציגה כתובות URL ישירות ולחיצות לצד מדדי GA4, ומאפשרת מעבר מיידי מחריגים סטטיסטיים להקלטות חזותיות.

5. שילוב כתובות URL של הקלטות בדוחות ברירת המחדל של GA4

בנוסף לחקירות, ניתן לשלב ממדים מותאמים בדוחות ברירת המחדל הרגילים של GA4 (כגון Traffic acquisition, Pages and screens, או E-commerce purchases) באמצעות ספריית הדוחות של GA4.

שינוי טבלאות דוחות רגילים

  1. ב-GA4 יש לפתוח דוח מפורט רגיל כלשהו (למשל Reports → Engagement → Pages and screens).
  2. יש ללחוץ על סמל העיפרון Customize report בפינה הימנית העליונה (נדרשת גישת מנהל).
  3. בחלונית הימנית תחת Report Data, יש ללחוץ על Dimensions.
  4. יש להוסיף את MousePlayer Session URL לרשימת הממדים הראשית או המשנית ולהגדירו כגלוי.
  5. יש ללחוץ על Save → Save changes to current report.

לאחר השמירה, כל אנליסט שבודק טבלאות רכישת תעבורה או המרות רגילות יכול להוסיף את MousePlayer Session URL כממד משני, וכך לבדוק מיד חזותית את התנהגות המבקרים בפלחי התעבורה הרגילים.

6. מדריך תאימות JavaScript API & GA4 / GTM

MousePlayer מספק JavaScript API אינטואיטיבי ותואם GA4 (באמצעות פקודות רגילות בסגנון gtag()) ואובייקט גלובלי ציבורי (window.MousePlayer). כך מפתחים יכולים לקרוא כתובות URL של סשנים מהמסוף, לצרף מזהי לקוחות B2B ולהזריק קישורים להקלטות למוקדי תמיכה או למערכות מעקב שגיאות חיצוניות.

1. הזרקה ישירה של URL הקלטה (Intercom / Zendesk / גשרים מותאמים)

ניתן לאחזר את ה-URL המלא של הקלטת סשן המבקר הפעיל ישירות ממסוף הדפדפן או מכל סקריפט מותאם באמצעות window.MousePlayer.getSessionUrl():

// Example: Retrieve the active session URL and attach it to Intercom chat metadata if (window.MousePlayer && window.MousePlayer.getSessionUrl) { var replayUrl = window.MousePlayer.getSessionUrl(); console.log('Active Replay:', replayUrl); // Attach to Intercom Messenger metadata if (window.Intercom) { Intercom('update', { 'mouseplayer_replay_url': replayUrl }); } }

2. הגדרת מזהי לקוחות B2B מותאמים (user_id)

לזיהוי לקוחות SaaS או B2B מחוברים, ניתן להעביר מזהה מותאם user_id (כגון מזהה בסיס נתונים, דוא״ל או UUID) במהלך הגדרת הסקריפט הראשונית או באופן דינמי בזמן הריצה באמצעות תחביר GA4:

// Method A: Set user_id dynamically at login (GA4 / gtag style) mp('set', 'user_id', 'USR-987654'); // Method B: Set via config object mp('config', 'YOUR_CHANNEL_ID', { user_id: 'USR-987654' }); // Method C: Direct SDK invocation window.MousePlayer.setUserId('USR-987654');

3. שיטות אחזור נתונים אסינכרוניות

אפשר להשתמש בתחביר callback רגיל של GA4 לאחזור מטא-נתוני סשן באופן אסינכרוני בסקריפטים מותאמים של ניהול תגים:

// Retrieve active session URL mp('get', 'session_url', function(url) { console.log('Session URL:', url); }); // Retrieve visitor ID (Client ID equivalent) mp('get', 'client_id', function(clientId) { console.log('Visitor ID:', clientId); });

כל הסימנים המסחריים המוזכרים כאן שייכים לבעליהם בהתאמה. ל-MousePlayer אין קשר עסקי עם ספקים אלה.