iOS 版 Google 代碼管理工具

開發人員可以使用 Google 代碼管理工具在行動應用程式中導入及管理評估代碼和像素，不必重新建立應用程式二進位檔並重新提交至應用程式市集。使用 Google Analytics for Firebase SDK 的開發人員可輕鬆新增代碼管理工具，以便管理和修改導入內容，即使應用程式已推出也一樣。

開發人員可以記錄重要事件，並決定稍後要觸發哪些代碼或像素。

先備知識

以下各節逐步說明在 iOS 應用程式中設定及使用 Google 代碼管理工具的步驟。

1. 在專案中加入代碼管理工具

  1. 新增代碼管理工具套件：

    CocoaPods

    透過 CocoaPods 新增代碼管理工具：

    1. 在終端機中執行下列指令：

      $ sudo gem install cocoapods

    2. 切換至專案目錄。

    3. 執行下列指令，建立名為 Podfile 的檔案：

      $ pod init

    4. 在 Podfile 中新增以下內容：

      pod 'GoogleTagManager', '~> 6.0'

    5. 執行下列指令，為專案下載並安裝代碼管理工具依附元件：

      $ pod install

    Swift 套件管理工具

    透過 Swift 套件管理工具新增代碼管理工具：

    1. 如果是從 CocoaPods 為基礎的專案遷移，請執行 pod deintegrate 來將 CocoaPods 從 Xcode 專案中移除。之後可以安全刪除 CocoaPods 產生的 .xcworkspace 檔案。若是第一次將 Firebase 新增至專案，您可以忽略這個步驟。
    2. 在 Xcode 12 中，依序前往「File」>「Tag Manager Packages」>「Add Package Dependency...」，安裝代碼管理工具程式庫。

    3. 在畫面上出現的提示中，輸入代碼管理工具 GitHub 存放區：

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git

    4. 選取您想要使用的代碼管理工具版本。如果是新專案，建議您使用最新版代碼管理工具。

    5. 將 -ObjC 新增至專案「Build Settings」中的「Other Linker Flags」。

  2. 如果您的代碼管理工具帳戶沒有 iOS 容器，請建立該容器：

    1. 登入代碼管理工具帳戶。
    2. 在「Accounts」分頁中，選取 iOS 容器。
    3. 按一下頂端導覽列中的「管理」。
    4. 在「容器」CONTAINER欄中，按一下「+」圖示建立容器。
    5. 輸入容器名稱。
    6. 選取「iOS」iOS容器。
    7. 點選「Create」(建立)。

  3. 下載容器：

    1. 登入代碼管理工具帳戶。
    2. 在「Accounts」分頁中，選取 iOS 容器。
    3. 按一下頂端導覽列中的「版本」。
    4. 選取要下載的容器版本。

    5. 點選「下載」。

  4. 將下載的容器加入專案中：

    1. 將下載的檔案複製到 XCode 專案根目錄 (通常是 PROJECT_ROOT/container/GTM-XXXXXX.json) 中名為 container 的資料夾。
    2. 開啟 Xcode。
    3. 在「檔案」選單中，選擇「將檔案新增至...」。
    4. 選取 container 資料夾。
    5. 按一下「Options」，並確認已選取「Create folder reference」。
    6. 按一下「Finish」(完成)。

2. 記錄事件和變數

代碼管理工具會使用 Google Analytics for Firebase SDK 記錄的事件、參數和使用者屬性，觸發及建立您在 Google 代碼管理工具中設定的代碼。

請參閱 Firebase 開發人員說明文件，瞭解如何記錄事件及設定使用者屬性。

在代碼管理工具中設定變數

如要擷取事件參數和使用者屬性的值，以便在 Google 代碼管理工具中使用，您可以在代碼管理工具介面中設定變數。

舉例來說，您可以在應用程式中記錄下列自訂事件：

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

接著，您可以按照下列步驟在代碼管理工具中設定新的事件參數變數，擷取 image_name 和 full_text parameter 值：

  • 變數名稱：映像檔名稱
  • 變數類型：事件參數
  • 事件參數鍵名稱：image_name

和：

  • 「Variable Name」：Full Text
  • 變數類型：事件參數
  • 事件參數鍵名稱：full_text

同樣地，您可以在應用程式中設定下列使用者屬性：

Analytics.setUserProperty(food, forName: "favorite_food")

然後在 Google 代碼管理工具中設定新的 Firebase 使用者屬性變數來擷取 favorite_food 值：

  • 「Variable Name」：Favorite Food
  • 變數類型：Firebase 使用者屬性
  • 事件參數鍵名稱：favorite_food

修改及封鎖事件

您可以使用代碼管理工具，在 Google Analytics for Firebase SDK 記錄事件前修改及封鎖事件。修改事件可協助您新增、移除或變更事件參數值，或調整事件名稱，而不必更新應用程式。Google Analytics for Firebase SDK 會記錄未封鎖的事件。

Google Analytics for Firebase SDK 也會自動記錄部分事件及使用者屬性。您可以在代碼管理工具中使用自動收集的事件和屬性，不需要新增任何程式碼。但無法加以封鎖。

3. 傳送事件

系統會使用 Firebase 事件名稱變數、Firebase 事件參數變數和其他變數，設定觸發條件。每當您記錄 Firebase 事件時，系統就會評估觸發條件。根據預設，Google Analytics for Firebase 事件會自動觸發。您可以在代碼管理工具中加入 Google Analytics for Firebase 代碼，防止事件傳送至 Google Analytics (分析)。

4. 預覽、偵錯及發布容器

建議您在發布容器版本之前進行預覽，確保該版本能正常運作。代碼管理工具可讓您預覽容器版本的容器，方法是在代碼管理工具的網頁介面中產生連結和 QR code，並使用這些項目開啟應用程式。

預覽容器

如要預覽容器，請在代碼管理工具網頁介面中產生預覽網址：

  1. 登入代碼管理工具帳戶。
  2. 請選取行動容器。
  3. 按一下頂端導覽列中的「版本」。
  4. 在要預覽的容器版本上，依序點選「動作」>「預覽」。
  5. 輸入應用程式的套件名稱。

  6. 按一下「產生開始預覽連結」。

    您可在代碼管理工具網頁介面的預覽視窗中查看預覽網址

    圖 1： 從代碼管理工具網頁介面取得預覽網址。

    請儲存這個預覽網址供後續步驟使用。

如要啟用容器預覽，您必須在專案的屬性清單中定義代碼管理工具的預覽網址配置。在應用程式屬性清單檔案的「URL types」下方，註冊下列網址 ID 和網址配置：

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
在應用程式的屬性清單檔案中註冊代碼管理工具預覽網址配置。
圖 2： 在應用程式的屬性清單檔案中加入代碼管理工具預覽網址配置。

停止應用程式，並在模擬器或實體裝置中開啟預覽網址，即可在應用程式中預覽草稿容器。

偵錯容器

當您在模擬器或預覽模式下執行應用程式時，代碼管理工具會自動啟用詳細記錄功能。

發布容器

預覽容器並確認其可正常運作後，您就可以發布容器。發布容器後，行動應用程式使用者便可使用代碼設定。

請參閱進階設定。