Bắt đầu với Google Analytics

Hướng dẫn bắt đầu nhanh này chỉ cho bạn cách thêm Google Analytics vào ứng dụng của mình và bắt đầu ghi nhật ký 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: Thuộc tính bạn xác định để mô tả các phân đoạn cơ sở người dùng của mình, 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ện và thuộ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 dự án Firebase mới, hãy bật Google Analytics trong quy trình tạo dự án.

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

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

  2. (Được khuyến nghị) . Thêm khung AdSupport vào dự án của bạn để kích hoạ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 File > Add Packages .
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Firebase của Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Chọn thư viện Analytics.
  4. Để 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.
  5. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc của bạn ở chế độ 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ư và việc sử dụng dữ liệu và quyền riêng tư của người dùng cũng như Tính minh bạch trong việc 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 trong UIApplicationDelegate của bạn, cũng như bất kỳ mô-đun Firebase nào khác mà ủy quyền ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:

    SwiftUI

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

    Nhanh

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Mục tiêu-C

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

    SwiftUI

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

    Nhanh

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

    Mục tiêu-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Nếu bạn đang sử dụng SwiftUI, bạn phải tạo một đại biểu ứng dụng và đính kèm nó vào cấu trúc App của mình thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor . Bạn cũng phải tắt chức năng chuyển giao ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn SwiftUI .

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}


(Tùy chọn) Vô hiệu hóa đăng ký thuộc tính mạng quảng cáo của Apple

Để thuận tiện cho bạn, SDK sẽ 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 của bạn.

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

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

Một số sự kiện nhất định được đề xuất cho tất cả ứng dụng ; những cá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 quy định của chúng để đảm bảo 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 trình bày cách ghi nhật ký một 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 Nhật ký sự kiện .

Ví dụ sau đây 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 thành phần cụ thể trong ứng dụng của bạn:

Nhanh

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

Mục tiêu-C

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

Để 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 truyền khi khởi chạy , hãy thêm -FIRAnalyticsDebugEnabled .

Bước tiếp theo