開發人員可以使用 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 代碼管理工具網頁介面中產生預覽網址。請儲存這個預覽網址供後續步驟使用。
如要預覽容器 (如果使用的是 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
發布容器
預覽容器並確認其可正常運作後,您就可以發布容器。發布容器後,行動應用程式使用者便可使用代碼設定。
後續步驟
請參閱進階設定。