開始使用 Google Analytics


本快速入門導覽課程說明如何在應用程式中新增 Google Analytics,並開始記錄事件。

Google Analytics 會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要資訊:

  • 事件:應用程式的動態 (例如使用者動作、系統事件或錯誤)。
  • 使用者屬性:您定義的屬性,用來描述使用者族群區隔,例如語言偏好設定或地理位置。

Analytics會自動記錄部分事件使用者屬性,您不必新增任何程式碼即可啟用這些屬性。

事前準備

  1. 如果您尚未將 Firebase 新增至 Apple 專案,請先新增,並確認 Firebase 專案中已啟用 Google Analytics

    • 如果您要建立新的 Firebase 專案,請在專案建立工作流程中啟用 Google Analytics

    • 如果您使用的現有 Firebase 專案未啟用 Google Analytics,請前往「專案」設定的「整合」分頁標籤 >「專案設定」 啟用。

    在專案中啟用 Google Analytics 後,Firebase 應用程式就會連結至 Google Analytics 資料串流。

  2. (建議)在專案中加入 AdSupport 架構,即可啟用其他功能,例如目標對象和廣告活動歸因。

在應用程式中新增「Analytics」SDK

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

  1. 在 Xcode 中保持開啟應用程式專案,然後依序點選「File」(檔案) 和「Add Packages」(新增 Package)
  2. 系統提示時,請新增 Firebase Apple 平台 SDK 存放區:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. 選擇 Analytics 程式庫。
  5. -ObjC 標記新增至目標建構設定的「Other Linker Flags」部分。
  6. 為獲得最佳 Analytics 使用體驗,建議您在 Firebase 專案中啟用 Google Analytics,並在應用程式中加入 Google Analytics 專用 Firebase SDK。您可以選擇不收集 IDFA 的程式庫,也可以選擇收集 IDFA 的程式庫。請參閱常見問題,瞭解 Firebase SDK 中 Google Analytics 的最新模組架構。
  7. 完成後,Xcode 會自動開始在背景中解析並下載依附元件。

如要進一步瞭解裝置層級的廣告識別碼「廣告識別碼」,請參閱 Apple 的「使用者隱私權和資料使用」和「應用程式追蹤透明度」文件。

接著,請執行一些設定步驟:

  1. FirebaseCore 中匯入 UIApplicationDelegate 模組,以及應用程式委派使用的任何其他 Firebase 模組。舉例來說,如要使用 Cloud FirestoreAuthentication
    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          
    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在應用程式委派的 application(_:didFinishLaunchingWithOptions:) 方法中,設定 FirebaseApp 共用例項:
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您使用 SwiftUI,就必須建立應用程式委派,並透過 UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor 將其附加至 App 結構體。您也必須停用應用程式委派項目的交換。詳情請參閱 SwiftUI 指示
    SwiftUI
    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


(選用) 停用 Apple 廣告聯播網歸因註冊

為方便起見,SDK 會自動向 Apple 註冊您的應用程式,以透過 SKAdNetwork 進行廣告聯播網歸因。如要停用這項功能,請在應用程式的 info.plist 檔案中,將 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED 的值設為 NO (布林值)。

開始記錄事件

設定 FirebaseApp 執行個體後,您就可以開始使用 logEvent() 方法記錄事件。

某些事件建議所有應用程式採用,其他事件則建議特定類型的商家或產業採用。建議您傳送包含規定參數的建議事件,這樣報表就能呈現最詳盡的資料,也方便您日後使用新推出的功能和整合服務。本節說明如何記錄預先定義的事件。如要進一步瞭解如何記錄事件,請參閱「記錄事件」。

以下範例說明如何記錄建議事件,指出使用者已點選應用程式中的特定元素:

SwiftObjective-C

注意:macOS 目標不支援這項 Firebase 產品。
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

注意:macOS 目標不支援這項 Firebase 產品。
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

如要在 Xcode 偵錯控制台中查看這個事件,請啟用 Analytics 偵錯功能:

  1. 在 Xcode 中,依序選取「Product」>「Scheme」>「Edit scheme...」
  2. 在左選單中選取「Run」
  3. 選取「Arguments」分頁標籤。
  4. 在「Arguments Passed On Launch」部分中,加入 -FIRAnalyticsDebugEnabled

後續步驟