กรณีการใช้งาน Measurement Protocol

Google Analytics Measurement Protocol ช่วยให้คุณส่งข้อมูลออฟไลน์ไปยังสตรีมเว็บหรือแอป นอกเหนือจากข้อมูลที่คุณรวบรวมอยู่แล้วด้วยการติดแท็กหรือ Firebase SDK

คู่มือนี้อธิบายกรณีการใช้งาน Measurement Protocol ของ Google Analytics ที่พบบ่อยและข้อกำหนดของกรณีการใช้งานเหล่านั้น

ข้อมูลสรุปของข้อกำหนด

ตารางนี้แสดงข้อกำหนดของแต่ละกรณีการใช้งานไว้สั้นๆ โปรดคำนึงถึงแนวทางปฏิบัติแนะนำต่อไปนี้

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

2. เพื่อการรายงานแบบเรียลไทม์และเมตริกการมีส่วนร่วมที่แม่นยำ ให้รวมชุดพารามิเตอร์เหตุการณ์ engagement_time_msec ที่ตั้งไว้เป็นหน่วยมิลลิวินาทีตั้งแต่เหตุการณ์ก่อนหน้า

มอบหมาย User-ID ให้กับเหตุการณ์

ใช้ Measurement Protocol เพื่อระบุ User-IDให้กับเหตุการณ์ออนไลน์หรือออฟไลน์

ตัวอย่างกรณีการใช้งานสำหรับการเพิ่ม User-ID ลงในเหตุการณ์มีดังนี้

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

   ในสถานการณ์นี้ คุณใช้ Measurement Protocol เพื่อระบุ User-ID ให้กับเหตุการณ์ ออนไลน์

2. คุณไม่มี User-ID สำหรับเหตุการณ์ที่ส่งด้วย Measurement Protocol แต่ต้องการให้เหตุการณ์เหล่านั้นเชื่อมโยงกับ User-ID หากผู้ใช้เข้าสู่ระบบออนไลน์ในระหว่างเซสชัน

   ในสถานการณ์นี้ คุณใช้เหตุการณ์ออนไลน์เพื่อระบุ User-ID ให้กับเหตุการณ์ Measurement Protocol

ข้อกำหนดในการเพิ่ม User-ID ลงในเหตุการณ์มีดังนี้

• ใส่ session_id ในรายการพารามิเตอร์ของเหตุการณ์
• ส่งเหตุการณ์ Measurement Protocol ใน วันทำการเดียวกัน กับเซสชันออนไลน์
• หากลบล้าง timestamp_micros ให้ตั้งค่าเป็น timestamp ระหว่างเวลาเริ่มต้นและเวลาสิ้นสุดของเซสชันออนไลน์
• หากเป้าหมายของคุณคือการระบุ User-ID ให้กับเหตุการณ์ออนไลน์ ให้ตั้งค่า user_id ในคำขอ
• หากเป้าหมายของคุณคือต้องการให้เหตุการณ์ Measurement Protocol แต่ละรายการมี User-ID จากเซสชันออนไลน์ที่เกี่ยวข้อง คุณไม่จำเป็นต้องตั้งค่า user_id

การระบุแหล่งที่มาของเซสชัน

เหตุการณ์ Measurement Protocol ที่เป็นไปตามข้อกำหนดที่เฉพาะเจาะจงจะปรากฏในรายงานที่มีแอตทริบิวต์เซสชันเดียวกัน (เช่น ข้อมูลทางภูมิศาสตร์ แหล่งที่มา สื่อ และแคมเปญ) กับเหตุการณ์ออนไลน์จากเซสชันเดียวกัน

ข้อกำหนดสำหรับการระบุแหล่งที่มาของเซสชันมีดังนี้

• ใส่ session_id ในรายการพารามิเตอร์ของเหตุการณ์

