החלפת מספרי טלפון

מנגנון msq_phone_replace_rules מספק דרך דקלרטיבית לביצוע החלפות טקסט/טלפון ושליחת פיקסלים בדפי אינטרנט באמצעות ה-MSQ Pixel SDK.

עקרון הפעולה

הכללים מוערכים מול תנאי conditions_filter (דמוי SQL) ולאחר מכן מפעילים פונקציות SDK ספציפיות. כללים מוגדרים במערך גלובלי בשם msq_phone_replace_rules.

מבנה אובייקט כלל

כל כלל מכיל את השדות הבאים:

שדה	סוג	חובה	תיאור
function	string	כן	שם הפונקציה ב-SDK להפעלה
params	object	כן	פרמטרים עבור הפונקציה
callback	function	לא	נקראת לאחר סיום הכלל עם תוצאה true/false

דוגמה מלאה

var msq_phone_replace_rules = [
  {
    function: 'referrer_search_and_replace',
    params: {
      conditions_filter: 'gclid',
      search_for_number: '055-4300000',
      replace_number: '055-4311111',
      maskyoo: '055-4311111'
    },
    callback: function(result) {
      console.log('[rule] referrer_search_and_replace =>', result);
    }
  },
  {
    function: 'dynamic_search_and_replace',
    params: {
      dynamic_url: 'https://example.dyn-msq.net/api/',
      dynamic_campaign_id: 'CMP-12345',
      dynamic_platform: 'google',
      search_for_number: '055-4311111',
      conditions_filter: 'utm_campaign=summer',
      dynamic_static: '055-4322222',
      dynamic_interval: 5,
      dynamic_ttl: 3600,
      dynamic_die_timeout: 1800
    }
  }
];

סוגי פונקציות

ה-SDK מספק 12 פונקציות להחלפת מספרים:

פונקציות Referrer

פונקציות אלה מחליפות מספרים על בסיס תנאי referrer/URL:

פונקציה	תיאור
referrer_search_and_replace	החלפה בטקסט ובקישורי tel:
referrer_search_and_replace_text	החלפה בטקסט בלבד
referrer_search_and_replace_link_tel	החלפה בקישורי tel: בלבד
referrer_replace_selector	החלפה לפי CSS selector
referrer_replace_selector_text	החלפת טקסט לפי selector
referrer_replace_selector_link_tel	החלפת קישורי tel: לפי selector

פונקציות דינמיות

פונקציות אלה מקצות מספר דינמי מהשרת ומחליפות:

פונקציה	תיאור
dynamic_search_and_replace	הקצאה דינמית + החלפה
dynamic_search_and_replace_text	הקצאה דינמית + החלפת טקסט
dynamic_search_and_replace_link_tel	הקצאה דינמית + החלפת קישורים
dynamic_replace_selector	הקצאה דינמית לפי selector
dynamic_replace_selector_text	הקצאה דינמית לטקסט לפי selector
dynamic_replace_selector_link_tel	הקצאה דינמית לקישורים לפי selector

זמנים ושגיאות

• הכללים במערך msq_phone_replace_rules מבוצעים ברצף, בזה אחר זה, ללא מגבלת זמן (timeout) לכל כלל
• אין בידוד שגיאות בין הכללים: שגיאה בכלל אחד עלולה לעצור את המשך הרצת הכללים שאחריו, לכן חשוב לוודא שכל כלל מוגדר כראוי
• שגיאות והודעות ניפוי נרשמות ב-console של הדפדפן בלבד

המשך קריאה

• פונקציות Referrer - פירוט מלא
• פונקציות דינמיות - פירוט מלא
• כללי פיקסל ותנאים - conditions_filter וכללי פיקסל

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

msq_phone_replace_rules מגדיר את הלוגיקה הויזואלית בצד הלקוח:

• החלפה בצד לקוח — הכללים מתבצעים ב‑DOM; הביקור עצמו רואה את המספר החדש אך נתוני ה‑HTML המקוריים (ב‑cache/snapshot) נשמרים
• Referrer לעומת Dynamic — פונקציות Referrer סטטיות ומיידיות; פונקציות Dynamic מושכות מספר מה‑pool של מסקיו עם keep‑alive וטעינה מהשרת
• זמינות ב‑CDR — תג maskyoo שנשמר בכלל מצורף לפיקסל ומאפשר ייחוס שיחות למספר שהוצג
• סדר הרצה — הכללים מבוצעים ברצף לפי סדר הופעתם במערך, ללא מגבלת זמן לכל כלל
• קמפיינים דינמיים — פונקציות Dynamic נשענות על תשתית Dynamic Campaigns של מסקיו; דורשות קמפיין מוגדר ומספר pool פעיל

ראו גם

• פונקציות Referrer
• פונקציות דינמיות
• כללי Pixel
• קמפיינים דינמיים
• הגדרות SDK