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

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

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

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

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

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

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

กรณีการใช้งาน รหัสเซสชัน ข้อกำหนดด้านเวลาของคำขอ ข้อกำหนด timestamp_micros
มอบหมาย User-ID ให้กับเหตุการณ์ ต้องระบุ <= สิ้นสุดวันทำการของการเริ่มต้นเซสชัน >= เริ่มต้นเซสชันและ <= สิ้นสุดเซสชัน
การระบุแหล่งที่มาของเซสชัน ต้องระบุ <= เริ่มต้นเซสชัน + 24 ชั่วโมง >= เริ่มต้นเซสชันและ <= สิ้นสุดเซสชัน
ส่งออกเหตุการณ์ไปยังแพลตฟอร์มโฆษณา ไม่จำเป็น <= วันที่ของเซสชันล่าสุด + 63 วัน >= เวลาที่ส่งคำขอ - 72 ชั่วโมงและ <= เวลาที่ส่งคำขอ
ส่งเหตุการณ์หรือพร็อพเพอร์ตี้ผู้ใช้เพื่อสร้างกลุ่มเป้าหมาย ไม่จำเป็น เว็บ: <= เวลาของเหตุการณ์ออนไลน์ล่าสุด + 30 วัน
แอป: <= เวลาของเหตุการณ์ออนไลน์ล่าสุด + 42 วัน		 >= เวลาที่ส่งคำขอ - 72 ชั่วโมงและ <= เวลาที่ส่งคำขอ

มอบหมาย 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 ชั่วโมงที่ผ่านมา