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