開發人員可以使用 Google 代碼管理工具在行動應用程式中導入及管理評估代碼和像素,不必重新建立應用程式二進位檔並重新提交至應用程式市集。使用 Google Analytics for Firebase SDK 的開發人員可輕鬆新增代碼管理工具,以便管理和修改導入內容,即使應用程式已推出也一樣。
開發人員可以記錄重要事件,並決定稍後要觸發哪些代碼或像素。
先備知識
事前準備:
- 在 Firebase 主控台內,將您的應用程式新增至 Firebase 專案中。
- 為應用程式設定 Google Analytics (分析),包括在 Firebase 專案中啟用 Google Analytics (分析),以及將 Google Analytics for Firebase SDK 新增至應用程式。
- 建立代碼管理工具帳戶。
- 設定 Google 代碼管理工具容器。
以下各節逐步說明在 Android 應用程式中設定及使用 Google 代碼管理工具的步驟。
1. 在專案中加入 Google 代碼管理工具
在模組 Gradle 檔案 (通常是
app/build.gradle
) 中,將下列依附元件加入代碼管理工具的程式庫:dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.1.0' }
登入代碼管理工具帳戶。
請選取行動容器。
按一下頂端導覽列中的「版本」。
按一下要使用的容器版本。
點選「下載」。
如果
app/src/main/assets/containers
資料夾不存在,請建立該資料夾。將下載的容器複製到資料夾。
2. 記錄事件和變數
代碼管理工具會使用 Google Analytics for Firebase SDK 記錄的事件、參數和使用者屬性,觸發及建立您在 Google 代碼管理工具中設定的代碼。
請參閱 Firebase 開發人員說明文件,瞭解如何記錄事件及設定使用者屬性。
在代碼管理工具中設定變數
如要擷取事件參數和使用者屬性的值,以便在 Google 代碼管理工具中使用,您可以在代碼管理工具介面中設定變數。
舉例來說,您可以在應用程式中記錄下列自訂事件:
Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
接著,您可以按照下列步驟在代碼管理工具中設定新的事件參數變數,擷取 image_name
和 full_text parameter
值:
- 變數名稱:映像檔名稱
- 變數類型:事件參數
- 事件參數鍵名稱:
image_name
和:
- 「Variable Name」:Full Text
- 變數類型:事件參數
- 事件參數鍵名稱:
full_text
同樣地,您可以在應用程式中設定下列使用者屬性:
mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);
然後在 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. 預覽、偵錯及發布容器
建議您在發布容器版本之前進行預覽,確保該版本能正常運作。Google 代碼管理工具可讓您預覽容器版本,方法是在網頁介面中產生連結和 QR code,並使用這些項目開啟應用程式。您也可以啟用詳細記錄模式,對任何非預期的行為進行偵錯。
預覽容器
預覽容器之前,請先選取要預覽的容器版本,然後選取「預覽」,在 Google 代碼管理工具網頁介面中產生預覽網址。請儲存這個預覽網址供後續步驟使用。
![您可在代碼管理工具網頁介面的預覽視窗中查看預覽網址](https://developers.google.cn/static/tag-platform/tag-manager/images/preview_example.png?authuser=4&hl=zh-tw)
如要預覽容器 (如果使用的是 Android Studio,請跳至步驟 3):
將此預覽活動加入
AndroidManifest
檔案:<!-- Add preview activity. --> <activity android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity" android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. --> <intent-filter> <data android:scheme="tagmanager.c.com.example.app" /> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE"/> </intent-filter> </activity>
請變更這一行,加入應用程式的套件名稱:
<data android:scheme="tagmanager.c.com.example.app"/>
在 Google 代碼管理工具網頁介面中產生預覽連結:
- 登入代碼管理工具帳戶。
- 請選取行動容器。
- 按一下頂端導覽列中的「版本」。
- 在要預覽的容器版本上,依序點選「動作」>「預覽」。
- 輸入應用程式的套件名稱。
- 按一下「產生開始預覽連結」。
停止應用程式,然後使用產生的預覽連結或 QR code 啟動應用程式。
在網頁介面中,按一下「Generate end Preview link」選項所產生的連結,即可退出預覽模式。
偵錯容器
若要排解容器導入問題,請啟用詳細記錄功能:
$ adb shell setprop log.tag.GoogleTagManager VERBOSE
發布容器
預覽容器並確認其可正常運作後,您就可以發布容器。發布容器後,行動應用程式使用者便可使用代碼設定。
後續步驟
請參閱進階設定。