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

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

การใช้งาน

สรุป

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

  • การรวบรวมข้อมูล rwg_token และ merchant_id จากหน้า Landing Page / แอป จุดแรกเข้า
  • คง rwg_token และ merchant_id เพื่อการระบุแหล่งที่มาที่เหมาะสม
  • เปรียบเทียบ merchant_id และ merchant_id ที่มีอยู่ ณ เวลาที่เกิด Conversion (การจองเสร็จสมบูรณ์)
  • การส่งเหตุการณ์ Conversion ณ เวลาที่เกิด 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 ไว้

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

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

กำลังรวบรวม merchant_id

หากคุณใช้ตรรกะเครื่องมือวัด Conversion ในฟรอนท์เอนด์ ในหน้า Landing Page คุณต้องติดตั้งสคริปต์ที่กำหนดเองที่จะค้นหาและจับ merchant_id โดยปกติ merchant_id อาจมีอยู่แล้วใน หน้า Landing Page หรือใน URL เพื่อให้คุณ จับภาพได้จากที่นั่น หรือไม่เช่นนั้น คุณต้อง หาวิธีที่จะทำให้อุปกรณ์อยู่ในตำแหน่งที่พอดี ซึ่งก็น่าจะบอกเป็นนัย การเปลี่ยนแปลงแบ็กเอนด์

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

merchant_id นี้ต้องเป็นไฟล์เดียวกับที่คุณแชร์กับ Google ฟีดของคุณ

คง rwg_token และ merchant_id ไว้

คุณจะต้องคงพารามิเตอร์ของ URL rwg_token ไว้ ซึ่งจะ ต่อท้ายลิงก์การดำเนินการทั้งหมดที่คุณระบุเป็นระยะเวลารวม 30 วัน ควรจัดเก็บและแสดงผลค่าของ rwg_token โดยไม่มีการแก้ไขใดๆ

คุณจะต้องจัดเก็บ merchant_id ที่เกี่ยวข้องไว้กับ rwg_token พร้อมลิงก์การดำเนินการ

หากมีโทเค็นเดิมยังคงอยู่จากการเข้าชมครั้งก่อน ควรเปลี่ยน rwg_token และ merchant_id และกรอบเวลา 30 วันสำหรับ ควรรีเซ็ตพื้นที่เก็บข้อมูล

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

  • ระดับอุปกรณ์รวมถึงการใช้คุกกี้ของเบราว์เซอร์ พื้นที่เก็บข้อมูลในเครื่อง และในเครื่องของแอป หรือวิธีการอื่นๆ ที่สามารถเก็บโทเค็นไว้เป็นเวลา 30 วัน ในการระบุแหล่งที่มา
  • ระดับผู้ใช้จะรวมถึงการรักษาระดับนั้นในฐานข้อมูลแอปพลิเคชันของคุณด้วย ระบบการวิเคราะห์ฝั่งเซิร์ฟเวอร์หรือระบบฝั่งเซิร์ฟเวอร์อื่นๆ

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

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

เมื่อใช้เครื่องมือวัด Conversion ระดับผู้ใช้ พารามิเตอร์ rwg_token และ merchant_id ควร จะจัดเก็บไว้ในเซิร์ฟเวอร์และเชื่อมโยงกับผู้ใช้

การส่งข้อมูล 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>,
  "merchant_changed": 1|2
}

ตัวอย่าง (ผู้ขายที่ไม่เปลี่ยนแปลงด้วยโทเค็นทดสอบสำหรับพาร์ทเนอร์ 20123456)

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": 2
}

ค่า seller_changed ใช้เพื่อกำหนดว่าผู้ขายมีการเปลี่ยนแปลงหรือไม่ จากผู้ขายที่มีการเปลี่ยนเส้นทางเริ่มแรก มี 2 ค่าที่ส่งได้

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

คุณต้องระบุแอตทริบิวต์ทั้งในสภาพแวดล้อมแซนด์บ็อกซ์และสภาพแวดล้อมการใช้งานจริง rwg_token ที่ถูกต้องเมื่อส่งเหตุการณ์ Conversion สำหรับการทดสอบ ให้ใช้ โทเค็นทดสอบต่อไปนี้ในทั้ง 2 สภาพแวดล้อมจนกว่าคุณจะเปิดใช้งาน

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

หากต้องการทดสอบในแซนด์บ็อกซ์ คุณจะต้องเพิ่มพารามิเตอร์ของ URL ต่อไปนี้ด้วยตนเองเพื่อ ลิงก์ Sandbox ของคุณ:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

ตัวอย่างที่สมบูรณ์ของเครื่องมือวัด Conversion ระดับอุปกรณ์ (ใช้คุกกี้ใน device) ใน 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,
      merchant_changed: merchantChanged
    })
  });
}

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

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

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

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

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

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

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

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

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

ถัดไป
การอัปเดตแบบเรียลไทม์