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

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

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

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

ก่อนที่คุณจะเริ่ม

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

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

หลังจากที่คุณกำหนดค่าอินสแตนซ์ FirebaseApp แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วยวิธี logEvent() ได้

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

คุณสามารถดูรายละเอียดการใช้งานได้ในการอ้างอิงค่าคงที่สำหรับ Swift และ Objective-C

ตัวอย่างต่อไปนี้สาธิตวิธีบันทึกเหตุการณ์ kFIRSelectContent ที่แนะนำ:

สวิฟท์

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

วัตถุประสงค์-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

นอกจากพารามิเตอร์ที่กำหนดแล้ว คุณสามารถเพิ่มพารามิเตอร์ต่อไปนี้ให้กับเหตุการณ์ใดๆ ได้:

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

    คุณสามารถใช้พารามิเตอร์ที่กำหนดเองในคำจำกัดความ ผู้ชม ที่อาจนำไปใช้กับทุกรายงาน พารามิเตอร์ที่กำหนดเองยังรวมอยู่ในข้อมูล ที่ส่งออกไปยัง BigQuery หากแอปของคุณลิงก์กับโปรเจ็กต์ BigQuery ค้นหาคำค้นหาตัวอย่างและอื่นๆ อีกมากมายที่ Google Analytics 4 BigQuery Export

  • พารามิเตอร์ kFIRParameterValue : kFIRParameterValue เป็นพารามิเตอร์วัตถุประสงค์ทั่วไปที่มีประโยชน์สำหรับการสะสมตัววัดหลักที่เกี่ยวข้องกับเหตุการณ์ ตัวอย่างได้แก่ รายได้ ระยะทาง เวลา และคะแนน

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

สวิฟท์

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])
PatternTabBarController.swift

วัตถุประสงค์-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
PatternTabBarController.m

ตั้งค่าพารามิเตอร์เหตุการณ์เริ่มต้น

คุณสามารถบันทึกพารามิเตอร์ระหว่างเหตุการณ์ได้โดยใช้ setDefaultEventParameters พารามิเตอร์เริ่มต้นจะเชื่อมโยงกับเหตุการณ์ในอนาคตทั้งหมดที่บันทึกไว้

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

สวิฟท์

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

วัตถุประสงค์-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

หากมีการระบุพารามิเตอร์ในเมธอด logEvent() ค่านั้นจะถูกใช้แทนค่าเริ่มต้น

หากต้องการล้างพารามิเตอร์ดีฟอลต์ ให้เรียกใช้เมธอด setDefaultEventParameters โดยตั้งค่าพารามิเตอร์เป็น nil

ดูเหตุการณ์ในคอนโซลดีบัก Xcode

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

คุณสามารถเปิดใช้งานการบันทึกแบบละเอียดได้ดังนี้:

  1. ใน Xcode ให้เลือก ผลิตภัณฑ์ > โครงการ > แก้ไขโครงการ...
  2. เลือก เรียกใช้ จากเมนูด้านซ้าย
  3. เลือกแท็บ อาร์กิวเมนต์
  4. ในส่วน Arguments Passed On Launch ให้เพิ่ม -FIRAnalyticsVerboseLoggingEnabled

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

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

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

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