• ส่งคำขอภายใน 24 ชั่วโมงหลังจากเริ่มเซสชันออนไลน์

  ตัวอย่างเช่น หากเซสชันเริ่มเวลา 11:15 น. ในวันจันทร์ตามเขตเวลาของพร็อพเพอร์ตี้ ให้ส่งคำขอก่อนเวลา 11:15 น. ในวันอังคาร

• หากลบล้าง timestamp_micros ให้ตั้งค่าเป็น timestamp ระหว่างเวลาเริ่มต้นและเวลาสิ้นสุดของเซสชันออนไลน์

ส่งออกเหตุการณ์ไปยังแพลตฟอร์มโฆษณา

Google Analytics จะรวมเหตุการณ์ที่คุณส่งโดยใช้ Measurement Protocol ไว้ในการส่งออกไปยังผลิตภัณฑ์โฆษณาที่ลิงก์ไว้ เช่น Google Ads หรือ Campaign Manager 360

สถานการณ์ที่พบบ่อยบางส่วนที่กรณีการใช้งานนี้มีประโยชน์ ได้แก่

• ธุรกิจของคุณมีเหตุการณ์ออฟไลน์ที่ต้องการรวมไว้ในการระบุแหล่งที่มาและการรายงานโฆษณา
• คุณมีเหตุการณ์เพิ่มเติมในระบบที่การติดแท็กหรือ Firebase SDK เข้าถึงไม่ได้ แต่ยังต้องการรวมเหตุการณ์เหล่านั้นไว้ในผลิตภัณฑ์ที่ลิงก์ไว้

ข้อกำหนดในการส่งออกเหตุการณ์ไปยังแพลตฟอร์มโฆษณามีดังนี้

• ส่งคำขอภายใน 63 วันหลังจากเหตุการณ์ออนไลน์ล่าสุด แม้ว่ากรอบเวลาการระบุแหล่งที่มาของเหตุการณ์สำคัญจะนานกว่า 63 วัน นอกจากนี้ เหตุการณ์ยังต้องมาถึงภายในกรอบเวลาการระบุแหล่งที่มาของเหตุการณ์สำคัญด้วย ดูวิธีกำหนดการตั้งค่ากรอบเวลาการระบุแหล่งที่มา

  ตัวอย่างเช่น หากเหตุการณ์ออนไลน์ล่าสุดสำหรับ client_id หรือ app_instance_id เกิดขึ้นในวันที่ 1 มีนาคม ให้ส่งเหตุการณ์ Measurement Protocol ภายในวันที่ 3 พฤษภาคม

• หากลบล้าง timestamp_micros ให้ตั้งค่าเป็น timestamp ภายใน 72 ชั่วโมงที่ผ่านมา

ส่งเหตุการณ์หรือพร็อพเพอร์ตี้ผู้ใช้เพื่อสร้างกลุ่มเป้าหมาย

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

ข้อกำหนดในการส่งเหตุการณ์หรือพร็อพเพอร์ตี้ผู้ใช้เพื่อสร้างกลุ่มเป้าหมายมีดังนี้

• ส่งคำขอไปยังสตรีมเว็บภายใน 30 วันหลังจากเหตุการณ์ออนไลน์ล่าสุดสำหรับ client_id เดียวกัน

  ตัวอย่างเช่น หากเหตุการณ์ออนไลน์ล่าสุดสำหรับ client_id เกิดขึ้นในวันที่ 1 มีนาคม ให้ส่งเหตุการณ์ Measurement Protocol ภายในวันที่ 31 มีนาคม

• ส่งคำขอไปยังสตรีมแอปภายใน 42 วันหลังจากเหตุการณ์ออนไลน์ล่าสุดสำหรับ app_instance_id เดียวกัน

  ตัวอย่างเช่น หากเหตุการณ์ออนไลน์ล่าสุดสำหรับ app_instance_id เกิดขึ้นในวันที่ 1 มีนาคม ให้ส่งเหตุการณ์ Measurement Protocol ภายในวันที่ 12 เมษายน

• หากลบล้าง timestamp_micros ให้ตั้งค่าเป็น timestamp ภายใน 72 ชั่วโมงที่ผ่านมา