開發人員可以使用 Google 代碼管理工具在行動應用程式中導入及管理評估代碼和像素,不必重新建構應用程式二進位檔並重新提交到應用程式市集。使用 Google Analytics for Firebase SDK 的開發人員可以輕鬆加入 Google 代碼管理工具,以便管理和調整導入作業,即使應用程式已出貨也不受影響。
開發人員可以記錄重要事件,並在稍後決定要觸發哪些代碼或像素。
必要條件
- 在 Firebase 主控台內,將您的應用程式新增至 Firebase 專案中。
- 為應用程式設定 Google Analytics (分析),包括在 Firebase 專案中啟用 Google Analytics (分析),以及將 Google Analytics for Firebase SDK 新增至應用程式。
- 建立代碼管理工具帳戶。
- 設定代碼管理工具容器。
以下各節將逐步引導您在 iOS 應用程式中設定及使用 Google 代碼管理工具。
1. 在專案中新增代碼管理工具
新增代碼管理工具套件:
CocoaPods
如要透過 CocoaPods 新增代碼管理工具,請按照下列步驟操作:
在終端機中執行下列指令:
$ sudo gem install cocoapods
變更為您的專案目錄。
執行下列指令,建立名為
Podfile
的檔案:$ pod init
在
Podfile
中新增以下內容:pod 'GoogleTagManager', '~> 6.0'
執行下列指令,在專案中下載並安裝代碼管理工具依附元件:
$ pod install
Swift 套件管理員
如何透過 Swift Package Manager 加入代碼管理工具:
- 如果是從 CocoaPods 型專案遷移,請執行
pod deintegrate
來從 Xcode 專案中移除 CocoaPods。之後,您可以放心刪除 CocoaPods 產生的.xcworkspace
檔案。如果您是第一次將 Firebase 加入專案,可以忽略這個步驟。 - 在 Xcode 12 中,前往「File」>「Tag Manager Packages」>「Add Package Dependency...」安裝代碼管理工具程式庫。
在隨即顯示的提示中,輸入代碼管理工具的 GitHub 存放區:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
選取您要使用的代碼管理工具版本。如果是新專案,建議您使用最新版的代碼管理工具。
在您專案的「Build Settings」中,將
-ObjC
新增至「Other Linker Flags」(其他連結器旗標)。
如果代碼管理工具帳戶沒有 iOS 容器,請建立一個:
- 登入代碼管理工具帳戶。
- 按一下頂端導覽列中的「管理」。
- 按一下「CONTAINER」CONTAINER欄中的下拉式選單,然後選取「CREATE CONTAINER」CONTAINER。
- 輸入容器名稱。
- 選取「iOS」iOS容器。
- 選取「Firebase (iOS)」SDK。
- 點選「建立」。
下載容器:
- 登入代碼管理工具帳戶。
- 選取 iOS 容器。
- 按一下頂端導覽列中的「版本」。
在選取的容器版本中,按一下「動作」>「下載」。
將下載的容器新增至專案:
- 將下載的檔案複製到 XCode 專案根目錄 (通常為
PROJECT_ROOT/container/GTM-XXXXXX.json
) 中名為container
的資料夾。 - 開啟 Xcode。
- 從「檔案」選單中,選擇「將檔案新增至...」。
- 選取
container
資料夾。 - 按一下「Options」(選項),並確認已選取「Create folder reference」(建立資料夾參照)。
- 按一下「Finish」。
- 將下載的檔案複製到 XCode 專案根目錄 (通常為
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
和:
- 變數名稱:全文
- 變數類型:事件參數
- 事件參數鍵名稱:
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 來開啟應用程式,藉此預覽容器版本。
預覽容器
如要預覽容器,請在代碼管理工具網頁介面中產生預覽網址:
- 登入代碼管理工具帳戶。
- 請選取行動容器。
- 按一下頂端導覽列中的「版本」。
- 在要預覽的容器版本上,按一下「動作」>「預覽」。
- 輸入應用程式的套件名稱。
按一下「產生開始預覽連結」。
儲存這個預覽網址,用於後續步驟。
如要啟用容器預覽,您必須在專案的屬性清單中定義代碼管理工具預覽網址配置。在應用程式屬性清單檔案的「URL Type」下方,註冊下列網址 ID 和網址配置:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
請停止應用程式,並在模擬器或實體裝置上開啟預覽網址,以便在應用程式中預覽草稿容器。
偵錯容器
以模擬器或預覽模式執行應用程式時,代碼管理工具會自動關閉詳細記錄,
發布容器
預覽容器並確認容器是否正常運作後,即可發布容器。發布容器後,行動應用程式使用者就能使用您的代碼設定。
相關資源
參閱進階設定。