יצירת כלי מעקב

אובייקטים למעקב (שנקראים גם 'כלי מעקב') הם אובייקטים שיכולים לאסוף ולאחסן נתונים ואז לשלוח את הנתונים האלה ל-Google Analytics.

כשיוצרים כלי מעקב חדש, צריך לציין מזהה מעקב (זהה למזהה הנכס שתואם לאחד מהנכסים ב-Google Analytics) וגם דומיין של קובצי cookie, שמציין איך קובצי ה-cookie נשמרים. (הערך המומלץ 'auto' מציין הגדרה אוטומטית של דומיין קובצי cookie).

אם לא קיים קובץ cookie בדומיין שצוין, המערכת תיצור מזהה לקוח שיישמר בקובץ ה-cookie והמשתמש יזוהה בתור חדש. אם קיים קובץ cookie שמכיל ערך של מזהה לקוח, מזהה הלקוח הזה מוגדר בכלי המעקב והמשתמש מזוהה כחוזר.

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

שיטת היצירה

בספריית analytics.js יש מגוון דרכים ליצור כלי מעקב, אבל הדרך הנפוצה ביותר היא להשתמש בפקודה create ולהעביר את השדות מזהה מעקב ודומיין של קובצי cookie כפרמטר השני והשלישי:

ga('create', 'UA-XXXXX-Y', 'auto');

מתן שמות למעקבים

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

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

יצירת מכשיר מעקב בלי להגדיר את השדה name נקראת יצירת מכשיר מעקב שמוגדר כברירת מחדל. מכשיר מעקב שמוגדר כברירת מחדל מקבל את השם 't0' באופן פנימי.

ציון שדות בזמן היצירה

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

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

בדומה לכל הקריאות לפונקציה ga(), ניתן להשתמש באובייקט השדות גם כדי לציין את כל השדות יחד:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto',
  name: 'myTracker',
  userId: '12345'
});

פרטים מקיפים יותר זמינים במאמר בנושא השיטה create.

עבודה עם מספר מכשירי מעקב

במקרים מסוימים, כדאי לשלוח נתונים לכמה נכסים מדף אחד. ההגדרה הזו שימושית לאתרים שיש להם מספר בעלים המפקחים על חלקים באתר. כל בעלים יכול להציג את הנכס שלו.

כדי לעקוב אחרי נתונים בשני נכסים נפרדים, צריך ליצור שני כלי מעקב נפרדים, ולפחות אחד מהם צריך להיות כלי מעקב עם שם. שתי הפקודות הבאות יוצרות מכשיר מעקב שמוגדר כברירת מחדל ומכשיר מעקב בשם ClientMonitor:

ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');

הרצת פקודות במכשיר מעקב ספציפי

כדי להריץ פקודות analytics.js עבור מכשיר מעקב ספציפי, מוסיפים לשם הפקודה שם של כלי מעקב ואחריו נקודה. אם לא מציינים שם של מכשיר מעקב, הפקודה תרוץ במכשיר המעקב שמוגדר כברירת מחדל.

כדי לשלוח צפיות בדף עבור שני כלי המעקב שלמעלה, יש להריץ את שתי הפקודות הבאות:

ga('send', 'pageview');
ga('clientTracker.send', 'pageview');

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

השלבים הבאים

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