การใช้งาน
สรุป
การใช้งานเครื่องมือวัด 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
}
ค่า seller_changed ใช้เพื่อกำหนดว่าผู้ขายมีการเปลี่ยนแปลงหรือไม่ จากผู้ขายที่มีการเปลี่ยนเส้นทางเริ่มแรก มี 2 ค่าที่ส่งได้
ค่าการเปลี่ยนแปลงของผู้ขาย | ข้อกำหนด |
---|---|
1 | ควรใช้ค่านี้เมื่อผู้ใช้ออกจาก เว็บไซต์ของผู้ขายเดิมและทำการซื้อจนเสร็จสิ้น ผ่านแพลตฟอร์มของคุณกับผู้ขายรายอื่น |
2 | ควรใช้ค่านี้เมื่อลูกค้า ทำธุรกรรมผ่านเอนทิตีเดิม (ผู้ขาย) |
คุณต้องระบุแอตทริบิวต์ทั้งในสภาพแวดล้อมแซนด์บ็อกซ์และสภาพแวดล้อมการใช้งานจริง
rwg_token
ที่ถูกต้องเมื่อส่งเหตุการณ์ Conversion สำหรับการทดสอบ ให้ใช้
โทเค็นทดสอบต่อไปนี้ในทั้ง 2 สภาพแวดล้อมจนกว่าคุณจะเปิดใช้งาน
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
หากต้องการทดสอบในแซนด์บ็อกซ์ คุณจะต้องเพิ่มพารามิเตอร์ของ URL ต่อไปนี้ด้วยตนเองเพื่อ ลิงก์ Sandbox ของคุณ:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
ตัวอย่างที่สมบูรณ์ของเครื่องมือวัด Conversion ระดับอุปกรณ์ (ใช้คุกกี้ใน device) ใน 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 ให้แสดงขึ้น
หากมีการจัดเก็บโทเค็นที่ระดับอุปกรณ์เท่านั้น เช่น ในเบราว์เซอร์ คุกกี้ ไม่จำเป็นว่าคุณจะแสดงการระบุแหล่งที่มาจากหลายอุปกรณ์ ด้วยวิธีนี้ อุปกรณ์แต่ละเครื่องจะมีโทเค็นแยกกันอยู่หากผู้ใช้ติดตาม ลิงก์การดำเนินการบนอุปกรณ์นั้น และอุปกรณ์แต่ละเครื่องจะทำงานตามการระบุแหล่งที่มา แยกกัน