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