ใช้ Google Analytics เพื่อรับตัวชี้วัดสำหรับรายงานข้อขัดข้อง

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

คู่มือนี้อธิบายวิธีเพิ่ม Analytics ลงในแอปที่มีการตั้งค่า Crashlytics (หากยังไม่ได้ ตั้งค่า ให้เพิ่ม Crashlytics ลงในแอปของคุณ )

ขั้นตอนที่ 1: เพิ่มไฟล์การกำหนดค่า Firebase

  1. เปิด การตั้งค่าโครงการ ของคุณ ในการ์ด แอปของคุณ ให้เลือกรหัสชุดของแอปที่คุณต้องการไฟล์การกำหนดค่า
  2. คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่าแพลตฟอร์ม Firebase Apple ของคุณ ( GoogleService-Info.plist )

    • คุณสามารถดาวน์โหลด ไฟล์กำหนดค่าแพลตฟอร์ม Firebase Apple อีกครั้งได้ทุกเมื่อ

    • ตรวจสอบให้แน่ใจว่าชื่อไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (2)

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

หากคุณมี ID บันเดิลหลายรายการในโปรเจ็กต์ของคุณ คุณต้องเชื่อมโยง ID บันเดิลแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist ของตัวเองได้

ขั้นตอนที่ 2: เพิ่ม Analytics SDK ลงในแอปของคุณ

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการพึ่งพา Firebase

  1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Swift Package > Add Package Dependency
  2. เมื่อได้รับแจ้ง ให้เพิ่มพื้นที่เก็บข้อมูล SDK แพลตฟอร์ม Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. เพิ่ม Firebase SDK สำหรับ Google Analytics โดยเลือกไลบรารีที่มีหรือไลบรารีที่ไม่มีการรวบรวม IDFA
  5. เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง

จากนั้นกำหนดค่าโมดูล Firebase:

  1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate ของคุณ รวมถึง โมดูล Firebase อื่นๆ ที่แอปของคุณมอบหมายใช้ ตัวอย่างเช่น หากต้องการใช้ Cloud Firestore และการตรวจสอบสิทธิ์ ให้ทำดังนี้

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    สวิฟท์

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

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

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp ใน application(_:didFinishLaunchingWithOptions:) ของผู้รับมอบสิทธิ์แอปของคุณ:

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    สวิฟท์

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

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

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. หากคุณใช้ SwiftUI คุณต้องสร้างผู้แทนแอปพลิเคชันและแนบไปกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการสลับตัวแทนของแอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          

ตอนนี้แอปของคุณได้รับการตั้งค่าให้ใช้ Google Analytics แล้ว

ขั้นตอนถัดไป