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

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

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

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

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

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

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

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

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

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

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

Swift

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

Objective-C

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

นอกจากพารามิเตอร์ที่กำหนดแล้ว คุณยังเพิ่มพารามิเตอร์ต่อไปนี้ได้ด้วย ในกิจกรรมใดก็ได้

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

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

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

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

Swift

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

Objective-C

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

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

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

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

Swift 

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

Objective-C 

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

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

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

ดูเหตุการณ์ในคอนโซลแก้ไขข้อบกพร่องของ Xcode

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

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

  1. ใน Xcode ให้เลือก Product > รูปแบบ > แก้ไขรูปแบบ...
  2. เลือกเรียกใช้จากเมนูด้านซ้าย
  3. เลือกแท็บอาร์กิวเมนต์
  4. ในส่วนอาร์กิวเมนต์ที่ผ่านเมื่อเปิดตัว ให้เพิ่ม -FIRAnalyticsVerboseLoggingEnabled

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

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

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

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