Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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.

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 bạn và bắt đầu ghi nhật ký các sự kiện.

Google Analytics thu thập dữ liệu hành vi và 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: Đ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 mình, chẳng hạn như tùy chọn ngôn ngữ hoặc vị trí địa lý.

Analytics tự động ghi nhật ký 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 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 tại chưa bật Google Analytics, hãy chuyển đến tab Tích hợp trong đặt dự án để bật dự án.

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

  2. (Khuyê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à 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 Apple của 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 của mình và thêm SDK Firebase dành cho Google Analytics vào ứng dụng của bạn. 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, số nhận dạng quảng cáo cấp thiết bị, trong tài liệu về Tính minh bạch của ứng dụng và quyền riêng tư của người dùng và sử dụng dữ liệutheo dõi ứng dụng .

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à ứng dụng ủy quyền 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 một phiên bản chia sẻ FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của ứ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 đ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 vô hiệu hóa tính năng xoay đại biểu của ứ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ý 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 thành NO (Boolean) trong tệp info.plist của ứng dụng.

Bắt đầu ghi 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 nhật ký sự kiện bằng phương thức logEvent() .

Một số sự kiện đượ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ố đã quy định của chúng để đảm bảo báo cáo của bạn có chi tiết tối đa và hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng khả dụng. 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ề việc ghi nhật ký sự kiện, hãy xem Nhật ký sự kiện .

Ví dụ sau minh họa cách ghi nhật ký 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 mục tiêu macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không khả dụng trên mục tiêu macOS.
[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 truyền khi khởi chạy , hãy thêm -FIRAnalyticsDebugEnabled .

Bước tiếp theo

,

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 bạn và bắt đầu ghi nhật ký các sự kiện.

Google Analytics thu thập dữ liệu hành vi và 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: Đ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 mình, chẳng hạn như tùy chọn ngôn ngữ hoặc vị trí địa lý.

Analytics tự động ghi nhật ký 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 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 tại chưa bật Google Analytics, hãy chuyển đến tab Tích hợp trong đặt dự án để bật dự án.

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

  2. (Khuyê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à 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 Apple của 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 của mình và thêm SDK Firebase dành cho Google Analytics vào ứng dụng của bạn. 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, số nhận dạng quảng cáo cấp thiết bị, trong tài liệu về Tính minh bạch của ứng dụng và quyền riêng tư của người dùng và sử dụng dữ liệutheo dõi ứng dụng .

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à ứng dụng ủy quyền 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 một phiên bản chia sẻ FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của ứ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 đ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 vô hiệu hóa tính năng xoay đại biểu của ứ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ý 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 thành NO (Boolean) trong tệp info.plist của ứng dụng.

Bắt đầu ghi 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 nhật ký sự kiện bằng phương thức logEvent() .

Một số sự kiện đượ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ố đã quy định của chúng để đảm bảo báo cáo của bạn có chi tiết tối đa và hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng khả dụng. 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ề việc ghi nhật ký sự kiện, hãy xem Nhật ký sự kiện .

Ví dụ sau minh họa cách ghi nhật ký 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 mục tiêu macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Mục tiêu-C

Lưu ý: Sản phẩm Firebase này không khả dụng trên mục tiêu macOS.
[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 truyền khi khởi chạy , hãy thêm -FIRAnalyticsDebugEnabled .

Bước tiếp theo