Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

บันทึกเหตุการณ์

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

คู่มือนี้แสดงวิธีบันทึกกิจกรรมในแอปของคุณ

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

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'
});

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'});
ตัวยึดตำแหน่ง 95

ดูเหตุการณ์ในแดชบอร์ด

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

คุณเข้าถึงข้อมูลนี้ได้จากแดชบอร์ด เหตุการณ์ ในคอนโซล Firebase แดชบอร์ดนี้แสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์แต่ละประเภทที่แอปของคุณบันทึกไว้