Phương diện và chỉ số tuỳ chỉnh thông qua gtag.js

Nhà phát triển web có thể sử dụng phương diện và chỉ số tuỳ chỉnh để phân đoạn và đo lường sự khác biệt giữa người dùng đăng nhập và đăng xuất, tác giả của trang hoặc cấp độ trong trò chơi. Trang này mô tả cách gửi phương diện và chỉ số tuỳ chỉnh đến Google Analytics.

Để gửi giá trị của các thông số tùy chỉnh đến Google Analytics, hãy liên kết các thông số đó với các thông số chỉ số hoặc phương diện Google Analytics tùy chỉnh sau:

Thông số tùy chỉnh Loại dữ liệu Nội dung mô tả
dimension<Index> string Thông số phương diện tùy chỉnh (ví dụ: dimension3)
metric<Index> string Thông số chỉ số tùy chỉnh (ví dụ: metric8)

Định cấu hình và gửi phương diện tuỳ chỉnh

Để gửi giá trị của một thông số tuỳ chỉnh đến Google Analytics, bạn cần liên kết một giá trị trên trang web của mình với một thông số Google Analytics. Bạn có thể hoàn thành việc này bằng cách sử dụng tham số custom_map.

Để gửi một thứ nguyên tùy chỉnh đến Google Analytics, hãy cập nhật config cho thuộc tính của bạn để đặt thông số custom_map cho thứ nguyên và sau đó sử dụng thông số tùy chỉnh để gửi giá trị của thứ nguyên tùy chỉnh:

// 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});

Thay thế 'GA_MEASUREMENT_ID' bằng mã Analytics của riêng bạn.

Ví dụ: đoạn mã sau đây sẽ gửi phương diện tuỳ chỉnh dimension2 có giá trị 55 đến 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});

Định cấu hình và gửi chỉ số tuỳ chỉnh

Để gửi một chỉ số tùy chỉnh đến Google Analytics, hãy cập nhật config cho tài sản của bạn để đặt tham số custom_map cho chỉ số và sau đó sử dụng thông số tùy chỉnh để gửi giá trị của chỉ số tùy chỉnh:

// 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});

Thay thế 'GA_MEASUREMENT_ID' bằng mã Analytics của riêng bạn.

Ví dụ: đoạn mã sau đây sẽ gửi chỉ số tuỳ chỉnh metric5 có giá trị 1 đến 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});

Định cấu hình và gửi các phương diện cũng như chỉ số tuỳ chỉnh

Bạn có thể cập nhật config của thuộc tính để liên kết cả phương diện tuỳ chỉnh và chỉ số tuỳ chỉnh:

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

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