行動應用程式適用的使用者定義變數類型

您可以配合內建變數可能尚無法處理的特定需求，在 Google 代碼管理工具中建立行動應用程式適用的使用者定義自訂變數。

建立新的使用者定義變數的做法如下：

1. 在左側導覽窗格中按一下 [變數]。
2. 在「使用者定義的變數」部分，按一下 [新增]。
3. 按一下 [變數設定]，然後選取所需的變數類型。
4. 為選定的變數類型完成選項設定。
5. 為變數命名 (請取個能夠描述變數用途的名字，例如「資料層變數 - 產品名稱」)。
6. 按一下 [儲存]。

代碼管理工具可支援下列幾種使用者定義的行動應用程式適用變數：

• Firebase
  • 事件名稱
  • 事件參數
  • Firebase 使用者屬性
• 公用程式
  • 已啟用廣告客戶追蹤
  • 固定常數
  • Google Analytics (分析) 設定
  • 對照表
  • 隨機數字
• 容器資料
  • 容器 ID
  • 容器版本號碼
• 應用程式
  • 應用程式 ID
  • 應用程式名稱
  • 應用程式版本代碼
  • 廣告 ID
  • SDK 版本
• 裝置
  • 裝置名稱
  • 語言
  • 作業系統版本
  • 平台
  • 螢幕解析度
• 其他
  • 函式呼叫
  • 值組合 (舊版)

Firebase

事件名稱

應用程式裡的程式碼 (如下所示) 執行時，這個值會是「eventNameXYZ」：

Android：
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);

iOS：
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];

在多數情況下，您都應該使用對應的內建變數。

事件參數

這個值會是指定鍵的 Google Analytics (分析) (Firebase) 事件參數值。

Firebase 使用者屬性

這個值會是指定鍵的 Google Analytics (分析) (Firebase) 使用者屬性值。

公用程式

已啟用廣告客戶追蹤

如果是 Android 平台且啟用了廣告追蹤功能，變數會傳回 True；要是使用者停用了「按照興趣顯示的廣告」選項，則會傳回 False，相關詳情請參閱 Google Developers 中心為 Android 開發人員提供的內容。第 4 版以前的 SDK 一律會傳回 false。如果是 iOS 6 以上版本，這個值將是 advertisingTrackingEnabled 資源，其他版本的值則設為 True。在多數情況下，您都應該使用對應的內建變數。

固定常數

這個值會是您指定的字串。

Google Analytics (分析) 設定

在網頁容器和行動應用程式 (Firebase) 容器的通用 Analytics (分析) 代碼中，您可以用 Google Analytics (分析) 設定變數來集中設定及共用多個代碼一同使用的常用 Google Analytics (分析) 設定。使用通用 Analytics (分析) 建立 Google Analytics (分析) 代碼時，代碼管理工具會提示您選取或建立 Google Analytics (分析) 設定變數，相關詳情請見這篇說明中心文章。

對照表

系統會根據對照表中的指示設定這個值。對照表包含兩個資料欄，下面以空白對照表說明資料之後的使用方式：

當 [選取變數] 等於	將 [這個變數] 設為

您使用對照表建立變數後，其值會根據另一個變數的值變動。如果您的應用程式設定能夠將適當的值 (例如轉換追蹤 ID) 對應至應用程式版本代碼或應用程式的其他部分，就適合使用這個方式來建立變數。在下列範例中，我們建立了一個名為「Conversion ID」(轉換 ID) 的變數；如果應用程式版本代碼為 1.0，值會是「12345」；若版本代碼為 1.1，值則會是「34567」。對照表中的列數不限，但欄位必須區分大小寫。

如果 {{應用程式版本代碼}} 為	將 {{Conversion ID}} 設為
1.0	12345
1.1	34567
1.2	56789

隨機數字

這個值會是介於 0 到 2147483647 的任一隨機數字。在多數情況下，您都應該使用對應的內建變數。

容器資料

容器 ID

這個值會是容器的公開 ID (例如 GTM-ABC42)。在多數情況下，您都應該使用對應的內建變數。

容器版本號碼

當容器處於預覽模式時，這個變數值會是容器的預覽版本號碼；不是預覽模式時，變數值則是容器的發佈版本號碼。在多數情況下，您都應該使用對應的內建變數。

應用程式

應用程式 ID

這個值會是套件名稱 (Android) 或應用程式 ID (iOS)。在多數情況下，您都應該使用對應的內建變數。

應用程式名稱

這個值會是應用程式名稱。在多數情況下，您都應該使用對應的內建變數。

應用程式版本代碼

這個值會是目前正在執行的應用程式版本。在多數情況下，您都應該使用對應的內建變數。

廣告 ID

如果是 Android 平台，這個值會是廣告 ID，第 4 版之前的 SDK 則一律會傳回空白字串。若是 iOS 6 以及更新的版本，這個值會是 IDFA，其他版本的值則是空白字串。

SDK 版本

這個值會是安裝了應用程式的裝置所用作業系統的 SDK 版本。在多數情況下，您都應該使用對應的內建變數。

裝置

裝置名稱

這個值會是安裝了目前正在運作應用程式的裝置名稱 (例如「Samsung Android」、「Pixel 2」)。在多數情況下，您都應該使用對應的內建變數。

語言

這個值會是兩個字母組成的語言代碼，代表使用者為裝置設定的偏好語言。在多數情況下，您都應該使用對應的內建變數。

作業系統版本

這個值會是安裝了應用程式的裝置所用的作業系統版本。在多數情況下，您都應該使用對應的內建變數。

平台

這個值會是目前正在運作的應用程式所用的平台 (例如「Android」、「iOS」)。在多數情況下，您都應該使用對應的內建變數。

螢幕解析度

這個值會是安裝了目前正在運作的應用程式的裝置螢幕解析度，格式為「寬 x 高」(例如「1920 x 1080」)。在多數情況下，您都應該使用對應的內建變數。

其他

函式呼叫

這個值會是預先註冊函式呼叫的傳回值；相關詳情請參閱 Android 版或 iOS 版的 SDK 文件。

值組合 (僅限舊版容器)

這個變數包含 JSON 格式的鍵/值組合。值組合可用來設置應用程式的設定值；以賽車遊戲應用程式為例，您可以使用下列方式定義類型為值組合的「應用程式設定」變數：

{
  "max-fuel": 200,
  "starting-fuel": 100,
  "fuel-burn-rate": 20
}
行動應用程式可以提供鍵來擷取變數中的值，例如：

public class MainActivity {

  // 加入您的容器公開 ID。
  private static final String CONTAINER_ID = "XXX-YYY";
  
  // 容器設定值鍵，之後可用來
  // 擷取值。
  private static final String MAX_FUEL_KEY = "max-fuel";
  private static final String INIT_FUEL_KEY = "init-fuel";
  private static final String FUEL_BURN_KEY = "fuel-burn-rate";

  // 其餘的 onCreate 程式碼。
  }
}

/*
* 使用 Google 代碼管理工具容器
* 更新遊戲值的方法。
*/
public void updateConfigurationFromContainer(Container container) {

  // 取得容器參照。
  Container container = mFutureContainer.get();

  // 使用容器設定值鍵
  // 更新遊戲設定。
  maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
  startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
  burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}

「值組合」變數包含相關的觸發條件；如果是要套用至應用程式所有例項和版本的設定值，請將啟用觸發條件設為預先定義的「永遠」。若想進一步瞭解如何使用值組合變數，請參閱 Android 或 iOS 版的開發人員文件。