במדריך הזה מפורט תהליך ההעברה של הטמעה קיימת של analytics.js
Universal Analytics לשימוש ב-gtag.js
.
סקירה
ל-analytics.js יש שני מנגנונים עיקריים לשליחת נתונים אל Google Analytics:
-
כלי מעקב מציינים את המאפיין שאתם מודדים.
-
סוגי היטים מציינים את סוג האינטראקציה שאתם מודדים.
המאפיינים של gtag.js
מצוינים באמצעות הפקודה config
, או כפרמטר לפקודה.
בניגוד ל-analytics.js, gtag.js לא משתמש בכלי מעקב כדי לשלוח נתונים אל Google Analytics. הוא שולח נתונים לנכסי Google Analytics שמזוהים לפי המזהים שלהם שהוגדרו על ידי הפקודה config
. שמות האירועים שמסופקים ל-gtag.js מציינים את סוגי הנתונים שנשלחים אל Google Analytics.
כדי לעבור מ-analytics.js ל-gtag.js, צריך לבצע את הפעולות הבאות בכל דף אינטרנט באתר שלכם:
במקום קוד analytics.js, צריך להחליף את קוד gtag.js המקביל כדי:
החלפת קטע הקוד של analytics.js בקטע הקוד של gtag.js
מחליפים את קטע הקוד של analytics.js בדף האינטרנט:
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
בעזרת קטע הקוד הבא של gtag.js:
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
מדידת צפיות בדף
האתר analytics.js משתמש בכלי מעקב כדי לשלוח צפיות בדפים ל-Google Analytics. כלי מעקב כולל את מזהה המדידה של נכס ב-Google Analytics. gtag.js שולח צפיות בדפים לנכס Google Analytics שמזוהה באמצעות TAG_ID
שצוין בפקודה config
.
מדידת צפיות בדפים באמצעות מכשיר המעקב שמוגדר כברירת מחדל
מסירים את הקוד הבא של analytics.js שמשתמש בכלי המעקב שמוגדר כברירת מחדל כדי לבצע send
צפיות בדפים ב-Google Analytics:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');
הקוד הבא בקטע הקוד gtag.js שולח באופן אוטומטי צפייה בדף לנכס Google Analytics עם מזהה התג TAG_ID
:
gtag('config', 'TAG_ID');
מדידת צפיות בדף באמצעות מכשירי מעקב ספציפיים
החלף את קוד analytics.js הבא שמשתמש בכלי המעקב שצוין כדי לשלוח צפיות בדפים ל-Google Analytics:
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');
באמצעות הפקודה הבאה של gtag.js event
:
gtag('event', 'page_view', { 'send_to': 'TAG_ID' });
מדידת אירועים
כפי שצוין קודם, מערכת analytics.js משתמשת בכלי מעקב כדי לשלוח אירועים אל Google Analytics. מכשיר מעקב כולל את המזהה לצורכי מעקב של נכס ב-Google Analytics. לעומת זאת, gtag.js שולח אירועים לנכס ב-Google Analytics שמזוהה באמצעות TAG_ID
שצוין בפקודה config
.
מדידת אירועים באמצעות מכשיר המעקב שמוגדר כברירת מחדל
מחליפים את הקוד הבא של analytics.js שמשתמש בכלי המעקב שמוגדר כברירת מחדל ל-send
אירועים ב-Google Analytics:
ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
באמצעות הפקודה הבאה gtag.js event
:
gtag('event', eventName, eventParameters);
כאשר eventName
הוא שם האירוע שרוצים לתעד.
דוגמה:
analytics.js:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
מדידת אירועים באמצעות מכשירי מעקב ספציפיים
מחליפים את הקוד analytics.js הבא שמשתמש בכלי המעקב שצוין כדי לשלוח אירועים אל Google Analytics:
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
באמצעות הפקודה הבאה של gtag.js event
:
gtag('event', eventName, {
'send_to': 'TAG_ID',
'parameter1': 'value1',
'parameter2': 'value2',
// ...
});
דוגמה:
analytics.js:
// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');
// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
'send_to': 'TAG_ID',
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
שליחת מאפיינים ומדדים מותאמים אישית
החלף את כל פקודת send
של analytics.js בדפי האינטרנט שלך ששולחת מאפיינים מותאמים אישית אל Google Analytics:
ga('send', 'hitType', { 'dimension<Index>': 'dimension_value'});
בעזרת קוד gtag.js הבא:
gtag('config', 'TAG_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});
מחליפים את TAG_ID
במזהה Analytics שלכם.
החלף את כל פקודת send
של analytics.js בדפי האינטרנט שלך ששולחת ערכים מותאמים אישית אל Google Analytics:
ga('send', 'hitType', { 'metric<Index>': 'metric_value'});
בעזרת קוד gtag.js הבא:
gtag('config', 'TAG_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});
מחליפים את TAG_ID
במזהה התג.
מדידת תזמוני משתמש
מחליפים את כל פקודת send
של analytics.js בדפי האינטרנט שעוקבת אחרי תזמוני משתמש:
ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');
באמצעות הפקודה gtag.js event
הבאה:
gtag('event', 'timing_complete', {
'name': 'timingVar',
'value': timingValue,
'event_category': 'timingCategory',
'event_label': 'timingLabel'
});
מדידת חריגים
מחליפים את כל פקודת send
של analytics.js בדפי האינטרנט שעוקבת אחרי חריגים:
ga('send', 'exception', {
'exDescription': 'error_message',
'exFatal': false // set to true if the exception is fatal
});
באמצעות הפקודה הבאה
gtag.js event
:
gtag('event', 'exception', {
'description': 'error_message',
'fatal': false // set to true if the exception is fatal
});
מיפוי שדות של analytics.js לפרמטרים של gtag.js
בטבלאות הבאות מתבצעות מיפוי של השדות של analytics.js לפרמטרים התואמים של gtag.js.
אירועים
שדה analytics.js | פרמטר gtag.js |
---|---|
eventAction |
event_action |
eventCategory |
event_category |
eventLabel |
event_label |
eventValue |
value |
מאפיינים ומדדים מותאמים אישית
שדה analytics.js | פרמטר gtag.js |
---|---|
dimension<Index> |
dimension<Index> |
metric<Index> |
metric<Index> |
כאשר <Index>
הוא מספר שלם לא שלילי שמייצג את האינדקס של המאפיין או המדד המותאם אישית.
תזמוני משתמש
שדה analytics.js | פרמטר gtag.js |
---|---|
timingCategory |
event_category |
timingLabel |
event_label |
timingValue |
value |
timingVar |
name |
מדידת חריגים
שדה analytics.js | פרמטר gtag.js |
---|---|
exDescription |
description |
exFatal |
fatal |
נתוני פעולות במסחר אלקטרוני משופר
שדה analytics.js | פרמטר gtag.js |
---|---|
id |
transaction_id |
affiliation |
affiliation |
revenue |
value |
tax |
tax |
shipping |
shipping |
coupon |
coupon |
list |
list_name |
step |
checkout_step |
option |
checkout_option |
נתוני מבצע
שדה analytics.js | פרמטר gtag.js |
---|---|
creative |
creative_name |
position (חשיפה, מוצר) |
list_position |
position (קידום מכירות) |
creative_slot |
פעולות שקשורות למוצרים ולקידום מכירות
שדה analytics.js | אירוע gtag.js |
---|---|
add |
add_to_cart |
checkout (שלב ראשון) |
begin_checkout |
checkout (כל שלב עוקב) |
checkout_progress |
checkout_option |
set_checkout_option |
click |
select_content (ללא מבצעים) |
detail |
view_item |
promo_click |
select_content (עם מבצעים) |
purchase |
purchase |
refund |
refund |
remove |
remove_from_cart |
Client-ID ו-User-ID
שדה analytics.js | פרמטר gtag.js |
---|---|
clientId |
client_id |
userId |
user_id |