מאפיינים ומדדים מותאמים אישית בעזרת 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});

מחליפים את 'GA_MEASUREMENT_ID' במזהה Analytics שלכם.

לדוגמה, קטע הקוד הבא ישלח ל-Google Analytics את המאפיין המותאם אישית dimension2 עם הערך 55:

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

מחליפים את 'GA_MEASUREMENT_ID' במזהה Analytics שלכם.

לדוגמה, קטע הקוד הבא ישלח ל-Google Analytics את המדד המותאם אישית metric5 עם הערך 1:

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