Melakukan migrasi dari analytics.js ke gtag.js (Universal Analytics)

Panduan ini membahas proses migrasi penerapan Universal Analytics analytics.js yang ada untuk menggunakan gtag.js.

Ringkasan

analytics.js memiliki dua mekanisme utama untuk mengirim data ke Google Analytics:

  1. pelacak

    Pelacak menentukan properti mana yang Anda ukur.

  2. jenis hit

    Jenis hit menentukan jenis interaksi apa yang Anda ukur.

Di gtag.js, properti ditentukan melalui perintah config, atau sebagai parameter ke perintah.

Tidak seperti analytics.js, gtag.js tidak menggunakan pelacak untuk mengirim data ke Google Analytics. gtag.js mengirim data ke properti Google Analytics yang diidentifikasi menurut ID mereka yang ditetapkan oleh perintah config. Nama peristiwa yang diberikan ke gtag.js menentukan jenis data yang dikirim ke Google Analytics.

Untuk bermigrasi dari analytics.js ke gtag.js, lakukan hal berikut untuk setiap halaman web di situs Anda:

Mengganti cuplikan analytics.js dengan cuplikan gtag.js

Ganti cuplikan analytics.js di halaman web Anda:

<!-- 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', 'GA_MEASUREMENT_ID', 'auto');
  ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

dengan cuplikan gtag.js berikut:

<!-- Global Site Tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'GA_MEASUREMENT_ID');
</script>

Mengukur kunjungan halaman

analytics.js menggunakan pelacak untuk mengirim kunjungan halaman ke Google Analytics. Pelacak memiliki ID pengukuran properti Google Analytics. gtag.js mengirim kunjungan halaman ke properti Google Analytics yang diidentifikasi oleh GA_MEASUREMENT_ID yang ditentukan dalam perintah config.

Mengukur kunjungan halaman dengan pelacak default

Hapus kode analytics.js berikut yang menggunakan pelacak default untuk send kunjungan halaman ke Google Analytics:

// Creates the default tracker.
ga('create', 'GA_MEASUREMENT_ID', 'auto');

// Uses the default tracker to send a pageview to the
// Google Analytics property with tracking ID GA_MEASUREMENT_ID.
ga('send', 'pageview');

Kode berikut dalam cuplikan global gtag.js secara otomatis mengirim kunjungan halaman ke properti Google Analytics dengan ID pelacakan GA_MEASUREMENT_ID:

gtag('config', 'GA_MEASUREMENT_ID');

Mengukur kunjungan halaman dengan pelacak yang ditentukan

Ganti kode analytics.js berikut yang menggunakan pelacak yang ditentukan untuk mengirim kunjungan halaman ke Google Analytics:

ga('create', 'GA_MEASUREMENT_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');

dengan perintah event gtag.js berikut:

gtag('event', 'page_view', { 'send_to': 'GA_MEASUREMENT_ID' });

Mengukur peristiwa

Seperti yang disebutkan sebelumnya, analytics.js menggunakan pelacak untuk mengirim peristiwa ke Google Analytics. Pelacak memiliki ID pelacakan properti Google Analytics. Sebaliknya, gtag.js mengirim peristiwa ke properti Google Analytics yang diidentifikasi oleh GA_MEASUREMENT_ID yang ditentukan dalam perintah config.

Mengukur peristiwa dengan pelacak default

Ganti kode analytics.js berikut yang menggunakan pelacak default untuk send peristiwa ke Google Analytics:

