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

การใช้งาน

สรุป

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

  1. การรวบรวม rwg_token จากหน้า Landing Page/จุดเข้าแอป
  2. คงrwg_tokenไว้สําหรับกรอบเวลาการระบุแหล่งที่มาที่เหมาะสม
  3. การส่งเหตุการณ์ 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

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

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

<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 ของแอปหรือ Intent ของแอปที่ลงทะเบียนสําหรับโดเมนของคุณ

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

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