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

פונקציות דינמיות מקצות מספר טלפון מהשרת באופן דינמי ומחליפות אותו בדף. אם ההקצאה נכשלת, הן חוזרות למספר סטטי (dynamic_static).

dynamic_search_and_replace

מתזמרת הקצאת מספר דינמי באמצעות dynamic_get_number() ולאחר מכן מבצעת החלפות טקסט וקישורים.

פרמטרים

פרמטר	סוג	חובה	תיאור
dynamic_url	string	כן	נקודת קצה API בסיסית
dynamic_campaign_id	string	כן	טוקן שנשלח לנקודת ההקצאה
dynamic_platform	string	כן	תווית פלטפורמה (google, facebook)
search_for_number	string	כן	מספר מקורי להחלפה
conditions_filter	string	כן	תנאי סינון
dynamic_static	string	כן	מספר חלופי בכשלון
dynamic_interval	number	לא	מרווח keep-alive בשניות (ברירת מחדל: 5)
dynamic_ttl	number	לא	זמן חיים בשניות (ברירת מחדל: 3600)
dynamic_die_timeout	number	לא	זמן עד חזרה לסטטי

דוגמה

{
  function: 'dynamic_search_and_replace',
  params: {
    dynamic_url: 'https://analytics.maskyoo.net/dyn/',
    dynamic_campaign_id: 'TOKEN-ABC-789',
    dynamic_platform: 'google',
    search_for_number: '055-4300000',
    conditions_filter: 'url LIKE "%utm_campaign=black_friday%"',
    dynamic_static: '055-4399999',
    dynamic_interval: 8,
    dynamic_ttl: 5400,
    dynamic_die_timeout: 1800,
    stop_on_success: true
  }
}

---

dynamic_search_and_replace_text

מקצה מספר דינמי ומחליפה הופעות של search_for_number ב-text nodes.

פרמטרים

פרמטר	סוג	חובה	תיאור
dynamic_url	string	כן	נקודת קצה API
dynamic_campaign_id	string	כן	טוקן קמפיין
dynamic_platform	string	כן	תווית פלטפורמה
search_for_number	string	כן	מספר מקורי להחלפה ב-text nodes
conditions_filter	string	כן	תנאי סינון
dynamic_static	string	כן	מספר חלופי
dynamic_interval	number	לא	מרווח keep-alive (ברירת מחדל: 5)
dynamic_ttl	number	לא	TTL בשניות (ברירת מחדל: 3600)
dynamic_die_timeout	number	לא	זמן עד חזרה לסטטי

דוגמה

{
  function: 'dynamic_search_and_replace_text',
  params: {
    dynamic_url: 'https://dyn.maskyoo.example/num/',
    dynamic_campaign_id: 'CAMP-5566',
    dynamic_platform: 'facebook',
    search_for_number: '03-9998888',
    conditions_filter: 'url LIKE "%utm_medium=cpc%"',
    dynamic_static: '03-1112222',
    dynamic_interval: 10,
    dynamic_ttl: 7200,
    dynamic_die_timeout: 2400
  }
}

---

dynamic_search_and_replace_link_tel

מקצה מספר דינמי ומעדכנת קישורי tel: תואמים.

פרמטרים

פרמטר	סוג	חובה	תיאור
dynamic_url	string	כן	נקודת קצה API
dynamic_campaign_id	string	כן	טוקן קמפיין
dynamic_platform	string	כן	תווית פלטפורמה
search_for_number	string	כן	מספר מקורי להתאמה בקישורי tel:
conditions_filter	string	כן	תנאי סינון
dynamic_static	string	כן	מספר חלופי
dynamic_interval	number	לא	מרווח keep-alive
dynamic_ttl	number	לא	TTL בשניות
dynamic_die_timeout	number	לא	זמן עד חזרה לסטטי

דוגמה

{
  function: 'dynamic_search_and_replace_link_tel',
  params: {
    dynamic_url: 'https://dyn.maskyoo.example/num/',
    dynamic_campaign_id: 'CAMP-5566',
    dynamic_platform: 'facebook',
    search_for_number: '039998888',
    conditions_filter: 'referrer IN ("%facebook.com%","%instagram.com%")',
    dynamic_static: '039991111',
    dynamic_interval: 10,
    dynamic_ttl: 7200,
    dynamic_die_timeout: 2400
  }
}

---

dynamic_replace_selector

פונקציה משולבת: מקצה מספר דינמי ומפעילה גם dynamic_replace_selector_text וגם dynamic_replace_selector_link_tel לעדכון אלמנטים לפי dynamic_selector.

פרמטרים

פרמטר	סוג	חובה	תיאור
dynamic_url	string	כן	נקודת קצה API
dynamic_campaign_id	string	כן	טוקן קמפיין
dynamic_platform	string	כן	תווית פלטפורמה
dynamic_selector	string	כן	CSS selector לאלמנטים לעדכון
conditions_filter	string	כן	תנאי סינון
dynamic_static	string	כן	מספר חלופי
dynamic_interval	number	לא	מרווח keep-alive (ברירת מחדל: 5)
dynamic_ttl	number	לא	TTL (ברירת מחדל: 3600)
dynamic_die_timeout	number	לא	זמן עד חזרה לסטטי

