เครื่องมือวัด Conversion

วัตถุประสงค์: ใช้เครื่องมือวัด Conversion สำหรับ การผสานรวมลิงก์ธุรกิจการจอง

คำเตือน: โปรดตรวจสอบว่าไม่ได้ส่งข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ของผู้ใช้ไปยัง Google ซึ่งเป็นส่วนหนึ่งของข้อมูล Conversion

การใช้งาน

สรุป

การติดตั้งใช้งานเครื่องมือวัด Conversion มี 3 ส่วน ดังนี้

1. รวบรวม rwg_token จากจุดแรกเข้าของหน้า Landing Page / แอป
2. คงค่า rwg_token สำหรับกรอบเวลาการระบุแหล่งที่มาที่เหมาะสม
3. การส่งเหตุการณ์ Conversion เมื่อชำระเงิน

การติดตั้งใช้งานเครื่องมือวัด Conversion นี้ไม่จําเป็นต้องใช้ Google Analytics หรือ JavaScript อื่นๆ ของบุคคลที่สาม

ประเด็นสำคัญ: การติดตาม Conversion มี 2 ระดับ ได้แก่ ระดับอุปกรณ์และระดับผู้ใช้ ทั้ง 2 รูปแบบได้รับการรองรับในระหว่างการผสานรวมนี้ และคุณเลือกได้ตามสถาปัตยกรรมผลิตภัณฑ์

ก่อนเริ่มการติดตั้งใช้งานเครื่องมือวัด 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

หมายเหตุ: การคงค่า rwg_token เป็นกุญแจสำคัญในการ ใช้กรอบเวลาการระบุแหล่งที่มาที่จำเป็นอย่างถูกต้อง ดูรายละเอียดเพิ่มเติมเกี่ยวกับ ข้อกำหนดการระบุแหล่งที่มาได้ที่ส่วน ข้อกำหนดการระบุแหล่งที่มาของ Conversion ด้านล่าง

คุณจะต้องเก็บพารามิเตอร์ URL ของ rwg_token ซึ่ง จะต่อท้ายลิงก์การดำเนินการทั้งหมดที่คุณระบุ เป็นระยะเวลา รวม 30 วัน ค่าของ rwg_token ควร จัดเก็บและแสดงผลโดยไม่มีการแก้ไข หากมีโทเค็นที่บันทึกไว้จากการเข้าชมครั้งก่อน คุณควรแทนที่โทเค็นเก่าและรีเซ็ตกรอบเวลา 30 วันสำหรับการจัดเก็บ

เมื่อบันทึกโทเค็น คุณจะจัดเก็บโทเค็นที่ ระดับอุปกรณ์หรือระดับผู้ใช้ก็ได้

• ระดับอุปกรณ์รวมถึงการใช้คุกกี้ของเบราว์เซอร์ พื้นที่เก็บข้อมูลในเครื่อง พื้นที่เก็บข้อมูลในเครื่องของแอป หรือวิธีการอื่นๆ ที่สามารถเก็บโทเค็นไว้ สำหรับหน้าต่างการระบุแหล่งที่มา 30 วัน
• ระดับผู้ใช้รวมถึงการคงไว้ในฐานข้อมูลแอปพลิเคชัน ผ่านระบบวิเคราะห์ฝั่งเซิร์ฟเวอร์หรือระบบฝั่งเซิร์ฟเวอร์อื่นๆ

ด้านล่างนี้คือตัวอย่างเครื่องมือวัด Conversion ระดับอุปกรณ์ ซึ่งจัดเก็บโทเค็นนี้ไว้ในเว็บเบราว์เซอร์ผ่านคุกกี้ของบุคคลที่หนึ่ง ตัวอย่างนี้ถือว่าคุณได้แยกวิเคราะห์ค่าโทเค็น เป็นตัวแปรตามตัวอย่างด้านบนแล้ว หากต้องการใช้ตัวอย่างนี้ คุณจะต้องอัปเดต "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

เมื่อผู้ใช้ทำธุรกรรมที่เกิดจากลิงก์การดำเนินการใน 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>
}

ทั้งในสภาพแวดล้อมแซนด์บ็อกซ์และสภาพแวดล้อมการใช้งานจริง คุณจะต้อง ระบุ rwg_token ที่ถูกต้องเมื่อส่งเหตุการณ์ Conversion คุณอาจใช้โทเค็นทดสอบต่อไปนี้เพื่อวัตถุประสงค์ในการทดสอบในสภาพแวดล้อมแซนด์บ็อกซ์

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

