iOS 版 Google 代碼管理工具

開發人員可以使用 Google 代碼管理工具在行動應用程式中導入及管理評估代碼和像素,不必重新建構應用程式二進位檔並重新提交到應用程式市集。使用 Google Analytics for Firebase SDK 的開發人員可以輕鬆加入 Google 代碼管理工具,以便管理和調整導入作業,即使應用程式已出貨也不受影響。

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

必要條件

以下各節將逐步引導您在 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 Package Manager 加入代碼管理工具:

    1. 如果是從 CocoaPods 型專案遷移,請執行 pod deintegrate 來從 Xcode 專案中移除 CocoaPods。之後,您可以放心刪除 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. 在您專案的「Build Settings」中,將 -ObjC 新增至「Other Linker Flags」(其他連結器旗標)

  2. 如果代碼管理工具帳戶沒有 iOS 容器,請建立一個:

    1. 登入代碼管理工具帳戶。
    2. 按一下頂端導覽列中的「管理」
    3. 按一下「CONTAINER」CONTAINER欄中的下拉式選單,然後選取「CREATE CONTAINER」CONTAINER
    4. 輸入容器名稱。
    5. 選取「iOS」iOS容器。
    6. 選取「Firebase (iOS)」SDK。
    7. 點選「建立」。
  3. 下載容器:

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

  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_namefull_text parameter 值:

  • 變數名稱:圖片名稱
  • 變數類型:事件參數
  • 事件參數鍵名稱image_name

和:

  • 變數名稱:全文
  • 變數類型:事件參數
  • 事件參數鍵名稱full_text

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

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

接著,您可以在 Google 代碼管理工具中設定新的 Firebase 使用者屬性變數,以便擷取 favorite_food 值:

  • 變數名稱:最愛的食物
  • Variable Type: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 Type」下方,註冊下列網址 ID 和網址配置:

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

請停止應用程式,並在模擬器或實體裝置上開啟預覽網址,以便在應用程式中預覽草稿容器。

偵錯容器

以模擬器或預覽模式執行應用程式時,代碼管理工具會自動關閉詳細記錄,

發布容器

預覽容器並確認容器是否正常運作後,即可發布容器。發布容器後,行動應用程式使用者就能使用您的代碼設定。

參閱進階設定