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

เลือกแพลตฟอร์ม:

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

Analytics Analytics จะบันทึก เหตุการณ์บางอย่างให้คุณโดยอัตโนมัติ คุณจึงไม่จำเป็นต้องเพิ่มโค้ดใดๆ เพื่อรับเหตุการณ์เหล่านั้น หากแอปจำเป็นต้อง เก็บรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกเหตุการณ์Analyticsได้มากถึง 500 รายการในแอป (2, 000 รายการหากคุณใช้ Google Analytics 360) ประเภท ไม่มีการจำกัดปริมาณเหตุการณ์ทั้งหมดที่แอปบันทึก โปรดทราบว่าชื่อเหตุการณ์จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และการบันทึกเหตุการณ์ 2 รายการที่ชื่อต่างกันตรงตัวพิมพ์เท่านั้นจะทำให้ระบบบันทึกเหตุการณ์ 2 รายการแยกกัน

ก่อนเริ่มต้น

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

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

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

SDK ของ 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'
});analytics_log_event_params.js

Web

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});index.js

นอกเหนือจากพารามิเตอร์ที่กำหนดไว้แล้ว คุณยังเพิ่มพารามิเตอร์ต่อไปนี้ลงในเหตุการณ์ใดก็ได้

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

คุณสามารถใช้พารามิเตอร์ที่กำหนดเองใน คำจำกัดความของกลุ่มเป้าหมาย ที่อาจนำไปใช้กับทุกรายงานได้ นอกจากนี้ พารามิเตอร์ที่กำหนดเองจะรวมอยู่ในข้อมูล ที่ส่งออกไปยัง 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'});analytics_log_event_custom_params.js

Web

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

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

ในคอนโซล Firebase คุณสามารถดูสถิติแบบรวมเกี่ยวกับเหตุการณ์ได้ ในแดชบอร์ดAnalytics > Events

โปรดทราบข้อมูลต่อไปนี้เกี่ยวกับแดชบอร์ดนี้

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