المكوّنات والمقاييس المخصّصة باستخدام gtag.js

يمكن لمطوّري برامج الويب استخدام المقاييس والمكوّنات المخصّصة لتقسيم الاختلافات بين المستخدمين الذين سجّلوا دخولهم، أو مؤلفو الصفحات، أو المستويات في الألعاب، وقياس هذه الاختلافات. توضّح هذه الصفحة كيفية إرسال المكونات والمقاييس المخصّصة إلى "إحصاءات Google".

لإرسال قيم المعلّمات المخصّصة إلى "إحصاءات Google"، يجب ربط المعلّمات بسمات المكوّنات أو المقاييس المخصّصة التالية في "إحصاءات Google":

المعلّمة المخصّصة	نوع البيانات	الوصف
dimension<Index>	string	معلّمة المكوّن المخصّص (مثل dimension3)
metric<Index>	string	معلّمة مقياس مخصّص (مثل metric8)

ملاحظة: عند تسمية معلّمات مخصّصة، تجنّب استخدام الاسم نفسه كأي معلّمة ضبط في "إحصاءات Google" 4.

ضبط الأبعاد المخصّصة وإرسالها

لإرسال قيمة مَعلمة مخصّصة إلى "إحصاءات Google"، يجب ربط قيمة على موقعك الإلكتروني بمَعلمة في "إحصاءات Google". ويمكن تحقيق ذلك باستخدام المَعلمة custom_map.

لإرسال مكوّن مخصّص إلى "إحصاءات Google"، عليك تعديل 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});

استبدِل 'GA_MEASUREMENT_ID' برقم تعريف"إحصاءات Google"الخاص بك.

على سبيل المثال، سيرسل المقتطف التالي المكوّن المخصص dimension2 بالقيمة 55 إلى "إحصاءات Google".

// 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"، عليك تعديل 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});

استبدِل 'GA_MEASUREMENT_ID' برقم تعريف "إحصاءات Google" الخاص بك.

على سبيل المثال، سيرسل المقتطف التالي المقياس المخصّص metric5 بالقيمة 1 إلى "إحصاءات Google".

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