ภาพรวม
เครื่องมือวัด Conversion จะติดตาม Conversion ที่ Google เริ่มต้น
ผ่านการผสานรวมกับ Action Center อย่างใดอย่างหนึ่ง เครื่องมือนี้ช่วยให้การผสานรวมของคุณทำงานได้อย่างราบรื่นและมีประสิทธิภาพ เนื่องจากอาจส่งผลต่อการจัดอันดับในบางหน้า ทุกครั้งที่ Google สร้าง action_link ระบบจะแก้ไข URL ที่เฉพาะเจาะจงให้มีพารามิเตอร์การค้นหาที่ไม่ซ้ำกัน rwg_token คุณสามารถจัดเก็บโทเค็นและแสดงค่าที่เหมาะสมเมื่อผู้ใช้ทำการจองเสร็จสมบูรณ์
ทำตามขั้นตอนต่อไปนี้เพื่อผสานรวมให้เสร็จสมบูรณ์
- แยกวิเคราะห์และจัดเก็บ
rwg_token - แยกวิเคราะห์และจัดเก็บข้อมูลผู้ขาย
- แสดง
rwg_tokenและค่าmerchant_changed - ทดสอบและยืนยันเครื่องมือวัด Conversion
แยกวิเคราะห์และจัดเก็บ rwg_token
หากต้องการผสานรวมให้เสร็จสมบูรณ์ คุณต้องรวบรวมและจัดเก็บ rwg_token ไว้เป็นเวลาสูงสุด 30 วันนับจากการแนะนำลูกค้าครั้งแรกจาก Google ค่า rwg_token คือสตริงที่เข้ารหัส ซึ่งมีข้อมูลเมตาเกี่ยวกับลิงก์และข้อมูลผู้ขายที่สร้าง action_link นั้น
แยกวิเคราะห์โทเค็น
เมื่อระบบนำผู้ใช้ไปยังหน้าการจองของคุณ ระบบจะเพิ่ม rwg_token ใหม่ต่อท้าย URL ที่ระบุ คุณต้องแยกวิเคราะห์ค่าโทเค็นในหน้าการจอง
ตัวอย่างต่อไปนี้แสดงวิธีแยกวิเคราะห์ rwg_token เพื่อการติดตามระดับอุปกรณ์ผ่านเบราว์เซอร์
const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;
จัดเก็บโทเค็น
เมื่อจัดเก็บ rwg_token คุณจะติดตั้งใช้งานเครื่องมือวัด Conversion ได้ 2 ระดับที่แตกต่างกัน ดังนี้
- ระดับอุปกรณ์
- ระดับผู้ใช้
คุณจัดเก็บโทเค็นได้ทุกระดับ แต่ต้องจัดเก็บโทเค็นไว้ 30 วันหลังจากการแนะนำลูกค้าครั้งแรก
ตัวอย่างต่อไปนี้แสดงเครื่องมือวัด Conversion ระดับอุปกรณ์ คุณสามารถจัดเก็บค่าโทเค็นในเบราว์เซอร์ด้วยคุกกี้บุคคลที่หนึ่ง ตัวอย่างนี้ถือว่าคุณได้แยกวิเคราะห์ค่าโทเค็นเป็นตัวแปรแล้ว อย่าลืมอัปเดต rootdomain.com ด้วยโดเมนของคุณ
if (rwgToken !== undefined) {
document.cookie =
"_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}
ทุกครั้งที่ Google สร้าง action_link ที่คุณระบุผ่านฟีด ระบบจะแก้ไข URL ให้มีพารามิเตอร์การค้นหาที่ไม่ซ้ำกัน rwg_token คุณต้องจัดเก็บโทเค็นนี้และส่งกลับเป็นส่วนหนึ่งของเหตุการณ์ Conversion
จัดเก็บที่ระดับอุปกรณ์
ระดับอุปกรณ์รวมถึงการใช้คุกกี้ของเบราว์เซอร์ ที่เก็บข้อมูลในเครื่อง ที่เก็บข้อมูลในเครื่องของแอป หรือวิธีการอื่นๆ ที่สามารถเก็บโทเค็นไว้ได้ตลอดกรอบเวลาการระบุแหล่งที่มา 30 วัน ระบบจะจัดเก็บโทเค็นไว้ในอุปกรณ์ของผู้ใช้ ดังนั้น เหตุการณ์ Conversion จึงระบุแหล่งที่มาได้อย่างไม่ถูกต้องในกรณีต่อไปนี้
- ผู้ใช้เปลี่ยนอุปกรณ์ที่ใช้
- ผู้ใช้ล้างที่เก็บข้อมูลในเครื่องหรือคุกกี้
- ผู้ใช้ใช้เบราว์เซอร์แบบส่วนตัวหรือไม่ระบุตัวตน
เมื่อใช้เครื่องมือวัด Conversion ระดับอุปกรณ์ คุณต้องติดตั้งใช้งานเหตุการณ์ Conversion อีกครั้งในทุกอุปกรณ์ที่รองรับ ซึ่งรวมถึงอุปกรณ์เคลื่อนที่
จัดเก็บที่ระดับผู้ใช้
ระดับผู้ใช้จะเก็บโทเค็นไว้ในฐานข้อมูลแอปพลิเคชันของคุณผ่านระบบวิเคราะห์ฝั่งเซิร์ฟเวอร์หรือระบบอื่นๆ ฝั่งเซิร์ฟเวอร์ ระบบจะจัดเก็บโทเค็นไว้ฝั่งเซิร์ฟเวอร์ ดังนั้น เหตุการณ์ Conversion จึงยังคงระบุแหล่งที่มาได้อย่างถูกต้องหลังจากที่ผู้ใช้เข้าสู่ระบบอีกครั้ง
เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ตามสถาปัตยกรรมระบบ คุณสามารถติดตั้งใช้งานเหตุการณ์ Conversion เพียงครั้งเดียวในฝั่งเซิร์ฟเวอร์และนำไปใช้ซ้ำในอุปกรณ์ที่รองรับทั้งหมด
รีเฟรชโทเค็น
เมื่อ Google แนะนำผู้ใช้ไปยังผู้ขายรายเดิม ระบบจะแทนที่โทเค็นที่มีอยู่ซึ่งจัดเก็บไว้แล้วด้วยโทเค็นใหม่จากการแนะนำลูกค้าครั้งล่าสุด หลังจากแทนที่โทเค็นแล้ว กรอบเวลาการระบุแหล่งที่มา 30 วันของการจัดเก็บโทเค็นจะรีเซ็ต และระบบจะระบุแหล่งที่มาของ Conversion ใหม่สำหรับผู้ขายรายนี้เป็นโทเค็นล่าสุด
ดูรายละเอียดเพิ่มเติมได้ที่ข้อกำหนดสำหรับการระบุแหล่งที่มาของ Conversionสำหรับ
แยกวิเคราะห์และจัดเก็บข้อมูลผู้ขาย
เมื่อระบบนำผู้ใช้ไปยังหน้าการจองของคุณ คุณต้องติดตั้งใช้งานตรรกะที่สามารถค้นหาและบันทึกรายละเอียดผู้ขายได้ โดยปกติแล้ว พาร์ทเนอร์จะเพิ่มข้อมูลเมตาของผู้ขายหรือ merchant_id ลงใน Action Link และใช้ข้อมูลดังกล่าวเพื่อระบุและจัดเก็บข้อมูลผู้ขาย
เราขอแนะนำให้คุณจัดเก็บ merchant_id หรือตัวระบุที่เลือกไว้พร้อมกับ rwg_token เมื่อผู้ใช้ยืนยันการจอง คุณสามารถอ้างอิงถึงผู้ขายก่อนที่จะส่งคำขอ Conversion ที่สมบูรณ์ เช่นเดียวกับการจัดเก็บโทเค็น คุณต้อง บันทึกรายละเอียดผู้ขายพร้อมกับโทเค็นไว้ 30 วันหลังจากการแนะนำลูกค้าครั้งแรก
ตัวอย่างต่อไปนี้แสดงการแก้ไข rwg_token ที่จัดเก็บไว้ก่อนหน้านี้ โดยถือว่าคุณได้แยกวิเคราะห์ข้อมูลผู้ขายจากข้อมูลเมตาใน URL ที่ระบุ และบันทึกข้อมูลดังกล่าวเป็น merchant_id หรือจับคู่กับ merchant_id ที่มีอยู่
// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
document.cookie =
"_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}
แสดง rwg_token และค่า merchant_changed
เมื่อผู้ใช้ทำการจองที่เริ่มต้นจากการแนะนำลูกค้าผ่าน action_link เสร็จสมบูรณ์ คุณต้องส่งคำขอ HTTP POST ไปยังปลายทาง Conversion โดยมีปลายทาง 2 รายการ ดังนี้
- สภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์: https://www.google.com/maps/conversion/collect
- สภาพแวดล้อมแซนด์บ็อกซ์: https://www.google.com/maps/conversion/debug/collect
เมื่อส่งเหตุการณ์ Conversion คุณต้อง ใส่ rwg_token ที่จัดเก็บไว้และค่า merchant_changed เป็น 1 หรือ 2 ดูรายละเอียดเพิ่มเติมเกี่ยวกับ
merchant_changed ได้ที่แสดงค่าการเปลี่ยนแปลงผู้ขาย
เนื้อหาของคำขอ POST ต้องเป็นออบเจ็กต์ที่เข้ารหัส JSON ในรูปแบบต่อไปนี้
{
"conversion_partner_id": "<partnerId>",
"rwg_token": "<rwg_token_val>",
"merchant_changed": "1|2"
}
{
"conversion_partner_id": "XXXXXXX",
"rwg_token": "AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg==",
"merchant_changed": "2"
}
ตัวอย่างต่อไปนี้แสดงเครื่องมือวัด Conversion ระดับอุปกรณ์พร้อมคุกกี้ในอุปกรณ์ของผู้ใช้ ซึ่งเขียนด้วย JavaScript
const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;
// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;
// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
fetch(endpoint, {
method: "POST",
body: JSON.stringify({
conversion_partner_id: partnerId,
rwg_token: decodeURIComponent(storedRwgToken),
merchant_changed: merchantChanged
})
});
}
แสดงค่าการเปลี่ยนแปลงผู้ขาย
ค่า merchant_changed ใช้เพื่อระบุว่าผู้ขายมีการเปลี่ยนแปลงจากผู้ขายที่เปลี่ยนเส้นทางครั้งแรกหรือไม่ การเปลี่ยนแปลงผู้ขายเป็นเรื่องปกติหากหน้า Landing Page ของคุณอยู่ในแพลตฟอร์มที่มีผู้ขายรายอื่น ในกรณีนี้ หาก Google แนะนำผู้ใช้ไปยังแพลตฟอร์มของคุณและผู้ใช้ตัดสินใจไปยังผู้ขายรายอื่นเพื่อทำการจองให้เสร็จสมบูรณ์ คุณจำเป็นต้องทราบว่าเกิด Conversion กับผู้ขายรายอื่น คุณสามารถใช้ค่าบูลีนเพื่อระบุการเปลี่ยนแปลงผู้ขาย แต่ไม่สามารถระบุรายละเอียดผู้ขายได้
เมื่อตัดสินใจว่าจะกำหนดค่าใดให้กับ merchant_changed คุณต้องใช้
ผู้ขายเดิมที่บันทึกไว้ใน
ส่วนแยกวิเคราะห์และจัดเก็บข้อมูลผู้ขาย ตรวจสอบว่าผู้ขายมีการเปลี่ยนแปลงหรือไม่ และกำหนดค่าตามความต้องการ
- ข้อกำหนด: เมื่อผู้ใช้ออกจากเว็บไซต์ของผู้ขายเดิมและ
ทำการซื้อผ่านแพลตฟอร์มของคุณกับผู้ขายรายอื่น
- ค่าการเปลี่ยนแปลงผู้ขาย:
1
- ค่าการเปลี่ยนแปลงผู้ขาย:
- ข้อกำหนด: เมื่อผู้ใช้ทำธุรกรรมผ่านผู้ขายเดิม
- ค่าการเปลี่ยนแปลงผู้ขาย:
2
- ค่าการเปลี่ยนแปลงผู้ขาย:
ทดสอบและยืนยันเครื่องมือวัด Conversion
กรณีทดสอบต่อไปนี้ใช้โทเค็นทดสอบที่ระบุไว้ใน
ส่วนโทเค็นทดสอบ และมีวัตถุประสงค์เพื่อช่วยแนะนำคุณเกี่ยวกับ
สถานการณ์ต่างๆ ที่อาจส่งผลให้เกิดเหตุการณ์ Conversion ซึ่งจะช่วยให้มั่นใจได้ว่าระบบจะจัดเก็บโทเค็นอย่างเหมาะสม ตั้งค่า merchant_changed อย่างถูกต้อง และส่งเหตุการณ์ Conversion เมื่อเหมาะสม
ใช้ URL ของลิงก์การดำเนินการ หรือหน้าการจองที่ระบุไว้ในฟีด และเรียกใช้กรณีทดสอบแต่ละกรณีโดยการเพิ่มโทเค็นทดสอบต่อท้าย URL อย่าลืมใช้หน้าต่างเบราว์เซอร์แบบส่วนตัวหรือไม่ระบุตัวตน ซึ่งจะล้างโทเค็นที่มีอยู่ซึ่งเชื่อมโยงกับผู้ใช้ปัจจุบันและให้คุณเริ่มต้นใหม่ได้
| กรณีทดสอบ | คำอธิบายการทดสอบ | User Flow | ผลลัพธ์ที่คาดหวัง |
|---|---|---|---|
| 1 | ผู้ใช้ทำการจองที่ไม่ได้เริ่มต้นจาก Google | ผู้ใช้ไปยังหน้าการจองโดยตรงโดยที่ Google ไม่ได้แนะนำหรือไม่มีการแนะนำลูกค้าที่มีอยู่ ซึ่งไม่ควรส่งผลให้เกิดเหตุการณ์ Conversion | ไม่มีเหตุการณ์ Conversion เนื่องจากผู้ใช้ไม่ได้เข้าชมหน้าการจองก่อนหน้านี้หรือ Google ไม่ได้แนะนำ |
| 2 | ผู้ใช้ทำการจองที่เริ่มต้นจาก Google | ผู้ใช้พบผู้ขายของคุณผ่าน Google, ได้รับการแนะนำไปยังหน้าการจอง และทำการจองให้เสร็จสมบูรณ์ | ระบบจะส่งเหตุการณ์ Conversion พร้อม โทเค็น A และค่า merchant changed เป็น 2 เนื่องจาก Google แนะนำผู้ใช้ไปยังหน้าการจอง |
| 3 | ผู้ใช้ (ที่มาจาก Google) เริ่มขั้นตอนการจอง แต่ยกเลิกเซสชันก่อนที่จะทำการจองเสร็จสมบูรณ์ หมายเหตุ: เปิดเซสชันนี้ไว้สำหรับการทดสอบ 4 และ 5 |
ผู้ใช้ได้รับการแนะนำไปยังหน้าการจอง แต่เซสชันสิ้นสุดลงและผู้ใช้ไม่ได้ทำการจองให้เสร็จสมบูรณ์ | ไม่มี Conversion เนื่องจากผู้ใช้ไม่ได้ทำการจองให้เสร็จสมบูรณ์ แต่ระบบควรจัดเก็บ โทเค็น B ไว้ 30 วัน |
| 4 | ผู้ใช้กลับมาที่หน้าการจองโดยไม่ได้มาจาก Google และทำการจองให้เสร็จสมบูรณ์ หมายเหตุ: URL ของขั้นตอนการจองต้องไม่มี rwg_token |
ผู้ใช้กลับมาที่หน้าการจองหลังจากการทดสอบ #4 ระบบควรจัดเก็บ โทเค็น B ไว้ 30 วัน และ Conversion ใดๆ ที่เกิดขึ้นในช่วง 30 วันนั้นควรแสดงเหตุการณ์ Conversion | ระบบจะส่งเหตุการณ์ Conversion พร้อม โทเค็น B และค่า merchant changed เป็น 2 เนื่องจากผู้ใช้กลับมาที่หน้าการจองหลังจากได้รับการแนะนำจาก Google ก่อนหน้านี้ |
| 5 | ผู้ใช้ทำการจองใหม่ที่เริ่มต้นจาก Google หลังจากการทดสอบ #4 | หากผู้ใช้กลับมาที่หน้าการจองโดยใช้การแนะนำลูกค้าจาก Google หลังจากได้รับการแนะนำลูกค้าจาก Google ก่อนหน้านี้ หน้าต่างการจัดเก็บ 30 วันจะรีเซ็ตและโทเค็นใหม่ โทเค็น C จะแทนที่โทเค็นเก่า โทเค็น B จากนั้นระบบจะระบุแหล่งที่มาของ Conversion ทั้งหมดในอนาคตเป็น โทเค็น C | ระบบจะส่งเหตุการณ์ Conversion พร้อม โทเค็น C และค่า merchant changed เป็น 2 เนื่องจากผู้ใช้ทำการจองเสร็จสมบูรณ์และโทเค็นใหม่แทนที่โทเค็นที่จัดเก็บไว้ก่อนหน้านี้ |
หากคุณมีแพลตฟอร์มที่ให้ผู้ใช้ชำระเงินกับผู้ขายรายอื่นได้ ให้ทดสอบดังนี้
| กรณีทดสอบ | คำอธิบายการทดสอบ | User Flow | ผลลัพธ์ที่คาดหวัง |
|---|---|---|---|
| 6 | Google แนะนำผู้ใช้ไปยังหน้าการจองของคุณและผู้ใช้ทำการจองกับผู้ขายรายอื่น | Google แนะนำผู้ใช้ไปยังหน้าการจองของคุณ ระบบใช้ โทเค็น A แต่ก่อนที่จะทำการจองให้เสร็จสมบูรณ์ ผู้ใช้จะไปยังหน้าอื่นและทำการจองกับผู้ขายรายอื่นที่ไม่ใช่ผู้ขายที่แนะนำครั้งแรก | ระบบจะส่งเหตุการณ์ Conversion เนื่องจากผู้ใช้ทำการจองที่เริ่มต้นจากการแนะนำลูกค้าจาก Google ด้วย โทเค็น A และค่า merchant changed เป็น 1 เนื่องจากผู้ใช้ทำการจองกับผู้ขายรายอื่นที่ไม่ใช่ผู้ขายที่แนะนำ |
ขณะทดสอบ ให้ส่งคำขอ HTTP POST ไปยังปลายทาง Conversion โดยมีปลายทาง 2 รายการ ดังนี้
- สภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์: https://www.google.com/maps/conversion/collect
- สภาพแวดล้อมแซนด์บ็อกซ์: https://www.google.com/maps/conversion/debug/collect
โทเค็นทดสอบ
หากต้องการทดสอบเครื่องมือวัด Conversion ให้เพิ่มโทเค็นทดสอบรายการใดรายการหนึ่งต่อไปนี้ต่อท้าย URL ของ Action Link หรือหน้าการจองที่คุณระบุไว้ในฟีด
โทเค็น A:
rwg_token=AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg%3D%3D
โทเค็น B:
rwg_token=AE37R_gte8WCEaytMalsIr9agWQRLuN8199RsVhU2WoRKRvcZ0eBTD8cFvnfUZh-GY0IvY-zjS3W9KWAmy3WDiWXbVvQRZyzMQ%3D%3D
โทเค็น C:
rwg_token=AE37R_jmAP-UgWNApkxwdlX5M2z1UBGuUzHZ63YWmRWeTjRJKxfSD1mzJ4joLnB11MHrBULuisjP-9I64LnBJDXyCc_CIJSCPg%3D%3D
เมื่อส่งเหตุการณ์ Conversion ที่สำเร็จ คุณจะเห็นเหตุการณ์เหล่านั้นรวมกันใน Action Center ในแดชบอร์ดเครื่องมือวัด Conversion
![]()
ข้อกำหนดสำหรับการระบุแหล่งที่มาของ Conversion
มาตรฐานที่กำหนดสำหรับการระบุแหล่งที่มาของ Conversion ของ Google คือกรอบเวลาการระบุแหล่งที่มา 30 วันสำหรับการโต้ตอบใดๆ กับลิงก์การดำเนินการเกี่ยวกับสถานที่ในร้านค้าใดก็ได้
กรอบเวลาการระบุแหล่งที่มานี้หมายความว่า Google คาดหวังว่าจะได้รับเหตุการณ์ Conversion ในสถานการณ์ต่อไปนี้
- ผู้ใช้คลิก Action Link ของสถานที่และสั่งซื้อจากผู้ขายรายเดียวกันในเซสชันเดียวกัน ค่าการเปลี่ยนแปลงผู้ขาย = 2
- ผู้ใช้คลิก Action Link ของสถานที่ จากนั้นกลับมาจากแชแนลอื่นภายในกรอบเวลาการระบุแหล่งที่มา 30 วันเพื่อสั่งซื้อจากผู้ขายรายเดียวกัน ค่าการเปลี่ยนแปลงผู้ขาย = 2
- ผู้ใช้คลิกลิงก์การดำเนินการเกี่ยวกับสถานที่ จากนั้นสั่งซื้อที่ร้านค้าอื่น ไม่ว่าจะอยู่ในเซสชันเดียวกันหรือเซสชันอื่นภายในกรอบเวลาการระบุแหล่งที่มา 30 วัน ค่าการเปลี่ยนแปลงผู้ขาย = 1
นอกจากนี้ Google คาดหวังว่าจะส่งเหตุการณ์ Conversion จากอุปกรณ์ใดก็ได้ที่ผู้ใช้เข้าถึงได้ผ่านลิงก์การดำเนินการเกี่ยวกับสถานที่ อุปกรณ์เหล่านี้ ได้แก่
- เว็บแอปพลิเคชันบนเดสก์ท็อปหรืออุปกรณ์เคลื่อนที่
- แอปบนอุปกรณ์เคลื่อนที่ ไม่ว่าจะผ่าน Deep Link ของแอปหรือ App-Intent ที่ลงทะเบียนไว้สำหรับโดเมนของคุณ
หากจัดเก็บโทเค็นไว้ที่ระดับผู้ใช้ ระบบคาดหวังให้คุณระบุแหล่งที่มาจากหลายอุปกรณ์ ดูข้อมูลเพิ่มเติมได้ที่ จัดเก็บที่ระดับผู้ใช้ ในกรณีนี้ ผู้ใช้ที่คลิก Action Link จากเดสก์ท็อป จากนั้นทำธุรกรรมบนอุปกรณ์เคลื่อนที่ด้วยบัญชีผู้ใช้เดียวกันจะต้องทริกเกอร์เหตุการณ์ Conversion
หากจัดเก็บโทเค็นไว้ที่ระดับอุปกรณ์เท่านั้น เช่น ในคุกกี้ของเบราว์เซอร์ ระบบจะไม่คาดหวังให้คุณระบุแหล่งที่มาจากหลายอุปกรณ์ ในกรณีนี้ อุปกรณ์แต่ละเครื่องสามารถเก็บโทเค็นแยกกันได้หากผู้ใช้คลิก ลิงก์การดำเนินการ ในอุปกรณ์นั้น และอุปกรณ์แต่ละเครื่องสามารถปฏิบัติตามกฎการระบุแหล่งที่มาแยกกันได้