דלג לתוכן הראשי

פתרון בעיות

מדריך זה מספק הנחיות לאבחון ופתרון בעיות עם ה-MSQ Pixel SDK.

הפעלת מצב Debug​

כדי להפעיל מצב debug, הגדירו את setting_debug ל-true:

var msq_pixel_settings = {
  setting_api_key: 'your_api_key',
  setting_debug: true
};

בדיקת לוגים בקונסול​

כאשר מצב debug מופעל, ה-SDK ירשום מידע מפורט לקונסול הדפדפן בצורה צבעונית עם אמוג'י לפי רמת הלוג:

אמוג'ירמהמציין
📗successפעולה הצליחה
📘infoמידע כללי
📕errorשגיאה
📙warningאזהרה
📔verboseמידע מפורט (כולל התאמת conditions_filter)

דוגמאות להודעות נפוצות:

📘 MSQ Info: Initialization successful
📕 MSQ Error: API key is missing in pixel_settings. MSQ Class not initialized.
📔 MSQ Verbose: [MATCH] [referrer_search_and_replace] Condition matched...
📙 MSQ Warning: Dynamic number allocation failed, using static

אימות מפתח API​

ודאו שסיפקתם מפתח API תקף באובייקט msq_pixel_settings. מפתח ה-API נדרש לפעולה תקינה של ה-SDK:

var msq_pixel_settings = {
  setting_api_key: 'your_valid_api_key'
};

בדיקת בקשות רשת​

השתמשו בכלי המפתח של הדפדפן כדי לבדוק בקשות רשת שה-SDK שולח. חפשו בקשות לשרת מסקיו ובדקו את קודי הסטטוס והתגובות:

GET https://analytics.maskyoo.net/json_pixel.php?api_key=your_api_key&...
200 OK

איך לבדוק בקשות רשת​

  1. פתחו את Developer Tools (F12 או Ctrl+Shift+I)
  2. עברו ללשונית "Network"
  3. סננו לפי "maskyoo"
  4. טענו מחדש את הדף
  5. בדקו שהבקשות מחזירות קוד 200

בעיות נפוצות ופתרונות​

מפתח API חסר​

בעיה: הודעת שגיאה "API key is missing"

פתרון: ודאו שה-api_key מוגדר באובייקט msq_pixel_settings:

var msq_pixel_settings = {
  setting_api_key: 'YOUR_API_KEY'  // חובה
};

שגיאות רשת​

בעיה: בקשות נכשלות או מחזירות שגיאה

פתרון:

  • בדקו את חיבור האינטרנט
  • ודאו ששרת מסקיו נגיש
  • בדקו אם יש חסימת firewall או CORS

הסקריפט לא נטען​

בעיה: ה-SDK לא זמין בדף

פתרון:

  • ודאו שה-URL של הסקריפט נכון
  • בדקו שהסקריפט נכלל בקובץ ה-HTML
  • ודאו שאין שגיאות JavaScript בקונסול לפני טעינת הסקריפט

הודעות Debug לא מופיעות​

בעיה: לא רואים לוגים בקונסול

פתרון:

  • ודאו ש-setting_debug מוגדר ל-true
  • בדקו שהקונסול מציג הודעות ברמת "Info" ו-"Verbose"
  • נסו לרענן את הדף

החלפת מספרים לא עובדת​

בעיה: מספרי הטלפון לא מוחלפים

פתרון:

  1. בדקו שה-conditions_filter תואם את ה-URL/referrer הנוכחי
  2. ודאו שה-search_for_number קיים בדף
  3. בדקו ש-CSS selector נכון (אם משתמשים ב-selector)
  4. הפעילו מצב debug לראות איזה כללים רצים
// דוגמה לכלל עם לוג
{
  function: 'referrer_search_and_replace',
  params: {
    conditions_filter: '*',  // תנאי שתמיד מתקיים - לבדיקה
    search_for_number: '055-4300000',
    replace_number: '055-4311111'
  },
  callback: function(result) {
    console.log('Result:', result);
  }
}

