Google is committed to advancing racial equity for Black communities. See how.
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

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

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

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

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

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

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

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

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

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

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

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

รวดเร็ว

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

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

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

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

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

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

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

รวดเร็ว

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

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

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

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

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

รวดเร็ว

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 ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

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

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

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