คู่มือนี้แสดงวิธีบันทึกกิจกรรมในแอปของคุณ
เหตุการณ์ ให้ข้อมูลเชิงลึกเกี่ยวกับสิ่งที่เกิดขึ้นในแอปของคุณ เช่น การกระทำของผู้ใช้ เหตุการณ์ของระบบ หรือข้อผิดพลาด
Analytics จะบันทึก เหตุการณ์ บางอย่างให้คุณโดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มรหัสใด ๆ เพื่อรับ หากแอปของคุณต้องการรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกเหตุการณ์ Analytics ได้ถึง 500 ประเภท ในแอปของคุณ ไม่มีการจำกัดปริมาณเหตุการณ์ทั้งหมดที่บันทึกแอปของคุณ โปรดทราบว่าชื่อเหตุการณ์ต้องตรงตามตัวพิมพ์เล็กและใหญ่ และการบันทึกสองเหตุการณ์ที่มีชื่อต่างกันเฉพาะในกรณีที่จะทำให้เกิดสองเหตุการณ์ที่แตกต่างกัน
ก่อนที่คุณจะเริ่มต้น
ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าโครงการของคุณและสามารถเข้าถึง Analytics ตามที่อธิบายไว้ใน เริ่มต้นใช้งาน Analytics
บันทึกเหตุการณ์
หลังจากที่คุณกำหนดค่าอินสแตนซ์ FirebaseApp
แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วยเมธอด logEvent()
เพื่อช่วยคุณในการเริ่มต้น Analytics SDK จะกำหนดเหตุการณ์ที่แนะนำจำนวนหนึ่งซึ่งพบได้ทั่วไปในแอปประเภทต่างๆ รวมถึงแอปค้าปลีกและอีคอมเมิร์ซ การเดินทาง และแอปเกม หากต้องการเรียนรู้เพิ่มเติม เกี่ยวกับเหตุการณ์เหล่านี้ และเวลาที่ควรใช้ โปรดดูที่ เหตุการณ์ที่แนะนำ
คุณสามารถดูรายละเอียดการใช้งานได้ในการอ้างอิงค่าคงที่สำหรับ 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 คุณสามารถใช้มิติข้อมูลที่กำหนดเองสำหรับข้อมูลพารามิเตอร์เหตุการณ์ที่ไม่ใช่ตัวเลขและเมตริกที่กำหนดเองสำหรับข้อมูลพารามิเตอร์ใดๆ ที่แสดงเป็นตัวเลขได้ดีกว่า เมื่อคุณบันทึกพารามิเตอร์ที่กำหนดเองโดยใช้ SDK แล้ว ให้ลงทะเบียนมิติข้อมูลหรือเมตริกเพื่อให้แน่ใจว่าพารามิเตอร์ที่กำหนดเองเหล่านั้นปรากฏในรายงาน Analytics ทำสิ่งนี้ผ่าน: Analytics > เหตุการณ์ > จัดการคำจำกัดความที่กำหนดเอง > สร้างมิติข้อมูลที่กำหนดเอง
สามารถใช้พารามิเตอร์ที่กำหนดเองในการกำหนด ผู้ชม ที่อาจใช้กับทุกรายงาน พารามิเตอร์ที่กำหนดเองจะรวมอยู่ในข้อมูล ที่ส่งออกไปยัง BigQuery ด้วย หากแอปของคุณลิงก์กับโครงการ BigQuery ค้นหาตัวอย่างข้อความค้นหาและอีกมากมายที่ Google Analytics 4 BigQuery Export
พารามิเตอร์
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
สวิฟต์
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
วัตถุประสงค์-C
[FIRAnalytics setDefaultEventParameters:
@{
@"level_name": "Caverns01",
@"level_difficulty": @(4)
}];
หากมีการระบุพารามิเตอร์ในเมธอด logEvent()
ค่านั้นจะถูกใช้แทนค่าดีฟอลต์
หากต้องการล้างพารามิเตอร์เริ่มต้น ให้เรียกเมธอด setDefaultEventParameters
โดยตั้งค่าพารามิเตอร์เป็น nil
ดูเหตุการณ์ในคอนโซลดีบัก Xcode
คุณสามารถเปิดใช้งานการบันทึกแบบละเอียดเพื่อตรวจสอบการบันทึกเหตุการณ์โดย SDK เพื่อช่วยตรวจสอบว่าเหตุการณ์ได้รับการบันทึกอย่างถูกต้อง ซึ่งรวมถึงเหตุการณ์ที่บันทึกไว้ทั้งโดยอัตโนมัติและด้วยตนเอง
คุณสามารถเปิดใช้งานการบันทึกอย่างละเอียดได้ดังนี้:
- ใน Xcode เลือก Product > Scheme > Edit scheme...
- เลือก เรียกใช้ จากเมนูด้านซ้าย
- เลือกแท็บ อาร์กิวเมนต์
- ในส่วน Arguments Passed On Launch ให้เพิ่ม
-FIRAnalyticsVerboseLoggingEnabled
ครั้งต่อไปที่คุณเรียกใช้แอป กิจกรรมของคุณจะแสดงในคอนโซลดีบัก Xcode ซึ่งช่วยให้คุณยืนยันได้ทันทีว่ากำลังส่งเหตุการณ์
ดูเหตุการณ์ในแดชบอร์ด
คุณสามารถดูสถิติรวมเกี่ยวกับกิจกรรมของคุณได้ในแดชบอร์ดของคอนโซล Firebase แดชบอร์ดเหล่านี้อัปเดตเป็นระยะตลอดทั้งวัน สำหรับการทดสอบทันที ให้ใช้เอาต์พุต logcat ตามที่อธิบายไว้ในส่วนก่อนหน้า
คุณเข้าถึงข้อมูลนี้ได้จากแดชบอร์ด เหตุการณ์ ในคอนโซล Firebase แดชบอร์ดนี้แสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์แต่ละประเภทที่แอปของคุณบันทึกไว้