מקשר

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

סקירה

כדי לבצע מדידה בכמה דומיינים, המערכת משתפת מזהה לקוח ייחודי בין דומיין מקור לדומיין יעד. זהו תהליך דו-שלבי:

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

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

פרמטר המקשר ייראה בערך כך:

_ga=1.199239214.1624002396.1440697407

בדומיין היעד מופיע השדה allowLinker, כאשר true מורה ל-analytics.js לבדוק פרמטרים של מקשר בכתובת ה-URL. אם פרמטר הקישור נמצא והוא חוקי, הוא מחלץ את מזהה הלקוח מהפרמטר ושומר אותו.

הפלאגין Linker מאפשר הוספה אוטומטית וידנית של הפרמטר linker לכתובות URL בקישורים ובטפסים בדף. ברוב המקרים, מומלץ לבחור בשיטה האוטומטית.

הוספה אוטומטית של פרמטרים מסוג linker

כדי להגדיר קישור אוטומטי בין דומיינים בדומיין המקור עבור כתובות URL שמפנות לדומיין היעד, צריך require את הפלאגין לקישור ולהפעיל את השיטה autoLink.

ניתן לקרוא לשיטה autoLink באמצעות תור הפקודות.

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

אם יש באתר טפסים שמפנים לדומיין היעד, יש לציין את הפרמטר האופציונלי decorateForms ולהגדיר אותו ל-true.

Usage

ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);

פרמטרים

שם סוג חובה תיאור
domains Array[RexExp|string] כן מערך של מחרוזות או ביטויים רגולריים להתאמה אל hostname של כתובת URL, שמציין על אילו דומיינים הקישור האוטומטי צריך לחול. אם מחרוזת מועברת, analytics.js יבצע התאמה של מחרוזת משנה. כלומר, example.com יתאים לקישורים שמפנים אל blog.example.com.
useAnchor boolean no אם הערך הוא True, פרמטר המקשר יתווסף לחלק העוגן של כתובת ה-URL במקום לחלק של השאילתה.
decorateForms boolean no אם הערך הוא True, פלאגין הקישור יוסיף פרמטר linker לשליחת טפסים שמצביעים ליעדים שתואמים לפרמטר domain.

דוגמה

// Loads the Linker plugin
ga('require', 'linker');

// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);

הוספה ידנית של פרמטרים של מקשר

אפשר להוסיף את פרמטר הקישור באופן ידני לרכיב <a> או <form> מסוים באמצעות השיטה decorate. השיטה הזו נחוצה רק כשלא משתמשים בשיטה autoLink שמתוארת למעלה.

decorate

ניתן לקרוא לשיטה decorate באמצעות תור הפקודות.

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

Usage

ga('[trackerName.]linker:decorate', element, [useAnchor]);

פרמטרים

שם סוג חובה תיאור
element HTMLElement כן הרכיב <a> או <form> שאליו יש לצרף את הפרמטר linker.
useAnchor boolean no אם הערך הוא True, פרמטר המקשר יתווסף לחלק העוגן של כתובת ה-URL במקום לחלק של השאילתה.

דוגמה

// Loads the Linker plugin
ga('require', 'linker');

// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');

// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
  ga('linker:decorate', destinationLink);
});

linkerParam

בנוסף ל-method decorate, אפשר לקבל באופן ידני את הפרמטר linker שבו ישתמש כלי המעקב דרך השדה linkerParam.

ga(function(tracker) {
  var linkerParam = tracker.get('linkerParam');
});

הגדרת אתר לקבלת פרמטרים של מקשר

כשמשתמש מגיע לדף בדומיין היעד שמכיל פרמטר linker בכתובת ה-URL, מערכת analytics.js צריכה לדעת לחפש את הפרמטר הזה.

אתם יכולים להנחות את דף היעד לחפש פרמטרים של מקשר על ידי הגדרת השדה allowLinker לערך true כשיוצרים את כלי המעקב:

ga('create', 'UA-XXXXXX-X', 'auto', {
  allowLinker: true
});

מדידה דו-כיוונית בכמה דומיינים

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

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

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

בתאריך source.com:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);

בתאריך destination.com:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);

להשתמש בקטע קוד יחיד בכל הדומיינים

כדי לפשט את התהליך הזה עוד יותר, ניתן לפרט את כל הדומיינים האפשריים שרוצים למדוד בשיטת autoLink, וכך להשתמש באותו קטע קוד בכל דומיין:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);