דלג לתוכן הראשי

כללי פיקסל ותנאים

conditions_filter — תנאי סינון​

לכל כלל החלפה (פונקציות referrer_* ו-dynamic_*) ניתן להגדיר פרמטר conditions_filter הקובע האם הכלל ירוץ עבור הביקור הנוכחי. הבדיקה פשוטה — חיפוש טקסט מילולי (substring), ללא שפת שאילתות וללא אופרטורים לוגיים:

  • אם הערך הוא * — הכלל תמיד מתקיים (ללא סינון).

  • אחרת — הערך מתפרש כמחרוזת טקסט אחת שחייבת להופיע ככתבה, תוך הבחנה בין אותיות גדולות לקטנות (case-sensitive), בתוך אחד משלושה מקורות. די בהתאמה באחד מהם כדי שהכלל יתקיים:

    מקור תיאור

    referrer ה-referrer של הביקור הראשון (נשמר ב-sessionStorage) page location ה-URL של הביקור הראשון (נשמר ב-sessionStorage) current URL ה-URL הנוכחי (window.location.href)

חשוב

conditions_filter אינו תומך ב-LIKE / NOT LIKE / IN / NOT IN / AND / OR / NOT, אינו תומך בתווי wildcard (%), ואינו מכיר משתנה device או זיהוי מכשיר לפי User-Agent. כל טקסט מהסוג הזה יטופל כמחרוזת מילולית אחת שתחופש כפי שהיא בתוך ה-URL / ה-referrer — ולכן כלל שנבנה כך כמעט לעולם לא יתאים לתעבורה אמיתית ולא יופעל.

דוגמאות​

// מתקיים רק כאשר ה-URL הנוכחי, ה-referrer או ה-URL של הביקור הראשון
// מכילים את הטקסט gclid
conditions_filter: 'gclid'

// מתקיים כאשר מופיע פרמטר המקור utm_source=google
conditions_filter: 'utm_source=google'

// מתקיים כאשר המבקר הגיע מ-facebook
conditions_filter: 'facebook.com'

// תמיד מתקיים (ללא סינון)
conditions_filter: '*'

הערה על rule_send_pixel​

בגרסאות קודמות של התיעוד תואר כלל בשם rule_send_pixel לשליחת פיקסל ללא שינוי DOM. כלל זה אינו ממומש בגרסת ה-SDK הפעילה — כלל שמוגדר עם פונקציה זו לא ישלח פיקסל ולא יבצע דבר, ותירשם שגיאה בקונסול. שליחת הפיקסל מתבצעת ממילא אוטומטית בסיום מוצלח של כללי ההחלפה (referrer_* / dynamic_*).

הערות ביצוע ואבחון​

מחזור חיים​

  1. בטעינת הדף, ה-SDK שומר מטא-נתונים (pushPageInfo, מזהי GA/FB, פרמטרי URL וכו')
  2. ביצוע כללים יכול לרוץ אוטומטית או במצב async בהתאם להגדרות
  3. כל כלל מקבל timeout של 5 שניות. ב-timeout, הכלל הבא ממשיך
  4. כאשר החלפה מצליחה, ה-SDK שולח את הפיקסל דרך process() או process_async()

לוגים ודיבוג​

  • השתמשו ב-debug_mode=true ו/או debug_ga4_tid כדי לשדר לוגים ל-console ואירועי debug ל-GA4
  • שגיאות, אזהרות והתאמות מודגשות בצבע בקונסול
  • פרמטרים חסרים נרשמים כשגיאות לפני הפעלת הפונקציה

דוגמה מלאה​

var msq_pixel_settings = {
  setting_api_key: 'YOUR_API_KEY',
  setting_debug: true,
  setting_debug_ga4_tid: 'G-XXXXXXXXXX'
};

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'
    }
  }
];

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

conditions_filter הוא מנוע ההחלטה שקובע אילו כללי החלפה ירוצו:

  • חיפוש טקסט פשוט — הכלל מתקיים כאשר ערך ה-conditions_filter מופיע ככתבו (case-sensitive) בתוך ה-referrer של הביקור הראשון, ה-URL של הביקור הראשון, או ה-URL הנוכחי; הערך * מבטל את הסינון והכלל תמיד ירוץ
  • ללא שפת שאילתות — אין תמיכה ב-LIKE / IN / AND / OR / NOT, ב-wildcards או בסינון לפי מכשיר; ערכים כאלה יטופלו כטקסט מילולי ולרוב לא יתאימו לאף URL
  • שליחת פיקסל אוטומטית — כאשר כלל החלפה מצליח, ה-SDK קורא אוטומטית ל-process()/process_async() כדי לשלוח למסקיו את המידע שנאסף (UTM, GA4, Facebook, מזהה שיחה)
  • לוגים ו-timeouts — כל כלל מוגבל ל-5 שניות; פרמטרים חסרים נרשמים כשגיאות בקונסול ונשלחים ל-GA4 דרך debug_ga4_tid

ראו גם​