מעבר מ-analytics.js ל-gtag.js (Universal Analytics)

במדריך הזה מפורט תהליך ההעברה של הטמעה קיימת של analytics.js Universal Analytics לשימוש ב-gtag.js.

סקירה

ל-analytics.js יש שני מנגנונים עיקריים לשליחת נתונים אל Google Analytics:

  1. מכשירי מעקב

    כלי מעקב מציינים את המאפיין שאתם מודדים.

  2. סוגי היטים

    סוגי היטים מציינים את סוג האינטראקציה שאתם מודדים.

המאפיינים של 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 בדף האינטרנט:

<!-- 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&lt;Index&gt;':  '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