ตัวลิงก์

ปลั๊กอิน Linker ช่วยลดความซับซ้อนของกระบวนการใช้งานการวัดผลแบบข้ามโดเมนตามที่อธิบายไว้ในคู่มือการวัดผลแบบข้ามโดเมนสําหรับ analytics.js

ภาพรวม

การวัดผลแบบข้ามโดเมนทํางานโดยการแชร์รหัสไคลเอ็นต์ที่ไม่ซ้ำกันระหว่างโดเมนต้นทางกับโดเมนปลายทาง กระบวนการนี้มี 2 ขั้นตอน ดังนี้

  1. โดเมนต้นทางต้องตรวจสอบว่า URL ทั้งหมดที่ชี้ไปยังโดเมนปลายทางมีรหัสไคลเอ็นต์ของโดเมนต้นทาง
  2. โดเมนปลายทางจำเป็นต้องทราบเพื่อตรวจสอบว่ามีรหัสไคลเอ็นต์อยู่ใน 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 ผ่านคิวคำสั่ง

เมื่อเรียกใช้ 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']);