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

การเก็บรวบรวม 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 คุณสามารถใช้โทเค็นทดสอบต่อไปนี้เพื่อวัตถุประสงค์ในการทดสอบในสภาพแวดล้อม Sandbox 

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

ตัวอย่างการติดตาม 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 ของ Google คือกรอบเวลาการระบุแหล่งที่มา 30 วันสําหรับการโต้ตอบกับลิงก์สถานที่ในร้านค้าใดก็ได้

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

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

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

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

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

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

ก่อนหน้า
ขั้นตอนที่ 2: ฟีด
ถัดไป
ขั้นตอนที่ 4: นำร่องและเปิดตัว