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

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

คู่มือนี้อธิบาย Use Case ทั่วไปของ Measurement Protocol ของ Google Analytics และข้อกำหนดของ Use Case เหล่านั้น

คำสำคัญ: ในคู่มือนี้ "วันทำการ" หมายถึงวันทำการของเหตุการณ์หรือเซสชันในเขตเวลาของพร็อพเพอร์ตี้

สรุปข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เคล็ดลับ: Use Case นี้ไม่จำเป็นต้องใช้ session_id

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

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

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

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

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

• หากคุณลบล้าง timestamp_micros ให้ตั้งค่าเป็นการประทับเวลาภายใน 3 วันทำการที่ผ่านมา

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

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

เคล็ดลับ: Use Case นี้ไม่จำเป็นต้องใช้ session_id

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

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

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

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

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

• หากคุณลบล้าง timestamp_micros ให้ตั้งค่าเป็นการประทับเวลาภายใน 3 วันทำการที่ผ่านมา