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


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

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

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'
});
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 > เหตุการณ์ > จัดการคําจํากัดความที่กําหนดเอง > สร้างมิติข้อมูลที่กําหนดเอง

    พารามิเตอร์ที่กําหนดเองสามารถใช้ในการกําหนดกลุ่มเป้าหมายซึ่งอาจนําไปใช้กับทุกรายงานได้ พารามิเตอร์ที่กําหนดเองจะรวมอยู่ในข้อมูลที่ส่งออกไปยัง 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

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

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

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