המדריך הזה מסביר איך להטמיע באתר את הפיקסל החכם של אקטיב טרייל (Track3). הפיקסל עוקב אחרי כל מסע הלקוח: צפייה במוצרים ובקטגוריות, ניהול עגלת הקניות וביצוע ההזמנה הסופית. הוא עוקב גם אחרי הרשמות והתחברויות, לידים והזדמנויות ב-B2B, וכל אירוע מותאם שתגדירו.
הנתונים שהוא אוסף מזינים אוטומציות שיווקיות, פילוחים וניתוח של ביצועי המכירות בזמן אמת.
לכל אירוע למטה יש טבלת פרטים, דוגמת קוד למפתחים (אותו קוד עובד גם בתג Custom HTML ב-Google Tag Manager) והערות למנהל השיווק.
יצירת הפיקסל
- היכנסו לאינטגרציות ← פיקסל חכם.
- הוסיפו אתר חדש.
- הזינו את שם האתר (למשל MYSTORE) ואת כתובת האתר (הכנס את ה-URL של האתר, למשל https://www.mystore.com), ולחצו על הוספה.
- תקבלו את קוד הפיקסל. הוסיפו אותו לכל עמוד באתר שרוצים לעקוב אחריו, ממש לפני התגית הסוגרת
</head>.
למידע נוסף על יצירת פיקסל, ראו יצירת פיקסל חכם.
קוד הבסיס (אתחול)
לפני שאפשר לשלוח אירוע מעקב כלשהו, קוד הבסיס צריך להיטען פעם אחת בעמוד. הוא מגדיר את מזהה האתר שלכם ואת הכתובת שאליה נשלחים הנתונים, וטוען את הספרייה שמאזינה לאירועים. קוד הפיקסל שלכם נראה כך, עם מזהה האתר שלכם במקום YOUR-SITE-ID:
<script type='text/javascript'>var _atsc_paq = _atsc_paq || [];
(function () {_atsc_paq.push(['setCookieDomain', 'atsc.activetrail.com']);
_atsc_paq.push(['setSiteId', 'YOUR-SITE-ID']); // your site ID
_atsc_paq.push(['setUserId', '_atscid']); // always exactly this
_atsc_paq.push(['setTrackerUrl', '//atsc.activetrail.com/api/Track3']);
_atsc_paq.push(['trackPageView']);
var atsc_d = document, atsc_g = atsc_d.createElement('script'), atsc_s = atsc_d.getElementsByTagName('script')[0]; atsc_g.type = 'text/javascript'; atsc_g.async = true; atsc_g.defer = true; atsc_g.src = '//atsc.activetrail.com/Scripts/atsc3.min.js'; atsc_s.parentNode.insertBefore(atsc_g, atsc_s);})();</script>
זה השלב הראשון: אם קוד הבסיס לא נטען, שום אירוע אחר לא נשלח. הוא נטען באופן אסינכרוני, ולכן לא מאט את האתר.
כלל קבוע: השאירו תמיד את setUserId('_atscid') בדיוק כמו שהוא, בכל מקום שהוא מופיע. לעולם אל תשנו אותו למזהה משתמש, בין שהמבקר מחובר ובין שלא.
האירועים במבט אחד
| אירוע | TypeId | מה הוא מודד | פקודה |
|---|---|---|---|
| PageView | 4 | צפייה בעמוד (נשלח מקוד הבסיס) | trackPageView
|
| ViewTime | 7 | זמן בעמוד (כבוי עד שמפעילים אותו) | setViewTimeListener
|
| Register | 8 | הרשמה או התחברות: מזהה את המבקר כנמען | logRegisterUser
|
| Logout | 9 | התנתקות | logOut
|
| Click | 12 | הקלקה על קישור חיצוני או הורדת קובץ | addListener, trackLink
|
| ProductPageView | 10 | צפייה בעמוד מוצר | setEcommerceView
|
| CategoryPageView | 11 | צפייה בעמוד קטגוריה | setEcommerceView
|
| Cart | 6 | עדכון עגלת הקניות | trackEcommerceCartUpdate
|
| Order | 5 | הזמנה שהושלמה | trackEcommerceOrder
|
| Lead | 13 | ליד בתהליך מכירה (מבקרים מזוהים בלבד) | trackLead
|
| Opportunity | 14 | הזדמנות מכירה (מבקרים מזוהים בלבד) | trackOpportunity
|
| Action | 3 | כל אירוע מותאם | trackEvent
|
PageView: צפייה בעמוד (TypeId 4)
האירוע הבסיסי ביותר. קוד הבסיס שולח אותו אוטומטית בכל טעינת עמוד, עם כתובת העמוד והעמוד המפנה. לא צריך להוסיף אותו בעצמכם, חוץ מבאתרי עמוד יחיד (ראו אתרי עמוד יחיד).
| מתי הוא נשלח | אוטומטית, בכל טעינת עמוד (כש-trackPageView רץ). |
|---|---|
| פרמטרי חובה | אין. הכתובת והעמוד המפנה נאספים אוטומטית. |
| פרמטרים אופציונליים | כותרת עמוד מותאמת, פרמטרי UTM (utm_source, utm_medium וכו') ואובייקט נתונים (למשל pageType, category). |
| טריגר ב-Google Tag Manager | לא צריך: הוא חלק מקוד הבסיס שרץ בכל עמוד. באתר עמוד יחיד, הריצו אותו שוב בכל מעבר מסלול (route). |
למנהל השיווק: האירוע הזה מזין את כל נתוני הביקורים בעמודים ואת מקורות התנועה (UTM). בדקו עם המפתחים שהוא נשלח בכל עמוד.
_atsc_paq.push(['trackPageView']);
// With a custom title
_atsc_paq.push(['trackPageView', 'Custom title']);
// With additional information
_atsc_paq.push(['trackPageView', 'Custom title', {
pageType: 'article',
category: 'Technology'
}]);
ViewTime: זמן בעמוד (TypeId 7)
מודד כמה זמן מבקר שהה בעמוד. הוא נשלח אוטומטית כשהמבקר עוזב את העמוד (סוגר את הלשונית, עובר ללשונית אחרת או עוזב את האתר), אבל רק אם הפעלתם קודם את התכונה.
| מתי הוא נשלח | אוטומטית כשהמבקר עוזב את העמוד או את הלשונית, רק אם קודם הופעל setViewTimeListener(true). התכונה כבויה כברירת מחדל. |
|---|---|
| פרמטרי חובה | אין. הזמן מחושב מהטעינה הראשונה של העמוד ועד שהמבקר עוזב. |
| פרמטרים אופציונליים | אין. |
| טריגר ב-Google Tag Manager | אין טריגר ידני: זה מאזין שמפעילים פעם אחת. |
כבוי כברירת מחדל: אם לא קוראים ל-setViewTimeListener(true), לא נשלחים בכלל נתונים על זמן בעמוד.
למנהל השיווק: באתרי עמוד יחיד (אפליקציות ווב בלי רענון עמודים), הזמן שנמדד הוא הזמן הכולל באתר, ולא הזמן בכל עמוד. אם צריך את הזמן בכל מסך, בקשו מהמפתחים הטמעה מתאימה (ראו אתרי עמוד יחיד).
_atsc_paq.push(['setViewTimeListener', true]); // turn it on once
_atsc_paq.push(['trackPageView']); // ViewTime is sent automatically when the visitor leaves
Register: הרשמה והתחברות (TypeId 8)
מסמן שמבקר נרשם לאתר או התחבר, ומקשר את המבקר האנונימי לנמען חדש או קיים באקטיב טרייל. בלי האירוע הזה, אי אפשר לקשר פעולות מאוחרות יותר (עגלה, ליד, הזדמנות) לנמען מזוהה.
| מתי הוא נשלח | כשמושלמת הרשמה חדשה באתר, ובכל התחברות מוצלחת, כדי שאקטיב טרייל תזהה את המבקר. |
|---|---|
| פרמטרי חובה | externalId (מזהה חיצוני) ו-externalName (שם חיצוני), אם החשבון שלכם משתמש ב-External ID; ולפחות אחד מ-email או mobile. |
| פרמטרים אופציונליים | שם פרטי, שם משפחה, כתובת, טלפון, תאריך לידה, subscriptionStatus (אם האדם הסכים לקבל דיוור: true כברירת מחדל, false אם הוא לא רוצה דיוור) ושדות מותאמים. |
| טריגר ב-Google Tag Manager | "הטופס נשלח בהצלחה" (הרשמה) ו"התחברות מוצלחת", בדרך כלל אחרי שהשרת מחזיר תגובת הצלחה. |
שלחו את Register גם בהרשמה וגם בכל התחברות. לא מספיק לשלוח אותו פעם אחת בהרשמה.
למנהל השיווק: זה אירוע קריטי לשיווק. הוא זה שמזהה אנשים לאורך זמן, בונה את היסטוריית הרכישות שלהם ומאפשר לשלוח להם את הדיוור הנכון. שימו לב במיוחד ל-subscriptionStatus, שמתעד אם האדם הסכים לקבל הודעות שיווקיות.
// logRegisterUser(externalId, externalName, email, mobile, customData)
_atsc_paq.push(['logRegisterUser',
'12345678-1234-1234-1234-123456789012', // externalId
'987654321', // externalName
'user@example.com', // email
'+972500000000', // mobile
{
firstName: 'Israel',
lastName: 'Israeli',
subscriptionStatus: true // false = doesn't agree to receive mailings
}
]);
Logout: התנתקות (TypeId 9)
מוחק את זיהוי המבקר מעוגיית הדפדפן, כך שהפעולות הבאות שלו שוב אנונימיות עד שהוא מתחבר או נרשם.
| מתי הוא נשלח | בכל פעם שהמבקר מתנתק מהחשבון שלו. |
|---|---|
| פרמטרי חובה | אין. |
| פרמטרים אופציונליים | אין. |
| טריגר ב-Google Tag Manager | הקלקה על הכפתור Logout / Sign out (התנתקות). |
למנהל השיווק: ודאו שהאירוע נשלח לפני שהאתר מנתק בפועל את המבקר (למשל לפני הפניה לדף הבית). אחרת ייתכן שלא יספיק להישלח.
_atsc_paq.push(['logOut']);
Click: קישור חיצוני או הורדת קובץ (TypeId 12)
מודד הקלקות על קישורים שמובילים לאתר אחר, והורדות של קבצים (PDF, מסמכים וכו'). אפשר לעקוב אוטומטית אחרי כל האתר, או רק אחרי אזור מסוים בעמוד.
| מתי הוא נשלח | בהקלקה על קישור חיצוני או על קישור להורדה. |
|---|---|
| פרמטרי חובה | אחד משניים: download (כתובת הקובץ) או link (כתובת הקישור החיצוני). |
| פרמטרים אופציונליים | אובייקט נתונים עם מידע נוסף על הקישור. |
| טריגר ב-Google Tag Manager | מומלץ: מעקב אוטומטי (addListener) על כל העמוד, כך שלא צריך לתייג כל קישור. כדי לעקוב רק אחרי אזור אחד (למשל התפריט העליון), חברו את המעקב לאלמנט הזה. |
למנהל השיווק: שימושי למדידת יציאות לרשתות חברתיות ולשותפים (affiliates), ולהורדות של קטלוגים ומפרטים: סימנים טובים למה שמעניין את המבקרים.
// Automatic tracking of all links on the page (recommended, one-time code)
_atsc_paq.push(['addListener', document]);
// Or: manual tracking of a specific link
document.getElementById('externalLink').addEventListener('click', function () {
_atsc_paq.push(['trackLink', this.href, 'link']);
});
ProductPageView: צפייה בעמוד מוצר (TypeId 10)
מזהה את העמוד הנוכחי כעמוד מוצר בחנות שלכם. הוא מזוהה אוטומטית כשקטגוריה ומזהה מוצר נשלחים יחד עם הצפייה בעמוד.
| מתי הוא נשלח | בכל טעינה של עמוד מוצר. צריך לקרוא ל-setEcommerceView לפני trackPageView, אף פעם לא אחרי. |
|---|---|
| פרמטרי חובה | מזהה מוצר וקטגוריה. |
| פרמטרים אופציונליים | מק"ט (SKU), מחיר, מטבע ומידע נוסף כמו מותג, צבע או מידה. |
| טריגר ב-Google Tag Manager | בכל עמוד מוצר, שלחו קודם את נתוני המוצר ורק אחר כך את הצפייה בעמוד. רצוי שהמפתחים ייקחו את הנתונים (מזהה, קטגוריה, מחיר) משכבת הנתונים (data layer) של העמוד. |
הטעות הנפוצה ביותר: קריאה ל-trackPageView לפני setEcommerceView. הסדר הנכון הוא תמיד setEcommerceView קודם, ואז trackPageView.
למנהל השיווק: האירוע הזה מאפשר לנתח באילו מוצרים צופים, להפעיל רימרקטינג דינמי ולראות אילו מוצרים מעניינים את המבקרים. הוא גם הבסיס לאוטומציות של נטישת גלישה.
// setEcommerceView(sku, productId, category, price)
// Step 1: set the product data, before trackPageView
_atsc_paq.push(['setEcommerceView',
'SKU-001', // SKU (optional)
'PROD-001', // product ID (required): the ID, not the product name
'Electronics', // category (required)
99.99 // price (optional, a number)
]);
_atsc_paq.push(['setCustomData', { currency: 'USD' }]);
// Step 2: only now send the page view
_atsc_paq.push(['trackPageView']);
CategoryPageView: צפייה בעמוד קטגוריה (TypeId 11)
מזהה את העמוד הנוכחי כעמוד קטגוריה או קטלוג מוצרים, ולא כמוצר בודד. הוא מזוהה אוטומטית כששולחים רק קטגוריה, בלי מזהה מוצר.
| מתי הוא נשלח | בכל טעינה של עמוד קטגוריה. צריך לקרוא ל-setEcommerceView לפני trackPageView, עם שדות המוצר (SKU, מזהה, מחיר) ריקים. |
|---|---|
| פרמטרי חובה | שם הקטגוריה. |
| פרמטרים אופציונליים | אובייקט נתונים עם מידע נוסף על הקטגוריה. |
| טריגר ב-Google Tag Manager | כמו בעמוד מוצר, עם שדות מוצר ריקים. |
למנהל השיווק: מראה באילו קטגוריות או מחלקות צופים הכי הרבה, וזה עוזר לתכנן קמפיינים לפי תחומי העניין של המבקרים.
_atsc_paq.push(['setEcommerceView',
null, // SKU: empty
null, // product ID: empty
'Electronics', // category (required)
null // price: empty
]);
_atsc_paq.push(['trackPageView']);
גם מחרוזות ריקות ('') עובדות, אבל לפרמטרים אופציונליים ריקים מומלץ להשתמש ב-null או ב-undefined.
Cart: עדכון עגלת הקניות (TypeId 6)
נשלח כשעגלת הקניות משתנה: מוצר נוסף או הוסר, או שכמות השתנתה. הוא מדווח על המצב הנוכחי של העגלה, ולא על רכישה שהושלמה.
| מתי הוא נשלח | בכל שינוי בעגלת הקניות. |
|---|---|
| פרמטרי חובה | הסכום הכולל של העגלה (revenue), ולכל מוצר: מזהה המוצר ושם המוצר. |
| פרמטרים אופציונליים | מטבע, פרטי הלקוח (שם, מייל, טלפון), פרטי העגלה (קופון, כתובת משלוח, מספר פריטים) ושדות מותאמים. |
| טריגר ב-Google Tag Manager | אירוע מותאם "העגלה עודכנה" שהאתר שולח בכל שינוי בעגלה. |
המבקר חייב להיות כבר מזוהה (למשל בעזרת Register). אם המבקר עדיין אנונימי, אירוע העגלה לא נשמר.
למנהל השיווק: מראה עגלות נטושות ומתי אנשים מוסיפים או מסירים פריטים: הבסיס לקמפיינים של תזכורת לעגלה נטושה.
// Clear the cart saved in tracking, then add the current items again
_atsc_paq.push(['clearEcommerceCart']);
// addEcommerceItem(productId, name, category, price, quantity)
_atsc_paq.push(['addEcommerceItem', 'PROD-001', 'Product 1', 'Electronics', 99.99, 1]);
_atsc_paq.push(['addEcommerceItem', 'PROD-003', 'Product 3', 'Electronics', 29.99, 1]);
_atsc_paq.push(['setCustomData', { currency: 'USD' }]);
_atsc_paq.push(['trackEcommerceCartUpdate', 129.98]); // cart total
Order: הזמנה שהושלמה (TypeId 5)
האירוע החשוב ביותר למדידת המרות: הוא מסמן שרכישה הושלמה, למשל בעמוד "תודה על ההזמנה".
| מתי הוא נשלח | כשההזמנה מאושרת או מושלמת, בדרך כלל בעמוד אישור ההזמנה. |
|---|---|
| פרמטרי חובה | מספר הזמנה ייחודי, הסכום הכולל של ההזמנה (revenue), ולכל מוצר: מזהה המוצר ושם המוצר. |
| פרמטרים אופציונליים | מטבע, פרטי הלקוח, שם ההזמנה, קופון, כתובת משלוח, סטטוס ההזמנה, והדגלים createContact ו-subscriptionStatus (אם ליצור נמען חדש, ואם האדם הסכים לקבל דיוור). |
| טריגר ב-Google Tag Manager | טעינת עמוד "תודה" / "אישור הזמנה", פעם אחת לכל הזמנה (לא בכל רענון של העמוד). |
- אחרי שההזמנה נשלחת, פריטי העגלה שנשמרו במעקב נמחקים אוטומטית, כדי למנוע ספירה כפולה. להזמנה נוספת, הוסיפו שוב את המוצרים.
- ודאו שהאירוע לא נשלח שוב כשמרעננים את עמוד האישור: כך אותה הזמנה נספרת פעמיים.
למנהל השיווק: זה אירוע ה-ROI המרכזי של כל קמפיין. הוא מזין את דו"חות ההכנסות וההמרות, ומקושר אוטומטית לפרמטרי ה-UTM של הקמפיין שהביא את המבקר.
// Add the purchased products
_atsc_paq.push(['addEcommerceItem', 'PROD-001', 'Product 1', 'Electronics', 99.99, 2]);
_atsc_paq.push(['addEcommerceItem', 'PROD-002', 'Product 2', 'Accessories', 29.99, 1]);
_atsc_paq.push(['setCustomData', {
currency: 'USD',
createContact: true, // create a contact if it doesn't exist
subscriptionStatus: true // whether the person agreed to receive mailings
}]);
// trackEcommerceOrder(orderId, total, subtotal, tax, shipping, discount)
_atsc_paq.push(['trackEcommerceOrder', 'ORDER-12345', 102.99, 99.99, 8.00, 5.00, 10.00]);
Lead: ליד בתהליך מכירה (TypeId 13)
לתהליכי מכירה שהם לא מסחר מקוון קלאסי, כמו B2B: מסמן שנוצר ליד, עם תאריך רכישה צפוי וסכום פוטנציאלי. שימוש טיפוסי: טופס "השאירו פרטים" או "בקשת הצעת מחיר".
| מתי הוא נשלח | כשמבקר מזוהה (למשל אחרי Register) משאיר ליד, למשל בטופס יצירת קשר לרכישה עתידית. |
|---|---|
| פרמטרי חובה | מזהה ליד ייחודי (leadId), תאריך הרכישה הצפוי, סוג המיקום (Online, Offline או Unknown), והמזהה החיצוני של האדם (externalId) בתוך אובייקט הנתונים המותאמים. |
| פרמטרים אופציונליים | שם הליד, סכום כולל, פרטי הלקוח, קופון, כתובת, סטטוס הליד, והדגלים createContact ו-subscriptionStatus. אפשר גם לצרף מוצרים. |
| טריגר ב-Google Tag Manager | שליחה מוצלחת של טופס ליד או בקשת הצעת מחיר. |
- המבקר חייב להיות כבר מזוהה (למשל בעזרת Register). אחרת האירוע לא נשמר. ככה המערכת בנויה, וזו לא תקלה.
- בניגוד להזמנה, ליד לא מרוקן את העגלה שנשמרה במעקב.
למנהל השיווק: שימושי לעסקים עם מחזור מכירה ארוך (B2B, סטיילינג אישי, ייעוץ): אפשר לעקוב אחרי לידים כחלק ממשפך המכירות, ולא רק אחרי רכישות מיידיות.
// trackLead(leadId, expectedPurchaseDate, locationType, customData)
_atsc_paq.push(['trackLead',
'LEAD-1001', // lead ID (required)
'2026-09-15', // expected purchase date (required)
1, // locationType: 0 = Unknown, 1 = Online, 2 = Offline
{
externalId: 'CUST-42', // the person's external ID (required)
leadname: 'Inquiry from the website',
revenue: 1500.00,
email: 'jane@example.com',
createContact: true,
subscriptionStatus: true
}
]);
Opportunity: הזדמנות מכירה (TypeId 14)
שלב מתקדם יותר מליד: מסמן הזדמנות עסקית ממשית בתהליך הסגירה, למשל עסקה גדולה במשא ומתן. המבנה כמעט זהה ל-Lead.
| מתי הוא נשלח | כשמבקר מזוהה מגיע לשלב מכירה מתקדם (למשל אחרי שיחת מכירה או הצעת מחיר). |
|---|---|
| פרמטרי חובה | מזהה הזדמנות ייחודי (opportunityId), תאריך הרכישה הצפוי, סוג המיקום (Online, Offline או Unknown), והמזהה החיצוני של האדם (externalId). |
| פרמטרים אופציונליים | שם ההזדמנות, סכום כולל, פרטי הלקוח, קופון, כתובת, סטטוס, והדגלים createContact ו-subscriptionStatus. אפשר גם לצרף מוצרים. |
| טריגר ב-Google Tag Manager | בדרך כלל לא מהאתר עצמו, אלא ממערכת ה-CRM או המכירות שלכם (או מטופס פנימי) כשהעסקה מגיעה לשלב הזה. |
- כמו ב-Lead, המבקר חייב להיות כבר מזוהה. אחרת האירוע נדחה.
- האירוע הזה מגיע בדרך כלל ממערכת פנימית או ממערכת CRM, ולא מהמבקר באתר. בדקו עם צוותי הפיתוח והמכירות מי אחראי לשלוח אותו.
למנהל השיווק: שימושי בעיקר לצוותי מכירות ב-B2B שרוצים לחבר את שלבי המשפך (ליד ← הזדמנות ← עסקה שנסגרה) לאותם נתוני שיווק ומקורות תנועה (UTM).
// trackOpportunity(opportunityId, expectedPurchaseDate, locationType, customData)
_atsc_paq.push(['trackOpportunity',
'OPP-2001', // opportunity ID (required)
'2026-11-01', // expected purchase date (required)
2, // locationType: 0 = Unknown, 1 = Online, 2 = Offline
{
externalId: 'CUST-42', // external ID (required)
opportunityname: 'Organizational deal',
revenue: 25000.00,
createContact: true,
subscriptionStatus: true
}
]);
Action: אירוע מותאם (TypeId 3)
אירוע גמיש לכל אינטראקציה שרוצים למדוד ושהאירועים האחרים לא מכסים: הקלקה על כפתור, צפייה בסרטון, פתיחת פופ-אפ, מילוי טופס יצירת קשר.
| מתי הוא נשלח | בכל פעולה שהגדרתם כאירוע עסקי חשוב, למשל הקלקה על צרו קשר או סיום צפייה בסרטון. |
|---|---|
| פרמטרי חובה | קטגוריה (למשל "Button" או "Video"), הפעולה, שהיא תמיד הטקסט הקבוע Action, ושם האירוע (למשל "Form submission"). |
| פרמטרים אופציונליים | אין. |
| טריגר ב-Google Tag Manager | הנפוץ ביותר להטמעה ב-GTM: טריגר הקלקה על אלמנט, או אירוע מותאם שהאתר שולח לשכבת הנתונים. |
למנהל השיווק: הדרך הגמישה ביותר למדוד יעדים מסוימים (מיקרו-המרות) שאין להם אירוע משלהם. סכמו מראש עם הצוות הטכני על שמות ברורים לקטגוריות ולאירועים, כדי שכולם ישתמשו באותם שמות.
// trackEvent(category, 'Action', name): 'Action' is always fixed
_atsc_paq.push(['trackEvent',
'Button', // category
'Action', // always fixed
'Submit Form' // event name: also required to trigger automations
]);
כדי להפעיל אוטומציה מאירוע מותאם, ראו הטריגרים של הפיקסל החכם באוטומציות.
כללים כלליים
סדר הפקודות (חשוב מאוד)
- בעמוד מוצר או קטגוריה, קראו תמיד ל-
setEcommerceViewלפניtrackPageView. - הגדירו נתונים מותאמים (
setCustomData) לפני שליחת האירוע עצמו. - הוסיפו את המוצרים בעגלה או בהזמנה (
addEcommerceItem) לפניtrackEcommerceOrderאוtrackEcommerceCartUpdate.
מטבע
מגדירים את המטבע בעזרת setCustomData({ currency: 'USD' }). הוא חל על אירועי הזמנה, עגלה וצפייה במוצר (לא על צפייה בקטגוריה).
פרמטרי UTM (מעקב קמפיינים)
פרמטרי ה-UTM (utm_source, utm_medium, utm_campaign, utm_term, utm_keyword, utm_content) נאספים אוטומטית מכתובת העמוד ונשלחים עם כל אירוע, כולל הזמנות ועגלות. לא צריך להגדיר אותם בעצמכם.
למנהל השיווק: ודאו שכל הקישורים בקמפיינים שלכם (רשתות חברתיות, ניוזלטרים, Google Ads וכו') משתמשים בפרמטרי UTM עקביים. זה מה שמאפשר לשייך הזמנות ולידים לקמפיין שהביא אותם.
כללים נוספים
- אחרי שהזמנה נשלחת, פריטי העגלה שנשמרו במעקב נמחקים אוטומטית (כדי למנוע ספירה כפולה). Lead ו-Opportunity לא מרוקנים את העגלה.
- האירועים Cart, Lead ו-Opportunity מחייבים שהמבקר יהיה מזוהה כנמען קיים. אירועים של מבקר אנונימי נדחים ולא נשמרים.
- נתונים מותאמים (
setCustomData) "נדבקים": הם ממשיכים להישלח עם האירועים הבאים עד שמאפסים אותם. כדי לנקות אותם, קראו ל-setCustomData({})עם אובייקט ריק.
בדיקה שהמעקב עובד
כדי לבדוק שהאירועים נשלחים כמו שצריך:
- הלשונית Network: פתחו את כלי המפתחים בדפדפן (F12) ← הלשונית Network, וסננו לפי
Track3. לכל אירוע צריכה להופיע בקשה. - מצב דיבאג: הפעילו אותו פעם אחת, וכל בקשת מעקב תירשם בזמן אמת בקונסולה של הדפדפן. שימושי מאוד לבדיקות QA.
// Turn on debug mode: every tracking request is printed to the console
_atsc_paq.push(['setDebugMode', true]);
// Turn it off when you're done checking
_atsc_paq.push(['setDebugMode', false]);
כדי לבדוק שהפיקסל מותקן באתר שלכם, ראו בדיקה אם הפיקסל החכם מותקן.
בעיות נפוצות ופתרונות
| בעיה | סיבה אפשרית | פתרון |
|---|---|---|
| לא נשלחות בקשות מעקב | הספרייה לא נטענה, מזהה האתר שגוי, או שיש שגיאת JavaScript | ודאו שקוד הבסיס נמצא בעמוד, ובדקו את מזהה האתר ואת הקונסולה |
| אירועים לא מופיעים בדו"חות | TypeId שגוי או פרמטר חובה חסר | השוו לפרמטרי החובה בטבלה של כל אירוע |
| אירועי מסחר לא עובדים | המוצרים לא נוספו לפני שליחת ההזמנה | קראו ל-addEcommerceItem לפני trackEcommerceOrder
|
| צפייה במוצר או בקטגוריה לא מזוהה | setEcommerceView נקרא אחרי trackPageView
|
העבירו את setEcommerceView לפני trackPageView
|
| הנתונים המותאמים לא נכללים | setCustomData נקרא אחרי האירוע |
קראו ל-setCustomData לפני שליחת האירוע |
אתרי עמוד יחיד (React, Vue, Angular)
באפליקציית עמוד יחיד (SPA), מעבר בין "עמודים" לא טוען מחדש את הדפדפן. העבירו את הכללים האלה לצוות הפיתוח:
- טענו את קוד הבסיס פעם אחת בלבד, כשהאפליקציה עולה, ולא בכל החלפת מסך.
- שלחו
trackPageViewבכל מעבר מסלול (route): הפיקסל לא מזהה אותו אוטומטית. - בעמודי מוצר וקטגוריה, הגדירו את נתוני המסחר (
setEcommerceView) לפניtrackPageView, בכל מעבר מסלול. setUserIdנשאר תמיד'_atscid', לפני ההתחברות ואחריה.- שלחו Register מיד אחרי התחברות מוצלחת, כדי שהמבקר יזוהה.
- נקו את העגלה שנשמרה במעקב (
clearEcommerceCart) כשהמבקר עוזב את עמוד העגלה או התשלום, לפי הצורך.
למנהל השיווק: אם האתר שלכם הוא SPA, ודאו שהצוות הטכני שולח צפייה בעמוד בכל החלפת מסך. אחרת דו"חות הביקורים בעמודים יהיו חלקיים.
דוגמה: מעקב עמודים עם React Router:
import { useEffect } from 'react';
import { useLocation } from 'react-router-dom';
function App() {
const location = useLocation();
useEffect(() => {
if (window._atsc_paq) {
window._atsc_paq.push(['trackPageView', document.title]);
}
}, [location]);
return <YourApp />;
}
טעויות נפוצות שכדאי להימנע מהן
- הגדרת נתוני המוצר אחרי הצפייה בעמוד. לא נכון:
trackPageViewלפניsetEcommerceView. נכון: תמידsetEcommerceViewקודם, ואזtrackPageView. - לא לנקות את העגלה בין הזמנות. אם עוקבים אחרי כמה הזמנות ברצף, ודאו שהפריטים של ההזמנה הקודמת לא עוברים להזמנה הבאה. הפיקסל מנקה אותם אוטומטית אחרי
trackEcommerceOrder; ב-Cart, נקו אותם בעצמכם לפי הצורך. - שינוי הערך של setUserId. לא נכון:
setUserId(user.id)או כל ערך אחר. נכון:setUserId('_atscid'), תמיד, בלי יוצא מן הכלל. - הגדרת נתונים מותאמים אחרי האירוע. קראו ל-
setCustomDataלפני שליחת האירוע (trackPageView,trackEcommerceOrderוכו'), אחרת הנתונים לא נכללים. - לא להוסיף מוצרים לפני הזמנה או עדכון עגלה. קראו ל-
addEcommerceItemלפניtrackEcommerceOrderאוtrackEcommerceCartUpdate. - לשכוח לעקוב אחרי עמודים ב-SPA. שלחו
trackPageViewבכל מעבר מסלול, ולא רק בטעינה הראשונה. - שימוש במחרוזות ריקות במקום null. לפרמטרים אופציונליים ריקים (כמו שדות המוצר בעמוד קטגוריה), העבירו
nullאוundefinedולא מחרוזת ריקה, למרות שגם מחרוזת ריקה עובדת.