มิติข้อมูลและเมตริกที่กําหนดเองที่ใช้ gtag.js

นักพัฒนาเว็บสามารถใช้มิติข้อมูลและเมตริกที่กำหนดเองเพื่อแบ่งกลุ่มและวัดความแตกต่างระหว่างผู้ใช้ที่ลงชื่อเข้าใช้และออกจากระบบ ผู้เขียนหน้าเว็บ หรือระดับในเกม หน้านี้จะอธิบายวิธีส่งมิติข้อมูลและเมตริกที่กำหนดเองไปยัง Google Analytics

หากต้องการส่งค่าของพารามิเตอร์ที่กําหนดเองไปยัง Google Analytics ให้แมปพารามิเตอร์กับพารามิเตอร์มิติข้อมูลหรือเมตริก Google Analytics ที่กําหนดเองต่อไปนี้

Custom parameter	ประเภทข้อมูล	คำอธิบาย
`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 ของคุณเอง

ตัวอย่างเช่น ข้อมูลโค้ดต่อไปนี้จะส่งมิติข้อมูลที่กำหนดเอง 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});

แทนที่ 'GA_MEASUREMENT_ID' ด้วยรหัส Analytics ของคุณเอง

ตัวอย่างเช่น ข้อมูลโค้ดต่อไปนี้จะส่งเมตริกที่กำหนดเอง 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});