ขั้นตอนที่ 3: เครื่องมือวัด Conversion

การใช้งาน

สรุป

การใช้เครื่องมือวัด Conversion ประกอบด้วย 3 ส่วน ได้แก่

  1. การรวบรวม rwg_token จากหน้า Landing Page / จุดแรกเข้าของแอป
  2. คง rwg_token ไว้สำหรับกรอบเวลาการระบุแหล่งที่มาที่เหมาะสม
  3. การส่งเหตุการณ์ 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 โดยไม่มีการแก้ไขใดๆ หากมีโทเค็นเหลืออยู่จากการเข้าชมครั้งก่อน คุณควรเปลี่ยนโทเค็นเก่าและควรรีเซ็ตกรอบเวลา 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 สำหรับการทดสอบในสภาพแวดล้อมแซนด์บ็อกซ์ คุณสามารถใช้โทเค็นทดสอบต่อไปนี้

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
    })
  });
}

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

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

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

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

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

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

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

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

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