MSQ Pixel SDK

ברוכים הבאים למדריך ה-MSQ Pixel SDK של מסקיו. מסמך זה מספק מידע מקיף אודות ה-SDK, כולל התכונות שלו, אפשרויות התצורה והוראות השימוש. ה-SDK מיועד לסייע למפתחים לשלב מעקב פיקסל של מסקיו באפליקציות האינטרנט שלהם בצורה חלקה.

תכונות עיקריות

ה-MSQ Pixel SDK מציע מגוון פונקציונליות, כולל:

• ניהול מפתח API - גישה מאובטחת למערכת
• איסוף אוטומטי של פרמטרי מעקב - gclid, gclsrc, dclid, wbraid, gbraid, fbclid ו-UTM
• זיהוי אוטומטי של Google Analytics 4 - מזהי GA4 מ-cookies, מ-gtag או מההגדרות (כולל vid, sid, hid)
• זיהוי אוטומטי של Facebook Pixel - קריאת fbq account/client ID וה-_fbp cookie
• זיהוי סוג מכשיר - mobile / tablet / desktop (משתנה device זמין ב-conditions_filter)
• החלפת מספרי טלפון - החלפה סטטית מבוססת referrer או הקצאה דינמית מהשרת
• שליחת פיקסלים - מעקב אירועים ל-Google Analytics ול-analytics.maskyoo.net
• תמיכה ב-SPA - מתודת onDomUpdate() להרצת כללים מחדש בעקבות שינויי DOM (React/Vue וכד')
• שמירת מידע על ביקור ראשון - כותרת, כתובת ו-referrer של הדף הראשון בסשן

דרישות

דרישות האתר

כדי להשתמש ב-SDK בצורה יעילה, ודאו שהאתר שלכם עומד בדרישות הבאות:

• גישה לפאנל ניהול - האתר צריך לאפשר הוספת JavaScript לדף. לחלופין, ניתן להשתמש ב-Google Tag Manager, אם כי זה פחות מומלץ בגלל בעיות עיכוב פוטנציאליות.
• Google Analytics - האתר חייב להיות מותקן עם Google Analytics.

ניסיון מפתח

מומלץ שיהיה לכם ניסיון בנושאים הבאים:

• ניסיון בסיסי בפיתוח אתרים
• ידע בסיסי ב-JavaScript
• הבנה של CSS selectors
• ידע בסיסי ב-HTML

מבנה המדריך

קטע	תיאור
התקנה	הוראות התקנה והטמעה
הגדרות משתנים	כל המשתנים הזמינים להגדרה
החלפת מספרים	פונקציות להחלפת מספרי טלפון
פונקציות עזר	פונקציות שירות נוספות
פתרון בעיות	מדריך לאבחון בעיות

התחלה מהירה

// הוספת הסקריפט לדף
<script id="msq_pixel_id" async type="text/javascript"
  src="https://s3.eu-central-1.amazonaws.com/maskyoo-cdn/msq_pixel_2024.js?setting_disable_autorun=true">
</script>

// הגדרת הפיקסל (לפני טעינת הסקריפט)
var msq_pixel_settings = {
  setting_api_key: 'YOUR_API_KEY',
  setting_default_maskyoo: '0776670000'
};

שם המחלקה

המחלקה ב-SDK נקראת MSQ. עם טעינת הסקריפט, אובייקט מופע זמין גלובלית כ-window.msq_pixel. בדרך כלל אין צורך ליצור מופע ידנית — הסקריפט עושה זאת לבד מתוך msq_pixel_settings.

למידע מפורט יותר, המשיכו לקרוא את מדריך ההתקנה.

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

ה‑SDK משנה את האתר החי של הלקוח ומזין את המערכת במידע קמפיין:

• החלפת מספרים — משנה מספרי טלפון המוצגים בדף (טקסט, קישורי tel:, selectors) לפי תנאי referrer/UTM
• הקצאה דינמית — פונקציות Dynamic מושכות מספר חי משרת מסקיו לכל ביקור; מיועד לקמפיינים דינמיים עם pool מספרים
• שליחת פיקסל — שולח אירועים ל‑analytics.maskyoo.net; כל שיחה שתתקבל אחר כך תישא מידע ייחודי (gclid, UTM, GA4/FB IDs)
• CDR עשיר — השיחות מהאתר נרשמות ב‑CDR עם מטא‑דאטה מלאה של הקמפיין; זמינים בדוחות ובשאילתות cdr_query
• שילוב עם GA4/Facebook — זיהוי אוטומטי של _fbp, gtag, fbq; מידע מועשר בפיקסל ללא קוד נוסף
• תמיכה ב‑SPA — onDomUpdate() מריץ כללים מחדש לאחר שינויי DOM ב‑React/Vue/Angular

ראו גם

• התקנה
• הגדרות
• החלפת מספרים
• קמפיינים דינמיים
• הוספת טוקן API