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


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

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

Analytics จะบันทึกบางรายการโดยอัตโนมัติ events สำหรับคุณ เธอไม่ได้ คุณต้องเพิ่มโค้ดใดๆ จึงจะรับได้ หากแอปของคุณต้องรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกประเภทเหตุการณ์ 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

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

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

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