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

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

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

Custom parameter	ประเภทข้อมูล	คำอธิบาย
dimension<Index>	string	พารามิเตอร์มิติข้อมูลที่กําหนดเอง (เช่น dimension3)
metric<Index>	string	พารามิเตอร์เมตริกที่กําหนดเอง (เช่น metric8)

หมายเหตุ: เมื่อตั้งชื่อพารามิเตอร์ที่กําหนดเอง หลีกเลี่ยงการใช้ชื่อเดียวกับพารามิเตอร์การกําหนดค่า GA4

กําหนดค่าและส่งมิติข้อมูลที่กําหนดเอง

หากต้องการส่งค่าพารามิเตอร์ที่กําหนดเองไปยัง 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});