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

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

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

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

ก่อนจะเริ่ม

ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าโครงการของคุณและสามารถเข้าถึง Analytics ที่อธิบายไว้ใน การเริ่มต้นด้วย Analytics

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

หลังจากที่คุณได้กำหนดค่า firebase.analytics() ตัวอย่างเช่นคุณสามารถเริ่มต้นที่จะบันทึกเหตุการณ์กับ logEvent() วิธีการ ถ้าคุณคุ้นเคยกับ Google Analytics วิธีนี้เทียบเท่ากับการใช้ event คำสั่งใน gtag.js

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

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

คุณสามารถค้นหารายละเอียดการดำเนินงานหลายเหตุการณ์ที่เกิดขึ้นและพารามิเตอร์ของพวกเขาใน การอ้างอิง gtag.js เหตุการณ์

ตัวอย่างต่อไปนี้แสดงให้เห็นถึงวิธีการล็อก select_content เหตุการณ์:

เว็บรุ่น 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

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

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

เว็บรุ่น 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

เว็บรุ่น8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

ดูกิจกรรมในแดชบอร์ด

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

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