Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Bắt đầu với Google Analytics

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Phần khởi động nhanh này chỉ cho bạn cách thêm Google Analytics vào ứng dụng của bạn và bắt đầu ghi nhật ký các sự kiện.

Google Analytics thu thập dữ liệu sử dụng và hành vi cho ứng dụng của bạn. SDK ghi lại hai loại thông tin chính:

  • Sự kiện: Điều gì đang xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, sự kiện hệ thống hoặc lỗi.
  • Thuộc tính người dùng: Các thuộc tính bạn xác định để mô tả các phân đoạn trong cơ sở người dùng của bạn, chẳng hạn như tùy chọn ngôn ngữ hoặc vị trí địa lý.

Analytics tự động ghi lại một số sự kiệnthuộc tính người dùng ; bạn không cần thêm bất kỳ mã nào để kích hoạt chúng.

Trước khi bắt đầu

  1. Nếu bạn chưa có, hãy thêm Firebase vào dự án Apple của bạn và đảm bảo rằng Google Analytics đã được bật trong dự án Firebase của bạn:

    • Nếu bạn đang tạo một dự án Firebase mới, hãy bật Google Analytics trong quá trình tạo dự án.

    • Nếu bạn đang sử dụng dự án Firebase hiện tại chưa bật Google Analytics, hãy chuyển đến tab Tích hợp trong đặt dự án để bật.

    Khi bạn bật Google Analytics trong dự án của mình, các ứng dụng Firebase của bạn được liên kết với các luồng dữ liệu Google Analytics.

  2. (Khuyến nghị) . Thêm khung AdSupport vào dự án của bạn để bật các tính năng bổ sung như đối tượng và phân bổ chiến dịch.

Thêm SDK Analytics vào ứng dụng của bạn

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc của Firebase.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy điều hướng đến Tệp> Thêm gói .
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Chọn thư viện Analytics.
  5. Để có trải nghiệm tối ưu với Analytics, chúng tôi khuyên bạn nên bật Google Analytics trong dự án Firebase và thêm SDK Firebase cho Google Analytics vào ứng dụng của mình. Bạn có thể chọn thư viện không có bộ sưu tập IDFA hoặc có bộ sưu tập IDFA.
  6. Khi hoàn tất, Xcode sẽ tự động bắt đầu giải quyết và tải xuống các phần phụ thuộc của bạn trong nền.

Tìm hiểu thêm về IDFA, mã nhận dạng quảng cáo cấp thiết bị, trong tài liệu về Quyền riêng tư của người dùng và Sử dụng dữ liệu cũng như Tính minh bạch của Theo dõi ứng dụng của Apple.

Tiếp theo, thực hiện một số bước cấu hình:

  1. Nhập mô-đun FirebaseCore vào UIApplicationDelegate của bạn, cũng như bất kỳ mô-đun Firebase nào khác mà đại biểu ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:

    Nhanh

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Định cấu hình phiên bản được chia sẻ FirebaseApp trong ứng dụng của đại biểu ứng dụng của bạn application(_:didFinishLaunchingWithOptions:) :

    Nhanh

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];


(Tùy chọn) Tắt đăng ký thuộc tính mạng quảng cáo của Apple

Để thuận tiện cho bạn, SDK tự động đăng ký ứng dụng của bạn với Apple để phân bổ mạng quảng cáo với SKAdNetwork . Nếu bạn muốn tắt tính năng này, hãy đặt giá trị của GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED thành NO (Boolean) trong tệp info.plist của ứng dụng.

Bắt đầu ghi nhật ký sự kiện

Sau khi bạn đã định cấu hình phiên bản FirebaseApp , bạn có thể bắt đầu ghi lại các sự kiện bằng phương thức logEvent() .

Các sự kiện nhất định được khuyến nghị cho tất cả các ứng dụng ; những người khác được đề xuất cho các loại hình kinh doanh hoặc ngành dọc cụ thể. Bạn nên gửi các sự kiện được đề xuất cùng với các thông số được chỉ định của chúng, để đảm bảo thông tin chi tiết có sẵn tối đa trong báo cáo của bạn và để hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng có sẵn. Phần này minh họa việc ghi nhật ký sự kiện được xác định trước, để biết thêm thông tin về ghi nhật ký sự kiện, hãy xem Ghi nhật ký sự kiện .

Ví dụ sau minh họa cách ghi lại sự kiện được đề xuất để cho biết người dùng đã nhấp vào một phần tử cụ thể trong ứng dụng của bạn:

Nhanh

Lưu ý: Sản phẩm Firebase này không khả dụng trên macOS target.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

Lưu ý: Sản phẩm Firebase này không khả dụng trên macOS target.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Để xem sự kiện này trong bảng điều khiển gỡ lỗi Xcode, hãy bật gỡ lỗi Analytics:

  1. Trong Xcode, chọn Sản phẩm> Lược đồ> Chỉnh sửa lược đồ ...
  2. Chọn Chạy từ menu bên trái.
  3. Chọn tab Đối số .
  4. Trong phần Đối số được chuyển khi khởi chạy , hãy thêm -FIRAnalyticsDebugEnabled .

Bước tiếp theo