Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

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

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

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

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

ก่อนจะเริ่ม

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

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

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

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

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

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

Swift

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

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

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

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

Swift

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

Swift

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

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

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

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

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

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

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

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

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

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

ดูกิจกรรมในแดชบอร์ด

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

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