בעיות עם מספרים דינמיים​

בעיה: הקצאה דינמית נכשלת

פתרון:

  • ודאו שה-dynamic_url נכון ונגיש
  • בדקו שה-dynamic_campaign_id תקין
  • בדקו שהמספר הסטטי (dynamic_static) מוגדר כחלופה

שליחת לוגים ל-GA4​

ניתן לשלוח שגיאות ואזהרות אוטומטית ל-Google Analytics 4 להמשך ניתוח:

var msq_pixel_settings = {
  setting_api_key: 'your_api_key',
  setting_debug: true,
  setting_debug_ga4_tid: 'G-XXXXXXXXXX'  // מזהה GA4 שלכם
};

כל הודעה ברמת error או warning תישלח כאירוע msq_pixel_debug ל-GA4.

יצירת קשר עם התמיכה​

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

  1. תיאור הבעיה
  2. הודעות שגיאה מהקונסול
  3. צילום מסך של לשונית Network
  4. קוד ה-SDK והכללים שהגדרתם
  5. URL של הדף הבעייתי

שאלות נפוצות (FAQ)​

מהו ה-MSQ Pixel SDK?​

ה-MSQ Pixel SDK הוא ספריית JavaScript שמאפשרת לשלב מעקב פיקסל של מסקיו באפליקציות האינטרנט שלכם. הוא מספק פונקציות למעקב אירועים, ניהול מפתחות API, והחלפת תוכן דינמית.

איך מתקינים את ה-SDK?​

הוסיפו את הסקריפט הבא ל-HTML:

<script id="msq_pixel_id" async type="text/javascript"
  src="https://s3.eu-central-1.amazonaws.com/maskyoo-cdn/msq_pixel_2024.js?setting_disable_autorun=true">
</script>

ראו את מדריך ההתקנה לפרטים מלאים.

איך בודקים שה-SDK עובד?​

  1. הפעילו מצב debug
  2. בדקו הודעות עם קידומת MSQ בקונסול
  3. בדקו בקשות רשת לשרת מסקיו

אילו הגדרות זמינות ב-SDK?​

ראו את מדריך ההגדרות לרשימה מלאה, כולל:

  • setting_api_key - מפתח API לאימות
  • setting_disable_autorun - השבתת אתחול אוטומטי
  • setting_debug - הפעלת מצב debug

איך מגדירים משתנים מותאמים אישית?​

השתמשו באובייקט msq_params:

var msq_params = {
  'param1': 'value1',
  'param2': 'value2'
};

השפעות על המערכת​

תקלות ב‑SDK עלולות להשפיע על זיהוי מקור השיחה ועל הדוחות:

  • מפתח API שגוי — הפיקסל לא נרשם ב‑analytics.maskyoo.net וכל השיחות המתקבלות יוצגו ללא מקור קמפיין
  • CORS / חסימת cookies — דפדפן שחוסם third‑party cookies יעכב זיהוי GA4/Facebook; לרוב ניתן להתגבר על ידי setting_ignore_cookies או לקוח רלוונטי
  • כללים שלא רצים — אם conditions_filter לא תואם, אין החלפה; נרשם בדיבאג כ‑Condition did not match
  • שגיאות JS בצד לקוח — שגיאה לפני טעינת ה‑SDK תמנע אתחול; בדוק לפני הסקריפט ב‑try/catch
  • דיבוג ל‑GA4 — setting_debug_ga4_tid שולח שגיאות כאירוע msq_pixel_debug ל‑GA4, מאפשר ניתוח שגיאות רוחבי ביישום
  • השפעה על ייחוס שיחות — כשל ב‑SDK = חיסור מידע בדוחות שיחות, Google Ads Offline Conversion ו‑Facebook

ראו גם​