פונקציות 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	כן	תנאי SQL-like
maskyoo	string	לא	תגית אופציונלית שנשמרת בהצלחה לצורך שליחת הפיקסל

החזרה

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

דוגמה

{
  function: 'referrer_search_and_replace',
  params: {
    conditions_filter: 'url LIKE "%utm_medium=GMB%" OR url LIKE "%wbraid%"',
    search_for_number: '055-4328300',
    replace_number: '055-4328296',
    maskyoo: '055-4328296',
    stop_on_success: true
  },
  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: 'referrer LIKE "%facebook%" AND NOT url LIKE "%/internal%"',
    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: 'url IN ("%utm_source=google%","%utm_medium=GMB%")',
    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	לא	תגית אופציונלית

החזרה

true אם לפחות אחת מהפעולות הצליחה; אחרת 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: 'NOT url LIKE "%/admin%"',
    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: '(url LIKE "%utm_source=google%") AND NOT (referrer LIKE "%spam%")',
    maskyoo: '+972545551234'
  }
}

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

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

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

ראו גם

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