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

เลือกแพลตฟอร์ม: iOS+ Android เว็บ Flutter Unity C++


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

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

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

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

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

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

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

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

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

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

  • แดชบอร์ดจะอัปเดตเป็นระยะๆ ตลอดทั้งวัน หากต้องการทดสอบทันที ให้ใช้ DebugView