การใช้งาน
สรุป
การใช้เครื่องมือวัด Conversion ประกอบด้วย 3 ส่วน ได้แก่
-
การรวบรวม
rwg_token
จากหน้า Landing Page / จุดแรกเข้าของแอป -
คง
rwg_token
ไว้สำหรับกรอบเวลาการระบุแหล่งที่มาที่เหมาะสม - การส่งเหตุการณ์ Conversion ที่จุดชำระเงิน
การติดตั้งใช้งานเครื่องมือวัด Conversion นี้ไม่ได้กำหนดให้คุณใช้ Google Analytics หรือ JavaScript ของบุคคลที่สามอื่นๆ
ก่อนที่จะเริ่มดำเนินการติดตั้งใช้งานเครื่องมือวัด Conversion คุณควรตัดสินใจก่อนว่าจะติดตาม Conversion ที่ระดับอุปกรณ์หรือระดับผู้ใช้
- ระดับอุปกรณ์รวมถึงการใช้คุกกี้ของเบราว์เซอร์ พื้นที่เก็บข้อมูลในเครื่อง พื้นที่เก็บข้อมูลในเครื่องของแอป หรือวิธีการอื่นๆ ที่สามารถเก็บโทเค็นได้ตลอดกรอบเวลาการระบุแหล่งที่มา 30 วัน เนื่องจากระบบจะจัดเก็บโทเค็นไว้ในอุปกรณ์ของผู้ใช้ หากผู้ใช้เปลี่ยนอุปกรณ์ที่ใช้ ล้างพื้นที่เก็บข้อมูล/คุกกี้ในเครื่อง หรือใช้การท่องเว็บแบบส่วนตัวหรือโหมดไม่ระบุตัวตนอยู่ เหตุการณ์ Conversion จึงอาจไม่ได้รับการระบุแหล่งที่มาอย่างถูกต้อง เมื่อใช้เครื่องมือวัด Conversion ระดับอุปกรณ์ คุณต้องใช้เครื่องมือนี้อีกครั้งในทุกแพลตฟอร์มที่รองรับ (รวมถึงอุปกรณ์เคลื่อนที่)
- ระดับผู้ใช้จะรวมถึงการคงไว้ในฐานข้อมูลแอปพลิเคชันผ่านระบบการวิเคราะห์ฝั่งเซิร์ฟเวอร์หรือระบบฝั่งเซิร์ฟเวอร์อื่นๆ เนื่องจากระบบจะจัดเก็บโทเค็นไว้ที่ฝั่งเซิร์ฟเวอร์ หากผู้ใช้เปลี่ยนอุปกรณ์ที่ใช้ ล้างพื้นที่เก็บข้อมูล/คุกกี้ในเครื่อง หรือใช้การเรียกดูแบบส่วนตัวหรือโหมดไม่ระบุตัวตน เหตุการณ์ Conversion จะยังคงได้รับการระบุแหล่งที่มาเมื่อผู้ใช้เข้าสู่ระบบอีกครั้ง เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ คุณอาจติดตั้งใช้งานเครื่องมือวัด Conversion นี้เพียงครั้งเดียวในฝั่งเซิร์ฟเวอร์และใช้ซ้ำได้ในทุกแพลตฟอร์มที่รองรับ ทั้งนี้ขึ้นอยู่กับสถาปัตยกรรมของระบบ
กำลังรวบรวม rwg_token
ทุกครั้งที่ Google แสดง action_link
ที่คุณระบุไว้ผ่านฟีด ระบบจะแก้ไข URL ดังกล่าวให้มีพารามิเตอร์การค้นหาที่ไม่ซ้ำกัน: rwg_token
ค่า rwg_token
เป็นสตริงที่เข้ารหัสซึ่งมีข้อมูลเมตาบางอย่างเกี่ยวกับลิงก์ที่ผู้ใช้คลิก คุณจะต้องจัดเก็บโทเค็นนี้และส่งกลับมาเป็นส่วนหนึ่งของเหตุการณ์ Conversion
ในหน้า Landing Page / จุดแรกเข้าของแอปแต่ละจุด คุณต้องแยกวิเคราะห์ชุดค่าสำหรับพารามิเตอร์การค้นหา rwg_token
และจัดเก็บไว้ ข้อกำหนดสำหรับการจัดเก็บพารามิเตอร์นี้จะอธิบายไว้ในขั้นตอนที่ใช้ rwg_token
ด้านล่างนี้คือตัวอย่างวิธีแยกวิเคราะห์โทเค็นนี้สำหรับการติดตามระดับอุปกรณ์ผ่านเบราว์เซอร์ หรือจะรวบรวมโทเค็นนี้ที่ฝั่งเซิร์ฟเวอร์เมื่อตอบกลับคำขอก็ได้
<script> var query = location.search.substring(1); var params = query.split('&'); var rwgToken = undefined; for (var i = 0; i < params.length; ++i) { var pair = params[i].split('='); if (pair[0] == 'rwg_token') { rwgToken = decodeURIComponent(pair[1]); break; } } </script>
การยืนยัน rwg_token
ต่อไป
คุณจะต้องคงพารามิเตอร์ของ URL rwg_token
ไว้ ซึ่งจะนำไปต่อท้ายลิงก์การดำเนินการทั้งหมดที่คุณระบุ เป็นระยะเวลารวม 30 วัน ควรจัดเก็บและแสดงผลค่าของ rwg_token
โดยไม่มีการแก้ไขใดๆ
หากมีโทเค็นเหลืออยู่จากการเข้าชมครั้งก่อน คุณควรเปลี่ยนโทเค็นเก่าและควรรีเซ็ตกรอบเวลา 30 วันสำหรับพื้นที่เก็บข้อมูล
เมื่อยืนยันโทเค็น คุณจะจัดเก็บโทเค็นไว้ที่ระดับอุปกรณ์หรือที่ระดับผู้ใช้ก็ได้ โดยทำดังนี้
- ระดับอุปกรณ์รวมถึงการใช้คุกกี้ของเบราว์เซอร์ พื้นที่เก็บข้อมูลในเครื่อง พื้นที่เก็บข้อมูลในเครื่องของแอป หรือวิธีการอื่นๆ ที่เก็บรักษาโทเค็นได้สำหรับกรอบเวลาการระบุแหล่งที่มา 30 วัน
- ระดับผู้ใช้จะรวมถึงการคงไว้ในฐานข้อมูลแอปพลิเคชันผ่านระบบการวิเคราะห์ฝั่งเซิร์ฟเวอร์หรือระบบฝั่งเซิร์ฟเวอร์อื่นๆ
ด้านล่างคือตัวอย่างของเครื่องมือวัด Conversion ระดับอุปกรณ์ ซึ่งจัดเก็บโทเค็นนี้ในเว็บเบราว์เซอร์ผ่านคุกกี้ของบุคคลที่หนึ่ง ตัวอย่างนี้สมมติว่าคุณได้แยกวิเคราะห์ค่าโทเค็นเป็นตัวแปรตามตัวอย่างด้านบน หากต้องการใช้ตัวอย่างนี้ คุณจะต้องอัปเดต "rootdomain" เป็นโดเมน
<script> if (typeof rwg_token !== 'undefined') { document.cookie = "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/"; } </script>
เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ ควรจัดเก็บ rwg_token
ไว้บนเซิร์ฟเวอร์และเชื่อมโยงกับผู้ใช้
การส่งข้อมูล Conversion
เมื่อผู้ใช้ทำธุรกรรมเสร็จสิ้นซึ่งมาจากลิงก์การดำเนินการใน Google Place คุณต้องส่งคำขอ HTTP POST ไปยังปลายทาง Conversion โดยมีปลายทาง 2 รายการ ที่แรกสำหรับสภาพแวดล้อมที่ใช้งานจริงและอีกจุดหนึ่งสำหรับสภาพแวดล้อมแซนด์บ็อกซ์
- เวอร์ชันที่ใช้งานจริง:
https://www.google.com/maps/conversion/collect
- แซนด์บ็อกซ์:
https://www.google.com/maps/conversion/debug/collect
เนื้อหาของโพสต์ควรเป็นออบเจ็กต์ที่เข้ารหัส JSON ในรูปแบบต่อไปนี้
{ 'conversion_partner_id': partnerId, 'rwg_token': <rwg_token_val> }
ทั้งในสภาพแวดล้อมแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริง คุณจะต้องระบุ rwg_token
ที่ถูกต้องเมื่อส่งเหตุการณ์ Conversion
สำหรับการทดสอบในสภาพแวดล้อมแซนด์บ็อกซ์ คุณสามารถใช้โทเค็นทดสอบต่อไปนี้
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
ตัวอย่างแบบเต็มของเครื่องมือวัด Conversion ระดับอุปกรณ์ (การใช้คุกกี้ในอุปกรณ์ของผู้ใช้) ใน JavaScript ของวิธีส่งคำขอโพสต์นี้มีดังนี้
const partnerId = XXXXXXXXXX; const endpoint = `https://www.google.com/maps/conversion/collect`; const rwgTokenCookie = document.cookie .split('; ') .find(row => row.startsWith('_rwg_token=')); if (typeof rwgTokenCookie !== 'undefined') { const rwgTokenVal = rwgTokenCookie.split('=')[1]; fetch(endpoint, { method: "POST", body: JSON.stringify({ conversion_partner_id: partnerId, rwg_token: rwgTokenVal }) }); }
เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ คุณควรเรียกโทเค็นที่เชื่อมโยงกับผู้ใช้ (ไม่ว่าผู้ใช้จะอยู่ที่แพลตฟอร์มใด) จากกลไกพื้นที่เก็บข้อมูลฝั่งเซิร์ฟเวอร์ และส่งโทเค็นโดยใช้ปลายทางที่ใช้งานจริงหรือแซนด์บ็อกซ์เดียวกัน
ข้อกําหนดการระบุแหล่งที่มาของ Conversion
มาตรฐานที่ Google กําหนดสําหรับการระบุแหล่งที่มาของ Conversion คือกรอบเวลาการระบุแหล่งที่มา 30 วันสําหรับการโต้ตอบกับลิงก์สถานที่ในร้านค้าใดก็ได้
กรอบเวลาการระบุแหล่งที่มานี้หมายความว่าเราคาดว่าจะส่งเหตุการณ์ Conversion ในสถานการณ์ต่อไปนี้
- ผู้ใช้ติดตามลิงก์การดำเนินการเกี่ยวกับสถานที่และสั่งซื้อในเซสชันเดียวกัน
- ผู้ใช้ติดตามลิงก์การดำเนินการเกี่ยวกับสถานที่แล้วกลับมาจาก ช่องทางอื่นภายในกรอบเวลา 30 วันเพื่อสั่งซื้อ
- ผู้ใช้ติดตามลิงก์การดำเนินการเกี่ยวกับสถานที่แล้วสั่งซื้อที่ร้านค้าอื่น ไม่ว่าจะภายในเซสชันเดียวกันหรือเซสชันอื่นภายในกรอบเวลา 30 วัน
นอกจากนี้ เราคาดว่าจะส่งเหตุการณ์ Conversion จากทุกแพลตฟอร์มที่ผู้ใช้เข้าถึงจากลิงก์การดําเนินการเกี่ยวกับสถานที่ได้ ได้แก่
- เว็บแอปพลิเคชันบนเดสก์ท็อปหรือบนอุปกรณ์เคลื่อนที่
- แอปบนอุปกรณ์เคลื่อนที่ ไม่ว่าจะผ่าน Deep Link ของแอปหรือความตั้งใจของแอปที่ลงทะเบียนไว้สำหรับโดเมนของคุณ
หากโทเค็นจัดเก็บที่ระดับผู้ใช้ (ดูการใช้โทเค็น) คุณควรใช้การระบุแหล่งที่มาข้ามอุปกรณ์ กล่าวคือ ผู้ใช้ที่ติดตามลิงก์การดำเนินการจากเดสก์ท็อปแล้วทำธุรกรรมบนอุปกรณ์เคลื่อนที่จนเสร็จสมบูรณ์ (โดยใช้บัญชีผู้ใช้เดียวกัน) ควรทริกเกอร์เหตุการณ์ Conversion
หากเก็บโทเค็นไว้ที่ระดับอุปกรณ์เท่านั้น เช่น ในคุกกี้ของเบราว์เซอร์ คุณก็ไม่ควรระบุการระบุแหล่งที่มาข้ามอุปกรณ์ ในกรณีนี้ อุปกรณ์แต่ละเครื่องจะมีโทเค็นแยกต่างหากอยู่หากผู้ใช้คลิกลิงก์การดำเนินการในอุปกรณ์นั้น และอุปกรณ์แต่ละเครื่องจะใช้กฎการระบุแหล่งที่มาแยกกัน