פונקציות Referrer

פונקציות אלה מחליפות מספרי טלפון על בסיס תנאי referrer ו-URL. הן פועלות באופן מיידי ללא הקצאה דינמית מהשרת.

referrer_search_and_replace

פונקציה משולבת שמפעילה גם referrer_search_and_replace_text וגם referrer_search_and_replace_link_tel. השתמשו בה כאשר אתם צריכים להחליף מספרים גם בטקסט גלוי וגם בקישורי tel:.

פרמטרים

פרמטר	סוג	חובה	תיאור
search_for_number	string	כן	הטקסט/מספר לחיפוש בטקסט ובקישורי tel:
replace_number	string	כן	הטקסט/מספר להחלפה
conditions_filter	string	כן	תנאי סינון (חיפוש תת-מחרוזת)
maskyoo	string	לא	תגית אופציונלית שנשמרת בהצלחה לצורך שליחת הפיקסל

החזרה

שתי הפעולות (החלפת טקסט והחלפת קישורי tel:) מבוצעות תמיד. עם זאת, ערך ההחזרה משקף רק את תוצאת החלפת קישורי ה-tel: (הפעולה האחרונה): true אם עודכן לפחות קישור tel: אחד, אחרת false. שימו לב שהחלפת הטקסט עשויה להתבצע בהצלחה גם כאשר הפונקציה מחזירה false, ולכן אין להסתמך על ערך ההחזרה כדי לדעת אם החלפת הטקסט בוצעה.

דוגמה

{
  function: 'referrer_search_and_replace',
  params: {
    conditions_filter: 'utm_medium=GMB',
    search_for_number: '055-4328300',
    replace_number: '055-4328296',
    maskyoo: '055-4328296'
  },
  callback: function(r) { console.log('referrer_search_and_replace done:', r); }
}

---

referrer_search_and_replace_text

עוברת על ה-DOM ומחליפה התאמות של search_for_number בתוך text nodes ב-replace_number. תגיות script מתעלמות.

פרמטרים

פרמטר	סוג	חובה	תיאור
search_for_number	string	כן	תבנית לחיפוש (regex literal)
replace_number	string	כן	מחרוזת להחלפה
conditions_filter	string	כן	תנאי סינון
maskyoo	string	לא	תגית אופציונלית; ברירת מחדל: replace_number

החזרה

true אם בוצעה לפחות החלפה אחת; אחרת false.

דוגמה

{
  function: 'referrer_search_and_replace_text',
  params: {
    conditions_filter: 'facebook',
    search_for_number: '03-1234567',
    replace_number: '03-7654321',
    maskyoo: '03-7654321'
  }
}

---

referrer_search_and_replace_link_tel

מעדכנת קישורי <a href="tel:..."> שהטלפון המנורמל שלהם (ספרות בלבד) שווה ל-search_for_number המנורמל.

פרמטרים

פרמטר	סוג	חובה	תיאור
search_for_number	string	כן	טלפון מקורי (כל פורמט; הספרות מושוות)
replace_number	string	כן	טלפון חדש להגדרה ב-href
conditions_filter	string	כן	תנאי סינון
maskyoo	string	לא	תגית אופציונלית; ברירת מחדל: replace_number

החזרה

true אם לפחות קישור אחד שונה; אחרת false.

דוגמה

{
  function: 'referrer_search_and_replace_link_tel',
  params: {
    conditions_filter: 'utm_source=google',
    search_for_number: '055 432 8300',
    replace_number: '055-4328296',
    maskyoo: '055-4328296'
  }
}

---

referrer_replace_selector

פונקציה משולבת שמפעילה referrer_replace_selector_text ו-referrer_replace_selector_link_tel עבור CSS selector נתון.

פרמטרים

פרמטר	סוג	חובה	תיאור
selector	string	כן	CSS selector לאלמנטים
replace_number	string	כן	מספר להחלפה בתוכן או בקישור tel:
conditions_filter	string	כן	תנאי סינון
maskyoo	string	לא	תגית אופציונלית

החזרה

שתי הפעולות (החלפת טקסט והחלפת קישורי tel: בתוך ה-selector) מבוצעות תמיד. עם זאת, ערך ההחזרה משקף רק את תוצאת החלפת קישורי ה-tel: (הפעולה האחרונה): true אם עודכן לפחות קישור tel: אחד, אחרת false. אין להסתמך על ערך ההחזרה כדי לדעת אם החלפת הטקסט בוצעה.

דוגמה

{
  function: 'referrer_replace_selector',
  params: {
    selector: '.contact .phone',
    replace_number: '+972-3-5551234',
    conditions_filter: '*',
    maskyoo: '+972-3-5551234'
  }
}

---

referrer_replace_selector_text

מגדירה את innerHTML של כל האלמנטים התואמים ל-selector לערך replace_number.

פרמטרים

פרמטר	סוג	חובה	תיאור
selector	string	כן	CSS selector (לדוגמה: .phone-number)
replace_number	string	כן	ערך טקסט/HTML חדש
conditions_filter	string	כן	תנאי סינון
maskyoo	string	לא	תגית אופציונלית שנשמרת בהצלחה

החזרה

true אם לפחות אלמנט אחד עודכן; אחרת false.

דוגמה

{
  function: 'referrer_replace_selector_text',
  params: {
    selector: '#primary-phone, .hero .cta-phone',
    replace_number: '03-777-2222',
    conditions_filter: 'utm_source=newsletter',
    maskyoo: '03-777-2222'
  }
}

---

referrer_replace_selector_link_tel

בתוך אלמנטים התואמים ל-CSS selector, מעדכנת כל href שמתחיל ב-tel: למספר החדש.

פרמטרים

פרמטר	סוג	חובה	תיאור
selector	string	כן	CSS selector שעוטף קישורי tel:
replace_number	string	כן	מספר טלפון להגדרה
conditions_filter	string	כן	תנאי סינון
maskyoo	string	לא	תגית אופציונלית; ברירת מחדל: replace_number

החזרה

true אם לפחות קישור אחד עודכן; אחרת false.

דוגמה

{
  function: 'referrer_replace_selector_link_tel',
  params: {
    selector: '.footer, .header-phones',
    replace_number: '+972545551234',
    conditions_filter: 'utm_source=google',
    maskyoo: '+972545551234'
  }
}

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

פונקציות Referrer משנות מיידית את מה שמבקר רואה בדף:

• זיהוי מקור תנועה — conditions_filter בוחן את ה-referrer ואת כתובת ה-url; כך Google Ads, Facebook ו‑Organic מקבלים כל אחד מספר שונה
• החלפה סטטית — בניגוד לפונקציות Dynamic, המספר קבוע מראש בקוד ולא נשאב מ‑pool; מתאים כשיש מספר יעודי לכל מקור
• ייחוס ב‑CDR — שדה maskyoo בכלל נשמר בפיקסל ומשויך ל‑CDR; שיחה שתגיע למספר הזה תקושר לאותו מקור
• selector vs חיפוש טקסט — selector בטוח יותר במבנים מורכבים; search_for_number קל יותר כשאותו מספר מופיע בכמה מקומות
• קישורי tel: — ההחלפה מנרמלת את ספרות הטלפון בלבד לצורך השוואה; פורמטים שונים של אותו מספר מתקבלים כשווים
• מהירות — פועל מיידית ללא תלות ברשת; במצב online/offline בדפדפן עדיין יפעל

ראו גם

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