開始使用 iOS+ 專用的 Google Analytics

選取平台：

iOS+ Android Web Flutter Unity C++

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

Google Analytics 會收集應用程式的使用和行為數據。SDK 主要會記錄兩種類型的資訊：

• 事件：應用程式中發生的活動，例如使用者動作、系統事件或錯誤。
• 使用者屬性：您定義的屬性，用來描述使用者族群區隔，例如語言偏好設定或地理位置。

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

事前準備

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

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

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

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

2. (建議) 在專案中加入 AdSupport 框架，以啟用目標對象和廣告活動歸因等其他功能。

在應用程式中加入 Analytics SDK

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

1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」(檔案) 和「Add Packages」(新增 Package)。
2. 系統提示時，請新增 Firebase Apple 平台 SDK 存放區：

  https://github.com/firebase/firebase-ios-sdk.git

3. 選擇 Analytics 程式庫。
4. 在目標建構設定的「Other Linker Flags」部分，新增 -ObjC 標記。
5. 為確保 Analytics 運作順暢，建議您在 Firebase 專案中啟用 Google Analytics，並在應用程式中加入 Google Analytics 專用 Firebase SDK。您可以選擇不收集廣告識別碼 (IDFA) 的程式庫，也可以選擇收集廣告識別碼的程式庫。請參閱常見問題，瞭解 Firebase SDK Google Analytics 中模組的最新組織方式。
6. 完成後，Xcode 會自動開始在背景解析及下載依附元件。

如要進一步瞭解廣告 ID (IDFA)，請參閱 Apple 的使用者隱私權和資料使用和應用程式追蹤透明度說明文件。

接著，請執行下列設定步驟：

1. 在 UIApplicationDelegate 中匯入 FirebaseCore 模組，以及應用程式委派使用的任何其他 Firebase 模組。舉例來說，如要使用 Cloud Firestore 和 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. 在應用程式委派的 application(_:didFinishLaunchingWithOptions:) 方法中，設定 FirebaseApp 共用例項：

   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. 如果您使用 SwiftUI，則必須建立應用程式委派，並透過 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 將其附加至 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() 方法開始記錄事件。

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

以下範例說明如何記錄建議事件，指出使用者點擊了應用程式中的特定元素：

如要在 Xcode 偵錯控制台中查看這項事件，請啟用 Analytics 偵錯功能：

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

後續步驟

• 瞭解各項 Analytics 報表。
• 使用 DebugView 驗證事件。
• 在 Firebase 控制台中探索資料。
• 請參閱事件和使用者屬性指南。
• 瞭解如何將資料匯出至 BigQuery。