คู่มือนี้จะแสดงวิธีการบันทึกเหตุการณ์ในแอปของคุณ
เหตุการณ์ ให้ข้อมูลเชิงลึกเกี่ยวกับสิ่งที่เกิดขึ้นในแอปของคุณ เช่น การกระทำของผู้ใช้ เหตุการณ์ของระบบ หรือข้อผิดพลาด
Analytics จะบันทึก เหตุการณ์ บางอย่างให้คุณโดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มรหัสใด ๆ เพื่อรับรหัส หากแอปของคุณต้องการรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกประเภทเหตุการณ์ Analytics ต่างๆ ได้มากถึง 500 ประเภท ในแอปของคุณ ไม่มีการจำกัดจำนวนเหตุการณ์ทั้งหมดที่แอปบันทึก โปรดทราบว่าชื่อเหตุการณ์จะคำนึงถึงขนาดตัวพิมพ์ และการบันทึกเหตุการณ์สองเหตุการณ์ที่มีชื่อต่างกันเฉพาะในกรณีที่จะส่งผลให้เกิดเหตุการณ์ที่แตกต่างกันสองเหตุการณ์
ก่อนจะเริ่ม
ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าโครงการของคุณและสามารถเข้าถึง Analytics ตามที่อธิบายไว้ใน เริ่มต้นใช้งาน Analytics
บันทึกเหตุการณ์
หลังจากที่คุณกำหนดค่าอินสแตนซ์ firebase.analytics firebase.analytics()
แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วย logEvent()
ได้ หากคุณคุ้นเคยกับ Google Analytics อยู่แล้ว วิธีนี้จะเทียบเท่ากับการใช้คำสั่ง event
ใน gtag.js
เพื่อช่วยคุณในการเริ่มต้น Analytics SDK กำหนดเหตุการณ์ที่แนะนำจำนวนหนึ่งซึ่งพบได้ทั่วไปในแอปประเภทต่างๆ รวมถึงแอปค้าปลีกและอีคอมเมิร์ซ การเดินทาง และเกม หากต้องการเรียนรู้เพิ่มเติม เกี่ยวกับเหตุการณ์เหล่านี้ และควรใช้เมื่อใด โปรดดู เหตุการณ์ที่แนะนำ
หมายเหตุ: หากต้องการรายละเอียดสูงสุดในรายงาน ให้บันทึกเหตุการณ์ที่แนะนำซึ่งเหมาะสมกับแอปของคุณและพารามิเตอร์ที่กำหนด นอกจากนี้ยังช่วยให้แน่ใจว่าคุณจะได้รับประโยชน์จากคุณลักษณะล่าสุดของ Google Analytics เมื่อมีให้ใช้งาน
คุณดูรายละเอียดการใช้งานสำหรับหลายเหตุการณ์และพารามิเตอร์ของเหตุการณ์ได้ใน การอ้างอิงเหตุการณ์ gtag.js
ตัวอย่างต่อไปนี้สาธิตวิธีบันทึกเหตุการณ์ select_content
:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
Web version 8
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
นอกเหนือจากพารามิเตอร์ที่กำหนด คุณสามารถเพิ่มพารามิเตอร์ต่อไปนี้ในเหตุการณ์ใดก็ได้:
พารามิเตอร์ที่กำหนดเอง: พารามิเตอร์ที่กำหนดเองสามารถใช้เป็น มิติข้อมูลหรือเมตริก ใน รายงาน Analytics คุณสามารถใช้มิติข้อมูลที่กำหนดเองสำหรับข้อมูลพารามิเตอร์เหตุการณ์ที่ไม่ใช่ตัวเลขและเมตริกที่กำหนดเองสำหรับข้อมูลพารามิเตอร์ที่แสดงเป็นตัวเลขได้ดีกว่า เมื่อคุณบันทึกพารามิเตอร์ที่กำหนดเองโดยใช้ SDK แล้ว ให้ลงทะเบียนมิติข้อมูลหรือเมตริกเพื่อให้แน่ใจว่าพารามิเตอร์ที่กำหนดเองเหล่านั้นปรากฏในรายงาน Analytics ดำเนินการผ่าน: Analytics > เหตุการณ์ > จัดการคำจำกัดความที่กำหนดเอง > สร้างมิติข้อมูลที่กำหนดเอง
พารามิเตอร์ที่กำหนดเองสามารถใช้ในคำจำกัดความ ผู้ชม ที่อาจใช้กับทุกรายงาน พารามิเตอร์ที่กำหนดเองจะรวมอยู่ในข้อมูลที่ ส่งออกไปยัง BigQuery หากแอปของคุณลิงก์กับโครงการ BigQuery ค้นหาตัวอย่างคำค้นหาและอื่นๆ อีกมากมายที่ Google Analytics 4 BigQuery Export
พารามิเตอร์
value
:value
เป็นพารามิเตอร์วัตถุประสงค์ทั่วไปที่มีประโยชน์สำหรับการรวบรวมเมตริกหลักที่เกี่ยวข้องกับเหตุการณ์ ตัวอย่าง ได้แก่ รายได้ ระยะทาง เวลา และคะแนน
หากแอปพลิเคชันของคุณมีความต้องการเฉพาะซึ่งไม่ครอบคลุมถึงประเภทเหตุการณ์ที่แนะนำ คุณสามารถบันทึกเหตุการณ์ที่คุณกำหนดเองได้ ตัวอย่างเช่น หากคุณกำลังพัฒนาเกมและต้องการติดตามเมื่อผู้เล่นทำเป้าหมายใดสำเร็จ คุณสามารถบันทึกเหตุการณ์ที่คล้ายกับตัวอย่างต่อไปนี้:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web version 8
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
ดูกิจกรรมในแดชบอร์ด
คุณสามารถดูสถิติรวมเกี่ยวกับกิจกรรมของคุณได้ในแดชบอร์ดคอนโซล Firebase แดชบอร์ดเหล่านี้จะอัปเดตเป็นระยะตลอดทั้งวัน สำหรับการทดสอบทันที ให้ใช้เอาต์พุต logcat ตามที่อธิบายไว้ในส่วนก่อนหน้า
คุณเข้าถึงข้อมูลนี้ได้จากแดชบอร์ด เหตุการณ์ ในคอนโซล Firebase แดชบอร์ดนี้แสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์แต่ละประเภทที่แอปของคุณบันทึกไว้