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

אובייקטי מעקב (שנקראים גם 'כלי מעקב') הם אובייקטים שיכולים לאסוף ולאחסן נתונים ולאחר מכן לשלוח את הנתונים האלה ל-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.

השלבים הבאים

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