ga('create', 'GA_MEASUREMENT_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

dengan perintah gtag.js event berikut:

gtag('event', eventName, eventParameters);

dengan eventName adalah nama peristiwa yang ingin Anda catat dalam log.

Contoh:

analytics.js:

// Creates the default tracker.
ga('create', 'GA_MEASUREMENT_ID', 'auto');

// Uses the default tracker to send the event to the
// Google Analytics property with tracking ID GA_MEASUREMENT_ID.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Sends the event to the Google Analytics property with
// tracking ID GA_MEASUREMENT_ID set by the config command in
// the global tracking snippet.
gtag('event', 'play', {
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

Mengukur peristiwa dengan pelacak yang ditentukan

Ganti kode analytics.js berikut yang menggunakan pelacak yang telah ditentukan untuk mengirim peristiwa ke Google Analytics:

ga('create', 'GA_MEASUREMENT_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

dengan perintah event gtag.js berikut:

gtag('event', eventName, {
  'send_to': 'GA_MEASUREMENT_ID',
  'parameter1': 'value1',
  'parameter2': 'value2',
  // ...
});

Contoh:

analytics.js:

// Creates a tracker named <b>clientTracker</b>.
ga('create', 'GA_MEASUREMENT_ID', 'auto', 'clientTracker');

// Uses tracker clientTracker to send the event to the
// Google Analytics property with tracking ID GA_MEASUREMENT_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Send the event to the Google Analytics property
// with tracking ID GA_MEASUREMENT_ID.
gtag('event', 'play', {
  'send_to': 'GA_MEASUREMENT_ID',
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

Mengirim dimensi dan metrik kustom

Ganti perintah send analytics.js di halaman web yang mengirim dimensi kustom ke Google Analytics:

ga('send', 'hitType', { 'dimension&lt;Index&gt;':  'dimension_value'});

dengan kode gtag.js berikut:

gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});

Ganti GA_MEASUREMENT_ID dengan ID Analytics Anda sendiri.

Ganti perintah send analytics.js di halaman web Anda yang mengirim metrik kustom ke Google Analytics:

ga('send', 'hitType', { 'metric<Index>':  'metric_value'});

dengan kode gtag.js berikut:

gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});

Ganti GA_MEASUREMENT_ID dengan ID Analytics Anda sendiri.

Mengukur waktu pengguna

Ganti perintah send analytics.js di halaman web Anda yang melacak waktu pengguna:

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

dengan perintah gtag.js event berikut:

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

Mengukur pengecualian

Ganti semua perintah send analytics.js di halaman web Anda yang melacak pengecualian:

ga('send', 'exception', {
  'exDescription': 'error_message',
  'exFatal': false  // set to true if the exception is fatal
});

dengan perintah event gtag.js berikut:

gtag('event', 'exception', {
  'description': 'error_message',
  'fatal': false  // set to true if the exception is fatal
});

Memetakan kolom analytics.js ke parameter gtag.js

Tabel berikut memetakan kolom analytics.js ke parameter gtag.js yang sesuai.

Peristiwa

kolom analytics.js parameter gtag.js
eventAction event_action
eventCategory event_category
eventLabel event_label
eventValue value

Dimensi dan metrik kustom

kolom analytics.js parameter gtag.js
dimension<Index> dimension<Index>
metric<Index> metric<Index>

dengan <Index> adalah bilangan bulat non-negatif yang mewakili indeks dimensi atau metrik kustom.

Waktu pengguna

kolom analytics.js parameter gtag.js
timingCategory event_category
timingLabel event_label
timingValue value
timingVar name

Pengukuran pengecualian

kolom analytics.js parameter gtag.js
exDescription description
exFatal fatal

Data tindakan enhanced e-commerce

kolom analytics.js parameter gtag.js
id transaction_id
affiliation affiliation
revenue value
tax tax
shipping shipping
coupon coupon
list list_name
step checkout_step
option checkout_option

Data promosi

kolom analytics.js parameter gtag.js
creative creative_name
position (tayangan, produk) list_position
position (promosi) creative_slot

Tindakan produk dan promosi

kolom analytics.js peristiwa gtag.js
add add_to_cart
checkout (langkah pertama) begin_checkout
checkout (langkah berikutnya) checkout_progress
checkout_option set_checkout_option
click select_content (tanpa promosi)
detail view_item
promo_click select_content (dengan promosi)
purchase purchase
refund refund
remove remove_from_cart

Client ID dan user ID

kolom analytics.js parameter gtag.js
clientId client_id
userId user_id