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

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

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

การใช้งาน

สรุป

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

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

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

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

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

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 และมีเหตุการณ์ที่ถูกต้อง rwg_token

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

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

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

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

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

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

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

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

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