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


Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn 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ề mức sử dụng và hành vi cho ứng dụng của bạn. SDK ghi nhật ký hai loại thông tin chính:

  • Sự kiện: Những 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, 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 người dùng cơ sở người dùng, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.

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

Trước khi bắt đầu

  1. Thêm Firebase vào dự án Apple của bạn nếu bạn chưa thêm và đảm bảo bạn đã bật Google Analytics trong Firebase dự án:

    • Nếu bạn đang tạo một 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 không có Đã bật Google Analytics, hãy chuyển đến Các công cụ tích hợp trong số > 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 được liên kết với Google Analytics luồng dữ liệu.

  2. (Nên dùng). Thêm khung AdSupport vào project để bật các tính năng bổ sung chẳng hạn 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 của bạn đang mở, hãy chuyển đế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 của Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Chọn thư viện Analytics.
  5. Thêm cờ -ObjC vào mục Cờ trình liên kết khác trong chế độ cài đặt bản dựng của mục tiêu.
  6. Để 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 Firebase SDK cho Google Analytics vào ứng dụng của bạn. Bạn có thể hãy chọn thư viện không thu thập IDFA hoặc có thu thập IDFA.
  7. 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 trong 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 Apple Quyền riêng tư và việc sử dụng dữ liệu của người dùngMinh bạch về việc theo dõi ứng dụng tài liệu.

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ư bất kỳ tên nào khác Các mô-đun Firebase mà người được uỷ quyền sử dụng. Ví dụ: để sử dụng Cloud FirestoreAuthentication:

    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 FirebaseApp thực thể dùng chung trong Phương thức application(_:didFinishLaunchingWithOptions:):

    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 ứng dụng uỷ quyền và đính kèm nó đến cấu trúc App của bạn thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng uỷ quyền ứng dụng. Cho hãy xem hướng dẫn về SwiftUI để biết thêm thông tin.

    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ý 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 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 đến 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 cho thực thể FirebaseApp, bạn có thể bắt đầu ghi nhật ký sự kiện với logEvent() .

Một số sự kiện nên dùng cho tất cả các ứng dụng; các phương pháp 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ố quy định của sự kiện đó, để đảm bảo tối đa thông tin chi tiết có sẵn trong báo cáo của bạn, cũng như để hưởng lợi từ các tính năng và khi có thể sử dụng. Phần này minh hoạ việc 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 bài viết Ghi nhật ký sự kiện.

Ví dụ sau minh hoạ cách ghi lại một 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:

Swift

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

Objective-C

Lưu ý: Sản phẩm Firebase này không dành cho macOS mục tiêu.
[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 của Xcode, hãy bật tính năng gỡ lỗi Analytics:

  1. Trong Xcode, hãy chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ...
  2. Chọn Run (Chạy) trên trình đơn bên trái.
  3. Chọn thẻ Arguments (Đối số).
  4. Trong phần Đối số đã thông qua khi khởi chạy, hãy thêm -FIRAnalyticsDebugEnabled.

Các bước tiếp theo