ابعاد و معیارهای سفارشی با gtag.js، ابعاد و معیارهای سفارشی با gtag.js

توسعه دهندگان وب می توانند از ابعاد و معیارهای سفارشی برای تقسیم بندی و اندازه گیری تفاوت بین کاربران وارد شده و خارج شده، نویسندگان صفحات یا سطوح در بازی ها استفاده کنند. در این صفحه نحوه ارسال ابعاد و معیارهای سفارشی به Google Analytics توضیح داده شده است.

برای ارسال مقادیر پارامترهای سفارشی به Google Analytics، پارامترها را به بعد یا پارامترهای متریک سفارشی Google Analytics نگاشت کنید:

پارامتر سفارشی	نوع داده	شرح
`dimension<Index>`	`string`	پارامتر ابعاد سفارشی (به عنوان مثال `dimension3` )
`metric<Index>`	`string`	پارامتر متریک سفارشی (به عنوان مثال `metric8` )

پیکربندی و ارسال ابعاد سفارشی

برای ارسال مقدار یک پارامتر سفارشی به Google Analytics، باید یک مقدار در وب سایت خود را به پارامتر Google Analytics نگاشت کنید. این را می توان با استفاده از پارامتر custom_map انجام داد.

برای ارسال یک بعد سفارشی به Google Analytics، config دارایی خود را به‌روزرسانی کنید تا پارامتر custom_map برای بعد تنظیم کنید و سپس از پارامتر سفارشی برای ارسال مقدار بعد سفارشی استفاده کنید:

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

شناسه Analytics خودتان را جایگزین 'GA_MEASUREMENT_ID' کنید.

به عنوان مثال، قطعه زیر بعد سفارشی dimension2 با مقدار 55 به 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});

معیارهای سفارشی را پیکربندی و ارسال کنید

برای ارسال یک معیار سفارشی به Google Analytics، config دارایی خود را به‌روزرسانی کنید تا پارامتر custom_map برای متریک تنظیم کند و سپس از پارامتر سفارشی برای ارسال مقدار معیار سفارشی استفاده کنید:

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

شناسه Analytics خودتان را جایگزین 'GA_MEASUREMENT_ID' کنید.

به عنوان مثال، قطعه زیر متریک سفارشی metric5 را با مقدار 1 به 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});

ابعاد سفارشی و معیارهای سفارشی را پیکربندی و ارسال کنید

می‌توانید config دارایی خود را برای ترسیم ابعاد سفارشی و معیارهای سفارشی به‌روزرسانی کنید:

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

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

پارامتر سفارشی	نوع داده	شرح
`dimension<Index>`	`string`	پارامتر ابعاد سفارشی (به عنوان مثال `dimension3` )
`metric<Index>`	`string`	پارامتر متریک سفارشی (به عنوان مثال `metric8` )

پیکربندی و ارسال ابعاد سفارشی

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

شناسه Analytics خودتان را جایگزین 'GA_MEASUREMENT_ID' کنید.

به عنوان مثال، قطعه زیر بعد سفارشی dimension2 با مقدار 55 به 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});

معیارهای سفارشی را پیکربندی و ارسال کنید

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

شناسه Analytics خودتان را جایگزین 'GA_MEASUREMENT_ID' کنید.

به عنوان مثال، قطعه زیر متریک سفارشی metric5 را با مقدار 1 به 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});

ابعاد سفارشی و معیارهای سفارشی را پیکربندی و ارسال کنید

می‌توانید config دارایی خود را برای ترسیم ابعاد سفارشی و معیارهای سفارشی به‌روزرسانی کنید:

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

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