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

פונקציות דינמיות מקצות מספר טלפון מהשרת באופן דינמי ומחליפות אותו בדף. אם ההקצאה נכשלת, הן חוזרות למספר סטטי (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	לא	זמן עד עצירת ה-keep-alive ושחרור ההקצאה בשרת (ברירת מחדל: 3600)

דוגמה

{
  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: 'utm_campaign=black_friday',
    dynamic_static: '055-4399999',
    dynamic_interval: 8,
    dynamic_ttl: 5400,
    dynamic_die_timeout: 1800
  }
}

---

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	לא	זמן עד עצירת ה-keep-alive ושחרור ההקצאה בשרת (ברירת מחדל: 3600)

דוגמה

{
  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: '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	לא	זמן עד עצירת ה-keep-alive ושחרור ההקצאה בשרת (ברירת מחדל: 3600)

דוגמה

{
  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: 'facebook.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	לא	זמן עד עצירת ה-keep-alive ושחרור ההקצאה בשרת (ברירת מחדל: 3600)

דוגמה

{
  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: '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	לא	זמן עד עצירת ה-keep-alive ושחרור ההקצאה בשרת (ברירת מחדל: 3600)

דוגמה

{
  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: '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	לא	זמן עד עצירת ה-keep-alive ושחרור ההקצאה בשרת (ברירת מחדל: 3600)

דוגמה

{
  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: '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, לולאת ה-keep-alive נעצרת וההקצאה בשרת פגה בהדרגה. המספר הדינמי שכבר הוצג בדף נשאר גלוי עד לטעינה מחדש של הדף (טעינה מחדש מתחילה תהליך חדש)

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

פונקציות דינמיות מחוברות לשרת מסקיו וצורכות משאבי 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