หมายเหตุ: ในการใช้งานจริง คุณไม่ควรส่งเหตุการณ์ Conversion ที่ไม่ได้ ระบุแหล่งที่มาจากการผสานรวมนี้ โปรดตรวจสอบค่า rwg_token ที่ถูกต้องและยังไม่หมดอายุก่อนส่งเหตุการณ์

ตัวอย่างแบบเต็มของการติดตาม Conversion ระดับอุปกรณ์ (ใช้คุกกี้ใน อุปกรณ์ของผู้ใช้) ใน JavaScript เกี่ยวกับวิธีสร้างคำขอ POST นี้ รวมอยู่ด้านล่าง

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 ได้จากไคลเอ็นต์เว็บหรือแอป หรือจากเซิร์ฟเวอร์ คุณสามารถตัดสินใจได้ตามความต้องการและตามที่จัดเก็บโทเค็น ตราบใดที่ระบบส่งเหตุการณ์ Conversion เพียงครั้งเดียวต่อ Conversion และมีค่า rwg_token ที่ถูกต้อง

ข้อกำหนดในการระบุแหล่งที่มาของ Conversion

มาตรฐานที่ Google กําหนดสําหรับการระบุแหล่งที่มาของ Conversion คือกรอบเวลาการระบุแหล่งที่มา 30 วันสําหรับการโต้ตอบกับลิงก์สถานที่ในร้านค้าใดก็ได้

หมายเหตุ: กรอบการระบุแหล่งที่มานี้อาจแตกต่างจากวิธีที่ระบบวิเคราะห์ระบุแหล่งที่มาของ Conversion ระบบนี้ออกแบบมาให้ทํางานโดยไม่ขึ้นอยู่กับการติดตาม Conversion ที่คุณใช้ในระบบ และไม่ควรส่งผลต่อข้อมูลวิเคราะห์ภายใน

กรอบเวลาการระบุแหล่งที่มานี้หมายความว่าเราคาดหวังให้ส่งเหตุการณ์ Conversion ในสถานการณ์ต่อไปนี้

• ผู้ใช้คลิกลิงก์การดำเนินการเกี่ยวกับสถานที่และสั่งซื้อในเซสชันเดียวกัน
• ผู้ใช้คลิกลิงก์การกระทําของสถานที่ แล้วกลับมาจากแชแนลอื่นภายในกรอบเวลา 30 วันเพื่อสั่งซื้อ
• ผู้ใช้คลิกลิงก์การดำเนินการเกี่ยวกับสถานที่ แล้วสั่งซื้อที่ร้านค้าอื่น ไม่ว่าจะอยู่ในเซสชันเดียวกันหรือเซสชันอื่นภายในกรอบเวลา 30 วัน

นอกจากนี้ เราคาดหวังให้ส่งเหตุการณ์ Conversion จากทุกแพลตฟอร์มที่ผู้ใช้สามารถเข้าถึงได้จากลิงก์การดำเนินการเกี่ยวกับสถานที่ รวม:

• แอปพลิเคชันบนเดสก์ท็อปหรือเว็บบนอุปกรณ์เคลื่อนที่
• แอปบนอุปกรณ์เคลื่อนที่ ไม่ว่าจะผ่าน Deep Link ของแอปหรือ App Intent ที่ลงทะเบียนไว้สำหรับโดเมนของคุณ

หากจัดเก็บโทเค็นไว้ที่ระดับผู้ใช้ (ดูการคงโทเค็นไว้) คุณควรระบุการระบุแหล่งที่มาข้ามอุปกรณ์ กล่าวคือ ผู้ใช้ที่ คลิกลิงก์การดำเนินการจากเดสก์ท็อปแล้วทำธุรกรรมให้เสร็จสมบูรณ์ บนอุปกรณ์เคลื่อนที่ (โดยใช้บัญชีผู้ใช้เดียวกัน) ควรทําให้เกิด เหตุการณ์ Conversion

หากจัดเก็บโทเค็นไว้ที่ระดับอุปกรณ์เท่านั้น เช่น ในคุกกี้ของเบราว์เซอร์ คุณไม่จำเป็นต้องระบุการระบุแหล่งที่มาข้ามอุปกรณ์ ในกรณีนี้ อุปกรณ์แต่ละเครื่องจะมีโทเค็นแยกกัน ซึ่งจะยังคงอยู่หากผู้ใช้คลิกลิงก์การดำเนินการในอุปกรณ์นั้น และ อุปกรณ์แต่ละเครื่องจะปฏิบัติตามกฎการระบุแหล่งที่มาแยกกัน