การใช้งาน
สรุป
การใช้เครื่องมือวัด 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 โดยไม่มีการแก้ไขใดๆ
นอกจาก rwg_token แล้ว คุณจะต้องจัดเก็บ merchant_id ที่เชื่อมโยงกับลิงก์การดำเนินการนั้นด้วย
หากมีโทเค็นเหลืออยู่จากการเข้าชมครั้งก่อน คุณควรแทนที่ rwg_token และ merchant_id ก่อนหน้านี้ และควรรีเซ็ตกรอบเวลา 30 วันสําหรับพื้นที่เก็บข้อมูล
เมื่อเก็บคู่ข้างต้นต่อ คุณอาจจัดเก็บค่าที่ระดับอุปกรณ์หรือที่ระดับผู้ใช้ ดังนี้
- ระดับอุปกรณ์จะรวมถึงการใช้คุกกี้ของเบราว์เซอร์ พื้นที่เก็บข้อมูลในเครื่อง พื้นที่เก็บข้อมูลในเครื่องของแอป หรือวิธีการอื่นๆ ที่สามารถเก็บโทเค็นไว้ได้ในกรอบเวลาการระบุแหล่งที่มา 30 วัน
- ระดับผู้ใช้รวมถึงการคงไว้ในฐานข้อมูลแอปพลิเคชันผ่านระบบการวิเคราะห์ฝั่งเซิร์ฟเวอร์หรือระบบฝั่งเซิร์ฟเวอร์อื่นๆ
ด้านล่างนี้เป็นตัวอย่างของเครื่องมือวัด Conversion ระดับอุปกรณ์ ซึ่งจัดเก็บค่าเหล่านี้ในเว็บเบราว์เซอร์โดยใช้คุกกี้ของบุคคลที่หนึ่ง ตัวอย่างนี้สมมติว่าคุณได้แยกวิเคราะห์ค่าโทเค็น เป็นตัวแปรตามตัวอย่างด้านบน หากต้องการใช้ตัวอย่างนี้ คุณต้องอัปเดต "rootdomain" เป็นโดเมนของคุณ
<script>
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id="+merchantid +";max-age=2592000;domain=rootdomain.com;path=/";
}
</script>
เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ คุณควรเก็บ rwg_token + seller_id ไว้ในเซิร์ฟเวอร์และเชื่อมโยงกับผู้ใช้
การส่งข้อมูล Conversion
เมื่อผู้ใช้ทำธุรกรรมเสร็จสิ้นซึ่งเกิดจากลิงก์ "Google Place Action" คุณต้องส่งคำขอ 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>
"merchant_changed": 1|2
}
ระบบจะใช้ค่า Merchant_changed เพื่อระบุว่าผู้ขายมีการเปลี่ยนแปลงจากผู้ขายการเปลี่ยนเส้นทางเริ่มต้นหรือไม่ มี 2 ค่าที่ส่งได้
| ค่าการเปลี่ยนแปลงจากผู้ขาย | ข้อกำหนด |
|---|---|
| 1 | ควรใช้ค่านี้เมื่อผู้ใช้ออกจากเว็บไซต์ของผู้ขายเดิมและทำการซื้อผ่านแพลตฟอร์มของคุณกับผู้ขายรายอื่น |
| 2 | ควรใช้ค่านี้เมื่อลูกค้าทำธุรกรรมผ่านนิติบุคคลเดิม (ผู้ขาย) เสร็จสมบูรณ์ |
ทั้งในสภาพแวดล้อมแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริง คุณต้องระบุ rwg_token ที่ถูกต้องเมื่อส่งเหตุการณ์ Conversion สำหรับการทดสอบ ให้ใช้โทเค็นทดสอบต่อไปนี้ในทั้ง 2 สภาพแวดล้อมจนกว่าคุณจะเปิดตัว
ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==
ตัวอย่างแบบเต็มของเครื่องมือวัด 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,
Merchant_changed: merchantChanged
})
});
}
เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ คุณควรเรียกโทเค็นที่เชื่อมโยงกับผู้ใช้ (ไม่ว่าจะอยู่บนแพลตฟอร์มใด) จากกลไกพื้นที่เก็บข้อมูลฝั่งเซิร์ฟเวอร์ และส่งโทเค็นโดยใช้ปลายทางที่ใช้งานจริงหรือปลายทางแซนด์บ็อกซ์เดียวกัน
ข้อกําหนดการระบุแหล่งที่มาของ Conversion
มาตรฐานที่ Google กำหนดไว้สำหรับการระบุแหล่งที่มา Conversion คือกรอบเวลาการระบุแหล่งที่มา 30 วันสำหรับการโต้ตอบกับลิงก์สถานที่ที่ร้านใดก็ได้
กรอบเวลาการระบุแหล่งที่มานี้หมายความว่า Google ต้องการให้ส่งเหตุการณ์ Conversion ในสถานการณ์ต่อไปนี้
- ผู้ใช้ไปตามลิงก์การดำเนินการเกี่ยวกับสถานที่และสั่งซื้อของผู้ขายรายเดียวกัน ในเซสชันเดียวกัน(ค่าการเปลี่ยนแปลงของผู้ขาย = 2)
- ผู้ใช้ติดตามลิงก์การดำเนินการเกี่ยวกับสถานที่แล้วกลับมาจากช่องอื่นภายในกรอบเวลา 30 วันเพื่อสั่งซื้อจากผู้ขายรายเดียวกัน ( มูลค่าการเปลี่ยนแปลงของผู้ขาย = 2 )
- ผู้ใช้ติดตามลิงก์การดำเนินการเกี่ยวกับสถานที่แล้วสั่งซื้อที่ร้านค้าอื่น ไม่ว่าจะภายในเซสชันเดียวกันหรือเซสชันอื่นภายในกรอบเวลา 30 วัน ( ค่าการเปลี่ยนแปลงของผู้ขาย = 1 )
นอกจากนี้ Google ยังคาดหวังให้ส่งเหตุการณ์ Conversion จากทุกแพลตฟอร์มที่ผู้ใช้เข้าถึงจากลิงก์การดําเนินการเกี่ยวกับสถานที่ได้ ได้แก่
- เว็บแอปพลิเคชันบนเดสก์ท็อปหรือบนอุปกรณ์เคลื่อนที่
- แอปบนอุปกรณ์เคลื่อนที่ ไม่ว่าจะผ่าน Deep Link ของแอปหรือความตั้งใจของแอปที่ลงทะเบียนไว้สำหรับโดเมนของคุณ
หากโทเค็นจัดเก็บที่ระดับผู้ใช้ (ดูโทเค็นการใช้งานต่อเนื่อง) แสดงว่าคุณใช้การระบุแหล่งที่มาข้ามอุปกรณ์ได้ กล่าวคือ ผู้ใช้ที่ไปตามลิงก์การดำเนินการจากเดสก์ท็อปแล้วทำธุรกรรมบนอุปกรณ์เคลื่อนที่จนเสร็จสมบูรณ์ (โดยใช้บัญชีผู้ใช้เดียวกัน) ควรทริกเกอร์เหตุการณ์ Conversion
หากโทเค็นได้รับการจัดเก็บที่ระดับอุปกรณ์เพียงอย่างเดียว เช่น ในคุกกี้ของเบราว์เซอร์ ก็ไม่จำเป็นต้องระบุการระบุแหล่งที่มาข้ามอุปกรณ์ ในกรณีนี้ อุปกรณ์แต่ละเครื่องจะมีโทเค็นแยกต่างหากอยู่หากผู้ใช้คลิกลิงก์การดำเนินการในอุปกรณ์นั้น และอุปกรณ์แต่ละเครื่องจะทำตามกฎการระบุแหล่งที่มาแยกกัน