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


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

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

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