หน้านี้ได้รับการแปลโดย Cloud Translation API

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

การใช้งาน

สรุป

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

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

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

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

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

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

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

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

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

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

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

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