הגדרות משתנים

מדריך זה מפרט את כל המשתנים הזמינים להגדרה ב-MSQ Pixel SDK.

משתני הגדרות (Settings)

המשתנים הבאים זמינים בקובץ msq_pixel_2024.js ומאפשרים לכם להגדיר את התנהגות ה-SDK:

משתנים בסיסיים

משתנה	סוג	חובה	תיאור
setting_api_key	string	כן	מפתח API לאימות וזיהוי הלקוח
setting_disable_autorun	boolean	לא	אם true, ה-SDK מאותחל אך לא יריץ process() באופן אוטומטי (שליחת פיקסל)
setting_run_rules	boolean	לא	אם true, מריץ את msq_phone_replace_rules מיד לאחר האתחול
setting_async_code_run	boolean	לא	Deprecated — שם ישן של setting_run_rules. נתמך לתאימות לאחור
setting_debug	boolean	לא	מפעיל מצב debug עם לוגים צבעוניים מפורטים ב-console
debug_mode	boolean	לא	כינוי נוסף למצב debug, משמש בעיקר בלוגי ההפעלה

משתני Google Analytics

משתנה	סוג	תיאור
setting_ga4_tid	string	מזהי GA4 להפעלה. במקרה של יותר מאחד, הפרידו בפסיקים. דוגמה: G-VKHNY1QXVL,G-4RC6WQB4PR
setting_debug_ga4_tid	string	כאשר מוגדר עם GA4 Measurement ID תקין, שגיאות ואזהרות יישלחו כאירועים מותאמים (msq_pixel_debug) ל-GA4

משתני מספרי Maskyoo

משתנה	סוג	תיאור
setting_default_maskyoo	string	מספר מסקיו ברירת מחדל שיישלח בפיקסל (בשדה __maskyoo) כאשר לא בוצעה החלפה בדף. דוגמה: 0776670000

משתני טעינה וסנכרון

משתנה	סוג	תיאור
setting_wait4async	boolean	שולט בהמתנה לטעינת סקריפטים אסינכרוניים של Google לפני שליחת הפיקסל. ברירת מחדל: true (מומלץ)
setting_retry_load_interval	number	מרווח (במילישניות) לניסיון חוזר לטעינת סקריפטים אסינכרוניים. ברירת מחדל: 350ms
setting_delay_load	number	עיכוב (במילישניות) לפני תחילת בדיקת טעינה של סקריפטים
setting_ignore_cookies	boolean	אם true, הסקריפט מתעלם מ-cookies (GA4 / Facebook). ברירת מחדל: false
setting_fbq_retry_delay	number	מרווח (במילישניות) לניסיונות חוזרים לאיתור fbq. ברירת מחדל: 50ms (עד 3 ניסיונות)

מספרים דינמיים

הפרמטרים dynamic_url, dynamic_campaign_id, dynamic_platform, dynamic_static, dynamic_interval, dynamic_ttl, dynamic_die_timeout אינם משתני הגדרות של msq_pixel_settings אלא פרמטרים של כללי msq_phone_replace_rules. ראו פונקציות דינמיות לפרטים.

דוגמה לשימוש

var msq_pixel_settings = {
  setting_api_key: 'YOUR_API_KEY',
  setting_debug: true,
  setting_default_maskyoo: '0776670000',
  setting_ga4_tid: 'G-XXXXXXXXXX',
  setting_wait4async: true,
  setting_ignore_cookies: false
};

קידומת setting_

כל משתנה שמתחיל ב-setting_ מועתק פנימה ל-this.setting (בלי הקידומת). כל משתנה אחר ב-msq_pixel_settings מועתק ישירות ל-properties של הפיקסל ויישלח כחלק מה-query string של הפיקסל. מחרוזות "true" / "false" מומרות אוטומטית ל-boolean.

משתנים מותאמים אישית (Custom Variables)

האובייקט msq_params מאפשר לכם להגדיר משתנים מותאמים אישית; ערכיו נדחפים ל-properties של הפיקסל בעת טעינת הסקריפט ונשלחים יחד עם הפיקסל:

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

// עדכון ערך בודד
msq_params.param1 = 'new value';

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

ההגדרות קובעות את אופן ההתנהגות של ה‑SDK בכל עמוד:

• setting_api_key — חובה; זיהוי הלקוח מול analytics.maskyoo.net. מפתח לא תקין = פיקסל לא נרשם והחלפות לא יפעלו
• setting_default_maskyoo — מספרי ברירת‑מחדל שיישלחו בפיקסל גם ללא החלפה; חשוב בדוחות שיחות מהאתר
• GA4 / Facebook — setting_ga4_tid ו‑setting_ignore_cookies קובעים אילו מזהי מעקב מצורפים לפיקסל; משפיעים על שיוך מקורות בדוחות
• זמני טעינה — setting_retry_load_interval, setting_delay_load, setting_wait4async משפיעים על יציבות ההחלפה בדפים עם סקריפטים אסינכרוניים רבים
• setting_debug / setting_debug_ga4_tid — מצב debug רושם לקונסול ובאופציה שולח אירועי msq_pixel_debug ל‑GA4 לניתוח שגיאות
• פריסה מחדש — כל שינוי בערכים דורש פריסה מחדש של הדפים (קוד בצד לקוח); לא קיים מנגנון עדכון רטרואקטיבי

ראו גם

• התקנה
• פונקציות עזר
• פונקציות דינמיות
• פתרון בעיות