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

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

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

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