דוגמה

{
  function: 'dynamic_replace_selector',
  params: {
    dynamic_url: 'https://dyn-api.msqtel.net/',
    dynamic_campaign_id: 'DYN-XYZ',
    dynamic_platform: 'tiktok',
    dynamic_selector: '.cta .phone, .sticky-call a',
    conditions_filter: 'url LIKE "%utm_source=tiktok%"',
    dynamic_static: '+972-54-700-1234',
    dynamic_interval: 6,
    dynamic_ttl: 3600,
    dynamic_die_timeout: 1200
  }
}

---

dynamic_replace_selector_text

מקצה מספר דינמי ומגדירה את innerHTML של אלמנטים תואמים ל-dynamic_selector.

פרמטרים

פרמטר	סוג	חובה	תיאור
dynamic_url	string	כן	נקודת קצה API
dynamic_campaign_id	string	כן	טוקן קמפיין
dynamic_platform	string	כן	תווית פלטפורמה
dynamic_selector	string	כן	CSS selector לאלמנטים
conditions_filter	string	כן	תנאי סינון
dynamic_static	string	כן	מספר חלופי
dynamic_interval	number	לא	מרווח keep-alive
dynamic_ttl	number	לא	TTL בשניות
dynamic_die_timeout	number	לא	זמן עד חזרה לסטטי

דוגמה

{
  function: 'dynamic_replace_selector_text',
  params: {
    dynamic_url: 'https://dyn.msqtel.example/api/',
    dynamic_campaign_id: 'LIVE-001',
    dynamic_platform: 'google',
    dynamic_selector: '.hero-call .number',
    conditions_filter: 'url LIKE "%utm_campaign=winter%"',
    dynamic_static: '03-700-2000',
    dynamic_interval: 5,
    dynamic_ttl: 3600,
    dynamic_die_timeout: 900
  }
}

---

dynamic_replace_selector_link_tel

מקצה מספר דינמי ומעדכנת href="tel:" לקישורים בתוך אלמנטים תואמים ל-dynamic_selector.

פרמטרים

פרמטר	סוג	חובה	תיאור
dynamic_url	string	כן	נקודת קצה API
dynamic_campaign_id	string	כן	טוקן קמפיין
dynamic_platform	string	כן	תווית פלטפורמה
dynamic_selector	string	כן	CSS selector שעוטף קישורי tel:
conditions_filter	string	כן	תנאי סינון
dynamic_static	string	כן	מספר חלופי
dynamic_interval	number	לא	מרווח keep-alive
dynamic_ttl	number	לא	TTL בשניות
dynamic_die_timeout	number	לא	זמן עד חזרה לסטטי

דוגמה

{
  function: 'dynamic_replace_selector_link_tel',
  params: {
    dynamic_url: 'https://dyn.msqtel.example/api/',
    dynamic_campaign_id: 'LIVE-001',
    dynamic_platform: 'google',
    dynamic_selector: '.phones, .cta-block',
    conditions_filter: 'url LIKE "%utm_source=google%"',
    dynamic_static: '03-700-2000',
    dynamic_interval: 5,
    dynamic_ttl: 3600,
    dynamic_die_timeout: 900
  }
}

הקצאת מספרים דינמית - איך זה עובד

1. dynamic_get_number() קורא ל-{dynamic_url}allocate_number/ עם payload של פלטפורמה
2. בהצלחה, נשמרים הטלפון המוקצה ומזהה ה-view, ומתחיל dynamic_keep_alive()
3. dynamic_keep_alive() שולח ping ל-{dynamic_url}keep_phone_alive/ כל dynamic_interval שניות עם TTL
4. לאחר dynamic_die_timeout, ה-DOM חוזר למספר הסטטי וה-timer מתנקה

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

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

• ניצול pool — כל ביקור שמקבל הקצאה "נועל" מספר מה‑pool עד שתוקפו פג; pool קטן יכול להיגמר בשעת עומס ולחייב נפילה לסטטי
• keep‑alive — בקשות רקע ל‑keep_phone_alive/ כל dynamic_interval שניות; דפדפן פתוח לאורך זמן שומר על ההקצאה
• dynamic_static — מספר חלופי כשההקצאה נכשלת או פג תוקף; חשוב שיהיה תמיד מוגדר כדי לא להציג ריק
• קישור לקמפיין דינמי — dynamic_campaign_id ו‑dynamic_platform מקשרים בין הביקור לקמפיין במסקיו; השיחה הנכנסת תסומן במזהי אותו ביקור
• TTL — dynamic_ttl קובע כמה זמן המספר נשאר תפוס; ערך נמוך מדי מוביל להחלפה מוקדמת של המספר, ערך גבוה מדי מבזבז pool
• מדידה — משמש בקמפיינים עם תקציב גבוה שבהם חשוב לייחס כל שיחה למקור הספציפי שלה

ראו גם

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