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

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


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

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

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

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

หากต้องการรวบรวมข้อมูลการระบุแหล่งที่มาของแคมเปญ โปรดอย่าลืม เพิ่มเฟรมเวิร์ก AdSupport ลงในโปรเจ็กต์

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

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

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

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

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

Swift

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

Objective-C

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

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

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

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

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

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

Swift

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

Objective-C

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

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

คุณสามารถบันทึกพารามิเตอร์ในเหตุการณ์ต่างๆ ได้โดยใช้ 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 ให้เลือกผลิตภัณฑ์ > รูปแบบ > แก้ไขรูปแบบ...
  2. เลือกเรียกใช้ จากเมนูด้านซ้าย
  3. เลือกแท็บอาร์กิวเมนต์
  4. ในส่วนอาร์กิวเมนต์ที่ส่งเมื่อเปิดตัว ให้เพิ่ม -FIRAnalyticsVerboseLoggingEnabled

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

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

ในคอนโซล Firebase คุณสามารถดูสถิติแบบรวมเกี่ยวกับเหตุการณ์ได้ ในแดชบอร์ดAnalytics > Events

สิ่งที่ควรทราบเกี่ยวกับแดชบอร์ดนี้มีดังนี้

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

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