מעבר מ-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 במזהה התג.

מדידת תזמוני משתמש

להחליף כל פקודת analytics.js send בדפי האינטרנט שלך עוקבת אחר תזמוני משתמש:

ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');

עם הפקודה הבאה gtag.js event:

gtag('event', 'timing_complete', {
  'name': 'timingVar',
  'value': timingValue,
  'event_category': 'timingCategory',
  'event_label': 'timingLabel'
});

מדידת חריגים

כל פקודת analytics.js send בדפי האינטרנט שלך עוקבת אחר חריגים:

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