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

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

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

คำสำคัญ: ในคู่มือนี้ "วันทำการ" คือวันทำการของกิจกรรมหรือ ในเขตเวลาของพร็อพเพอร์ตี้

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

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

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

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

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

กำหนด User-ID ให้กับเหตุการณ์

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

ตัวอย่าง Use Case ในการเพิ่ม 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 แต่ยังต้องการรวมเหตุการณ์เหล่านั้นไว้ใน Google อีกด้วย

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

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

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

• หากคุณลบล้าง timestamp_micros ให้ตั้งค่าเป็นการประทับเวลาที่น้อยกว่าหรือเท่ากับ กับเวลาของคำขอ

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

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