Dimensi dan metrik kustom dengan gtag.js

Developer web dapat menggunakan dimensi dan metrik kustom untuk menyegmentasikan dan mengukur perbedaan antara pengguna yang login dan logout, penulis halaman, atau level dalam game. Halaman ini menjelaskan cara mengirim dimensi dan metrik kustom ke Google Analytics.

Untuk mengirim nilai parameter kustom ke Google Analytics, petakan parameter ke parameter metrik atau dimensi Google Analytics kustom berikut:

Parameter kustom Jenis data Deskripsi
dimension<Index> string Parameter dimensi kustom (misalnya, dimension3)
metric<Index> string Parameter metrik kustom (misalnya, metric8)

Mengonfigurasi dan mengirim dimensi kustom

Untuk mengirim nilai parameter kustom ke Google Analytics, Anda perlu memetakan nilai di situs ke parameter Google Analytics. Hal ini dapat dilakukan menggunakan parameter custom_map.

Untuk mengirim dimensi kustom ke Google Analytics, update config untuk properti Anda agar dapat menetapkan parameter custom_map untuk dimensi, lalu gunakan parameter kustom untuk mengirim nilai dimensi kustom:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

Ganti 'GA_MEASUREMENT_ID' dengan ID Analytics Anda sendiri.

Misalnya, cuplikan berikut akan mengirim dimensi kustom dimension2 dengan nilai 55 ke Google Analytics:

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

Mengonfigurasi dan mengirim metrik kustom

Untuk mengirim metrik kustom ke Google Analytics, update config properti Anda untuk menetapkan parameter custom_map metrik dan kemudian gunakan parameter kustom untuk mengirim nilai metrik kustom:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

Ganti 'GA_MEASUREMENT_ID' dengan ID Analytics Anda sendiri.

Misalnya, cuplikan berikut akan mengirim metrik kustom metric5 dengan nilai 1 ke Google Analytics:

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

Mengonfigurasi dan mengirim dimensi kustom dan metrik kustom

Anda dapat mengupdate config properti untuk memetakan dimensi kustom dan metrik kustom:

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});