שימוש ביישומי פלאגין

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

במדריך הזה מוסבר איך לדרוש יישומי פלאגין של analytics.js ולהשתמש בהם.

שימוש ביישומי פלאגין

הפקודה require מקבלת את שם הפלאגין ורושם אותו לשימוש עם תור הפקודות של ga(). אם הפלאגין מקבל אפשרויות הגדרה, ניתן להעביר את האפשרויות האלה כארגומנט הסופי לפקודה require.

זו החתימה המלאה של הפקודה require:

ga('[trackerName.]require', pluginName, [pluginOptions]);

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

ga('require', 'ec');

באופן הבא, יש לדרוש את הפלאגין תכונות הפרסום עבור מכשיר מעקב בשם "myMonitor" ולהעביר אפשרות הגדרה שמבטלת את ערך השם של קובץ ה-cookie שמוגדר כברירת מחדל:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

טעינת קוד הפלאגין

הפקודה require מפעילה את שיטות הפלאגין לשימוש עם תור הפקודות ga(), אבל היא לא טוענת את הסקריפט של הפלאגין עצמו. אם אתם משתמשים בפלאגין של צד שלישי או כותבים פלאגין בעצמכם, תצטרכו להוסיף את קוד הפלאגין לדף באופן ידני.

השיטה המומלצת להוספת קוד פלאגין לדף היא באמצעות תג <script>, עם מאפיין async שמוגדר כדי להבטיח שהוא לא יחסום את הטעינה של תכונות אחרות באתר.

הקוד הבא דורש וגם טוען פלאגין של מעקב היפותטי למעקב אחר קישורים:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

הערה: יישומי פלאגין רשמיים של Google Analytics עבור analytics.js נטענים באופן אוטומטי כשהם נדרשים. אין צורך להוסיף תגי סקריפט עבורם. הרשימה המלאה של יישומי הפלאגין הרשמיים analytics.js מופיעה בקטע יישומי פלאגין רשמיים בתפריט הניווט הימני.

בהמתנה לטעינת יישומי פלאגין

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

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

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

שיטות יישומי פלאגין של קריאה

אחרי הדרישה לפלאגין, השיטות זמינות לשימוש עם תור הפקודות של ga(). זוהי חתימת הפקודה לשיטות של יישומי פלאגין:

ga('[trackerName.][pluginName:]methodName', ...args);

לדוגמה, השיטה addProduct של הפלאגין מסחר אלקטרוני משופר יכולה להיקרא כך:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

לחלופין, על מכשיר מעקב עם שם, מוסיפים את השם של מכשיר המעקב למחרוזת הפקודה:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

השלבים הבאים

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