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

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

rule_send_pixel​

מפעיל שליחת פיקסל ללא שינוי ה-DOM. בהצלחה, שומר אופציונלית את תגית ה-maskyoo ואז קורא ל-process() או process_async() בהתאם להגדרות.

פרמטרים​

פרמטר סוג חובה תיאור

conditions_filter string כן תנאי סינון maskyoo string לא תגית אופציונלית לשמירה לפני שליחת הפיקסל

החזרה​

true בהצלחה; אחרת false (לדוגמה, אם התנאי לא התקיים).

דוגמה​

{
  function: 'rule_send_pixel',
  params: {
    conditions_filter: '(url LIKE "%checkout%") OR (referrer LIKE "%landing%")',
    maskyoo: '055-5555555'
  }
}

Conditions Filter (תנאי סינון דמוי SQL)​

ה-conditions_filter משתמש בשפה מיני דמוית SQL שמנותחת על ידי where_url_sql() להערכת הקשר הדף. הוא תומך ב-referrer, pageLocation, currentUrl, device, ו-url וירטואלי משולב (שרשור כל המקורות).

אופרטורים נתמכים​

אופרטור תיאור

LIKE התאמה עם wildcards של % NOT LIKE אי-התאמה עם wildcards IN (...) התאמה לאחד מהערכים ברשימה NOT IN (...) אי-התאמה לכל הערכים ברשימה AND תנאי וגם OR תנאי או NOT שלילה * תנאי שתמיד מתקיים

משתנים זמינים​

משתנה תיאור

url משתנה וירטואלי משולב (referrer + pageLocation + currentUrl) referrer ה-referrer של הביקור הראשון (מ-sessionStorage) pageLocation ה-URL של הביקור הראשון (מ-sessionStorage) currentUrl ה-URL הנוכחי (window.location.href) device סוג המכשיר (mobile / tablet / desktop)

כל המשתנים מושווים ב-lowercase.

הרחבה: משתנה device​

ניתן להשתמש במשתנה device בתוך conditions_filter לצורך סינון לפי סוג המכשיר של המשתמש.

ערכים אפשריים​

ערך תיאור

mobile טלפון נייד tablet טאבלט desktop מחשב שולחני / לפטופ

הזיהוי מתבצע בצד לקוח על בסיס User-Agent ושדות מערכת נוספים. ההתאמה היא case-insensitive.

דוגמאות שימוש​

device LIKE "mobile"

device IN ("mobile","tablet")

device NOT LIKE "desk%"

device LIKE "mobile" AND url LIKE "%utm_source=google%"

(device IN ("mobile","tablet")) AND referrer LIKE "%facebook%"

device LIKE "desktop" AND pageLocation NOT LIKE "%/internal%"

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

מחזור חיים​

  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
  • שגיאות, אזהרות והתאמות מקודדות בצבעים על ידי colorLog()
  • פרמטרים חסרים נרשמים כשגיאות לפני הפעלת הפונקציה

דוגמה מלאה​

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: 'device LIKE "mobile" AND url LIKE "%gclid%"',
      search_for_number: '055-4300000',
      replace_number: '055-4311111',
      maskyoo: '055-4311111',
      stop_on_success: true
    }
  },
  {
    function: 'rule_send_pixel',
    params: {
      conditions_filter: '*',
      maskyoo: '055-4300000'
    }
  }
];

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

rule_send_pixel ו‑conditions_filter הם מנוע ההחלטה של ה‑SDK:

  • שליחת פיקסל ללא DOM — rule_send_pixel שולחת למסקיו את כל המידע שנאסף (UTM, GA4, Facebook, מזהה שיחה) בלי לשנות תוכן; שימושי כשמספר לא נשלף אך רוצים לרשום ביקור
  • conditions_filter דמוי SQL — תומך ב‑LIKE, IN, AND/OR/NOT, *; מאפשר סינון מדויק לפי url, referrer, pageLocation, currentUrl, device
  • case‑insensitive — כל המשתנים מושווים ב‑lowercase; חשוב בעת התאמת דומיינים ופרמטרים
  • device — סינון לפי mobile / tablet / desktop מאפשר שליחת קמפיינים שונים לפי מכשיר
  • מעגל חיים מלא — כשכלל מצליח, ה‑SDK קורא אוטומטית ל‑process()/process_async() כדי לשלוח את הפיקסל
  • לוגים ו‑timeouts — כל כלל מוגבל ל‑5 שניות; פרמטרים חסרים נרשמים כשגיאות בקונסול ונשלחים ל‑GA4 דרך debug_ga4_tid

ראו גם​