ปลั๊กอิน Linker ช่วยลดความซับซ้อนของกระบวนการใช้งานการวัดผลแบบข้ามโดเมนตามที่อธิบายไว้ในคู่มือการวัดผลแบบข้ามโดเมนสําหรับ analytics.js
ภาพรวม
การวัดผลแบบข้ามโดเมนทํางานโดยการแชร์รหัสไคลเอ็นต์ที่ไม่ซ้ำกันระหว่างโดเมนต้นทางกับโดเมนปลายทาง กระบวนการนี้มี 2 ขั้นตอน ดังนี้
- โดเมนต้นทางต้องตรวจสอบว่า URL ทั้งหมดที่ชี้ไปยังโดเมนปลายทางมีรหัสไคลเอ็นต์ของโดเมนต้นทาง
- โดเมนปลายทางจำเป็นต้องทราบเพื่อตรวจสอบว่ามีรหัสไคลเอ็นต์อยู่ใน URL เมื่อผู้ใช้ไปถึง URL นั้นหรือไม่
ซึ่งปลั๊กอิน Linker ดำเนินการนี้ได้โดยการเพิ่มพารามิเตอร์ Linker ลงใน URL ที่ชี้ไปยังโดเมนปลายทาง พารามิเตอร์ Linker มีรหัสไคลเอ็นต์ รวมถึงการประทับเวลาปัจจุบันและข้อมูลเมตาของเบราว์เซอร์ที่เข้ารหัสไว้ ระบบจะใช้การประทับเวลาและข้อมูลเมตาเพื่อหลีกเลี่ยงปัญหาเกี่ยวกับการแชร์ URL
พารามิเตอร์ Linker จะมีลักษณะดังนี้
_ga=1.199239214.1624002396.1440697407
ในโดเมนปลายทางจะมีช่อง allowLinker
ซึ่งเมื่อ true
สั่งให้ analytics.js ตรวจหาพารามิเตอร์ Linker ใน URL หากพบพารามิเตอร์ Linker และถูกต้อง ระบบจะแยกรหัสไคลเอ็นต์ออกจากพารามิเตอร์และจัดเก็บไว้
ปลั๊กอิน Linker ช่วยให้เพิ่มพารามิเตอร์ Linker ใน URL ของลิงก์และแบบฟอร์มในหน้าเว็บได้ทั้งแบบแบบอัตโนมัติและด้วยตนเอง ในกรณีส่วนใหญ่ เราแนะนำให้ใช้วิธีอัตโนมัติ
การเพิ่มพารามิเตอร์ Linker โดยอัตโนมัติ
ในการตั้งค่าการลิงก์อัตโนมัติข้ามโดเมนในโดเมนต้นทางสำหรับ URL ที่ชี้ไปยังโดเมนปลายทาง คุณต้องrequireปลั๊กอิน Linker และเรียกเมธอด autoLink
ของ URL นั้น
autoLink
มีการเรียกใช้เมธอด autoLink
ผ่านคิวคำสั่ง
เมื่อเรียกใช้ analytics.js จะคอยฟังการคลิกลิงก์ที่ชี้ไปยังโดเมนปลายทาง (หรือโดเมน) และเพิ่มพารามิเตอร์ Linker ลงในลิงก์เหล่านั้นทันทีก่อนเริ่มการนำทาง การรอจนกว่าผู้ใช้จะคลิกลิงก์เพื่อเพิ่มพารามิเตอร์ Linker ได้ เนื่องจากพารามิเตอร์ Linker จะหมดอายุหลังจากผ่านไป 2 นาที
คุณควรระบุพารามิเตอร์ decorateForms
(ไม่บังคับ) และตั้งค่าเป็น true
หากคุณมีแบบฟอร์มในเว็บไซต์ที่ชี้ไปยังโดเมนปลายทาง
การใช้งาน
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
พารามิเตอร์
ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
---|---|---|---|
domains |
Array[RexExp|string] |
ใช่ | อาร์เรย์ของสตริงหรือนิพจน์ทั่วไปที่จะจับคู่กับ hostname ของ URL ซึ่งบ่งชี้ว่าควรใช้การลิงก์อัตโนมัติกับโดเมนใด หากส่งสตริง analytics.js จะดำเนินการจับคู่สตริงย่อย ซึ่งหมายความว่า example.com จะจับคู่ลิงก์ที่ชี้ไปยัง blog.example.com |
useAnchor |
boolean |
ไม่ | เมื่อเป็นจริง ระบบจะเพิ่มพารามิเตอร์ Linker ลงในส่วน Anchor ของ URL แทนที่จะเป็นส่วนการค้นหา |
decorateForms |
boolean |
ไม่ | เมื่อเป็นจริง ปลั๊กอิน Linker จะเพิ่มพารามิเตอร์ Linker ลงในการส่งแบบฟอร์มที่ชี้ไปยังปลายทางที่ตรงกับพารามิเตอร์ domain |
ตัวอย่าง
// Loads the Linker plugin
ga('require', 'linker');
// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);
การเพิ่มพารามิเตอร์ Linker ด้วยตนเอง
คุณเพิ่มพารามิเตอร์ Linker ลงในองค์ประกอบ <a>
หรือ <form>
ที่เฉพาะเจาะจงได้ด้วยตัวเองผ่านทางเมธอด decorate
วิธีนี้ต้องใช้เฉพาะในกรณีที่ไม่ได้ใช้เมธอด autoLink
ที่อธิบายไว้ข้างต้น
decorate
มีการเรียกใช้เมธอด decorate
ผ่านคิวคำสั่ง
ควรตรวจสอบว่ามีการเรียกใช้เมธอดการตกแต่งใกล้กับเวลาที่การนำทางจะเกิดขึ้นมากที่สุด เนื่องจากพารามิเตอร์ Linker จะหมดอายุหลังจากผ่านไป 2 นาที ส่วนใหญ่แล้วควรเรียกใช้เมธอดนี้ในเครื่องจัดการเหตุการณ์
การใช้งาน
ga('[trackerName.]linker:decorate', element, [useAnchor]);
พารามิเตอร์
ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
---|---|---|---|
element |
HTMLElement |
ใช่ | องค์ประกอบ <a> หรือ <form> ที่จะเพิ่มพารามิเตอร์ Linker ต่อท้าย |
useAnchor |
boolean |
ไม่ | เมื่อเป็นจริง ระบบจะเพิ่มพารามิเตอร์ Linker ลงในส่วน Anchor ของ URL แทนที่จะเป็นส่วนการค้นหา |
ตัวอย่าง
// Loads the Linker plugin
ga('require', 'linker');
// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');
// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
ga('linker:decorate', destinationLink);
});
linkerParam
นอกเหนือจากเมธอด decorate
แล้ว คุณยังสามารถดูพารามิเตอร์ Linker ที่เครื่องมือติดตามจะใช้ด้วยตนเองผ่านช่อง linkerParam
ได้
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
การกำหนดค่าเว็บไซต์ให้ยอมรับพารามิเตอร์ Linker
เมื่อผู้ใช้มาถึงหน้าเว็บในโดเมนปลายทางที่มีพารามิเตอร์ Linker ใน URL แล้ว analytics.js จะต้องทราบว่าจะต้องมองหาพารามิเตอร์นั้นหรือไม่
คุณสั่งให้หน้าปลายทางมองหาพารามิเตอร์ Linker ได้โดยตั้งค่าช่อง allowLinker
เป็น true
เมื่อสร้างเครื่องมือติดตาม ดังนี้
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
การวัดผลแบบข้ามโดเมนแบบ 2 ทิศทาง
โฟลว์ผู้ใช้ที่ผู้ใช้เริ่มต้นจากโดเมนต้นทางเสมอ และหลังจากนั้นจะย้ายไปยังโดเมนปลายทางในการวัดผลแบบข้ามโดเมนแบบทิศทางเดียว วิธีการข้างต้นจะถือว่าการไหลเวียนของผู้ใช้ประเภทนี้
ในกรณีที่ไม่ทราบว่าผู้ใช้จะเข้าถึงโดเมนใดก่อน คุณต้องใช้การวัดผลแบบข้ามโดเมนแบบ 2 ทิศทาง โดยกําหนดค่าให้แต่ละโดเมนทํางานเป็นต้นทางหรือปลายทาง
หากต้องการใช้การวัดผลแบบข้ามโดเมน 2 ทิศทาง ให้เปิดใช้การลิงก์อัตโนมัติในทั้ง 2 โดเมน และกําหนดค่าให้ทั้ง 2 โดเมนยอมรับพารามิเตอร์ Linker
ใน source.com
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
ใน destination.com
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
การใช้ข้อมูลโค้ดรายการเดียวกับทุกโดเมน
คุณระบุรายการโดเมนที่เป็นไปได้ทั้งหมดที่ต้องการวัดในเมธอด autoLink
เพื่อให้ใช้ข้อมูลโค้ดเดียวกันในทุกโดเมนได้เพื่อให้ดำเนินการได้ง่ายขึ้น
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);