การใช้งาน
สรุป
การใช้งานเครื่องมือวัด Conversion แบ่งออกเป็น 3 ส่วนดังนี้
-
การสะสม
rwg_token
จากหน้า Landing Page / จุดแรกเข้าของแอป -
รักษา
rwg_token
ไว้ สำหรับกรอบเวลาการระบุแหล่งที่มาที่เหมาะสม - การส่งเหตุการณ์ Conversion ที่จุดชำระเงิน
คุณไม่จำเป็นต้องใช้เครื่องมือวัด Conversion Google Analytics หรือ JavaScript ของบุคคลที่สามอื่นๆ
ก่อนที่จะเริ่มตั้งค่าเครื่องมือวัด Conversion คุณควรตัดสินใจ ถ้าคุณจะติดตาม Conversion ที่ระดับอุปกรณ์หรือระดับผู้ใช้ ให้ทำดังนี้
- ระดับอุปกรณ์รวมถึงการใช้คุกกี้ของเบราว์เซอร์ในเครื่อง พื้นที่เก็บข้อมูล พื้นที่เก็บข้อมูลในเครื่องของแอป หรือวิธีการอื่นๆ ที่สามารถคงอยู่ได้ โทเค็นสำหรับกรอบเวลาการระบุแหล่งที่มา 30 วัน เนื่องจากโทเค็น จะจัดเก็บไว้ในอุปกรณ์ของผู้ใช้ หากผู้ใช้มีการเปลี่ยนแปลง อุปกรณ์ที่ใช้ ล้างพื้นที่เก็บข้อมูล/คุกกี้ในเครื่อง หรือ เหตุการณ์ 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 ระดับอุปกรณ์ การจัดเก็บโทเค็นนี้ในเว็บเบราว์เซอร์โดยผ่านแท็ก 1 คุกกี้ปาร์ตี้ ตัวอย่างนี้ถือว่าคุณได้แยกวิเคราะห์ค่าโทเค็น ลงในตัวแปรตามตัวอย่างด้านบน หากต้องการใช้ตัวอย่างนี้ คุณจะต้องอัปเดต "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
เมื่อผู้ใช้ทำธุรกรรมซึ่งระบุแหล่งที่มาว่ามาจาก คุณต้องส่งคำขอ 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
หากโทเค็นจัดเก็บที่ระดับอุปกรณ์เท่านั้น เช่น คุกกี้ของเบราว์เซอร์ คุณไม่น่าจะให้บริการข้ามอุปกรณ์ การระบุแหล่งที่มา ในกรณีนี้ อุปกรณ์แต่ละเครื่องจะมีโทเค็นแยกกัน ยังคงอยู่หากผู้ใช้คลิกลิงก์การดำเนินการในอุปกรณ์นั้น และ อุปกรณ์แต่ละเครื่องจะเป็นไปตามกฎการระบุแหล่งที่มาที่แยกจากกัน