Android 版 Google 代碼管理工具

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

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

必備條件

事前準備:

以下各節將逐步引導您在 Android 應用程式中設定及使用 Google 代碼管理工具。

1. 在專案中新增 Google 代碼管理工具

  1. 在模組 Gradle 檔案 (通常是 app/build.gradle) 中,在代碼管理工具程式庫中新增以下依附元件:

    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:18.0.3'
    }
    
  2. 登入代碼管理工具帳戶。

  3. 請選取行動容器。

  4. 按一下頂端導覽列中的「版本」

  5. 按一下您要使用的容器版本。

  6. 按一下「下載」

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

  • 變數名稱:圖片名稱
  • Variable Type:事件參數
  • 事件參數鍵名稱image_name

和:

  • Variable Name:全名
  • Variable Type:事件參數
  • 事件參數鍵名稱full_text

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

接著,您可以在 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. 預覽、偵錯及發布容器

發布容器版本之前,建議您預覽該版本,確保能正常運作。Google 代碼管理工具可讓您在網頁介面上產生連結和 QR 圖碼,並藉此開啟應用程式,讓您預覽容器的版本。您也可以啟用詳細記錄模式,對任何非預期的行為進行偵錯。

預覽容器

在預覽容器之前,請先預覽您要預覽的容器版本,然後選取「預覽」,在 Google 代碼管理工具網頁介面中產生預覽網址。請儲存這個預覽網址供後續步驟使用。

您可以在代碼管理工具網頁介面的預覽視窗中看到預覽網址
圖 1: 從代碼管理工具網頁介面取得預覽網址。

如要預覽容器 (如果您使用的是 Android Studio,請跳至步驟 3):

  1. 將此預覽活動新增至 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>
    
  2. 變更這一行即可包含應用程式的套件名稱:

    <data android:scheme="tagmanager.c.com.example.app"/>
    
  3. 在 Google 代碼管理工具網頁介面中,產生預覽連結:

    1. 登入代碼管理工具帳戶。
    2. 請選取行動容器。
    3. 按一下頂端導覽列中的「版本」
    4. 在要預覽的容器版本上,依序按一下「動作」>「預覽」
    5. 輸入應用程式的套件名稱。
    6. 按一下「產生啟動預覽連結」
  4. 停止應用程式,並使用產生的預覽連結或 QR 圖碼來啟動應用程式。

  5. 您可以按一下網頁介面中「產生結束預覽連結」選項產生的連結,來離開預覽模式。

偵錯容器

如要排解容器導入問題,請啟用詳細記錄功能:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

發布容器

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

後續步驟

參閱進階設定