Bắt đầu sử dụng Google Analytics


Phần hướng dẫn nhanh này cho bạn biết cách thêm Google Analytics vào ứng dụng và bắt đầu ghi nhật ký sự kiện.

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

  • Sự kiện: Những gì đang diễn ra trong ứng dụng, chẳng hạn như thao tác của người dùng, các sự kiện của hệ thống hoặc lỗi.
  • Thuộc tính người dùng: Những thuộc tính mà bạn xác định để mô tả các phân khúc trong cơ sở người dùng, chẳng hạn như lựa chọn ưu tiên về 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 mã nào để bật các thuộc tính này.

Trước khi bắt đầu

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

    • 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 một dự án Firebase hiện có chưa bật Google Analytics, hãy chuyển đến thẻ Tích hợp của > Cài đặt dự án để bật tính năng này.

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

  2. (Nên dùng). 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à mô hình phân bổ chiến dịch.

Thêm SDK Analytics vào ứng dụng

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 Firebase.

  1. Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK của các nền tảng Apple của Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Chọn thư viện Analytics.
  4. Thêm cờ -ObjC vào phần Other Linker Flags (Cờ trình liên kết khác) trong chế độ cài đặt bản dựng của mục tiêu.
  5. Để có trải nghiệm tối ưu với Analytics, 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. Bạn có thể chọn thư viện không có tính năng thu thập IDFA hoặc có tính năng thu thập IDFA.
  6. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.

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

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

  1. Nhập mô-đun FirebaseCore trong UIApplicationDelegate, cũng như mọi mô-đun Firebase khác mà ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Authentication:

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Định cấu hình một bản sao dùng chung FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của uỷ quyền ứng dụng:

    SwiftUI

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

    Swift

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

    Objective-C

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

    SwiftUI

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

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


(Không bắt buộc) Tắt tính năng đăng ký mô hình phân bổ 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 bằng 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 định cấu hình thực thể FirebaseApp, bạn có thể bắt đầu ghi lại các sự kiện bằng phương thức logEvent().

Một số sự kiện được đề xuất cho tất cả ứng dụng; còn một số sự kiện khác được đề xuất cho các loại hình doanh nghiệp hoặc ngành dọc cụ thể. Bạn nên gửi sự kiện được đề xuất cùng với thông số được quy định cho sự kiện đó để đảm bảo báo cáo có được thông tin chi tiết tối đa, đồng thời để khai thác lợi ích từ các tính năng cũng như công cụ tích hợp sẽ ra mắt trong tương lai. Phần này minh hoạ 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ề cách ghi nhật ký sự kiện, hãy xem phần Ghi nhật ký sự kiện.

Ví dụ sau đây minh hoạ cách ghi nhật ký một 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:

Swift

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

Objective-C

Lưu ý: Sản phẩm Firebase này không có 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 tính năng gỡ lỗi Analytics:

  1. Trong Xcode, hãy chọn Product > Scheme > Edit scheme... (Sản phẩm > Lược đồ > Chỉnh sửa lược đồ)
  2. Chọn Run (Chạy) trong trình đơn bên trái.
  3. Chọn thẻ Arguments (Đối số).
  4. Trong mục Arguments Passed On Launch (Đối số được chuyển khi mở), hãy thêm -FIRAnalyticsDebugEnabled.

Các bước tiếp theo