代碼管理工具

公開課程 TagManager

這是行動版 Google 代碼管理工具 (GTM) 的導入方式，使用範例： 

 Container container = TagManager.getInstance(context).openContainer(myContainerId);
 String value = container.getString("myKey");

 DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
 dataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", "Main Page"));
敬上 容器是一組巨集、代碼和規則。該檔案是在 GTM 應用程式，並指定容器 ID。 此容器 ID 是這個 API 中使用的 ID。

Container 類別提供擷取指定鍵值的方法。 處理常式 getBoolean(String)、getDouble(String)、 getLong(String)、getString(String) 會傳回最新的 值收集巨集的鍵 取決於與容器相關的規則

舉例來說，如果容器的值組合巨集包含 speed 鍵， 值為 32，啟用規則為「en」；Language以及我們收集的 巨集，鍵 speed 的值為 45，啟用規則為 Language 不是「en」，然後發出下列呼叫： 

 container.getLong("speed")
敬上 如果裝置目前使用的語言為英文，會傳回 32，否則傳回 45。

資料層是一套地圖，其中含有應用程式的相關一般資訊。 DataLayer 類別提供從資料層推送及擷取資料的方法。 將 event 鍵推送至資料層，會導致與這個事件相符的代碼 。

應用程式隨附容器的初始版本。這應該 視為標記為 tagmanager/containerId 的資產，其中 containerId 相同 您將在這項 API 中使用的容器 ID當您呼叫 openContainer(String, Container.Callback) 時，容器會使用 就會連同這些封裝規則/巨集一併傳回。 您將在使用者介面中建立容器，並使用「下載」按鈕來下載該容器。

您可以在使用者介面中修改容器並發布新版本。這樣下次 行動應用程式會從網路重新整理容器 (目前每 12 小時) 就會取得新的版本當您 呼叫其中一個 get... 處理常式，系統就會使用最新的規則計算該值。

下載的容器會儲存在本機中；撥打 openContainer(String, Container.Callback) 時，系統會將其先 載入預設容器，然後以非同步方式載入任何已儲存的容器。如果沒有： 已找到，或已超過 12 小時，便會嘗試從網路擷取較新的版本。 您可以傳送 Container.Callback到 openContainer(String, Container.Callback)。

有時候，您可能需要封鎖直到有非預設容器可供使用，或是 有可用的最新容器ContainerOpener 是可派上用場的公用程式類別。

容器完成後，請呼叫 close()。

巢狀類別摘要

TagManager.Logger 用於記錄錯誤/warning/info/debug/verbose 記錄的簡單介面。
列舉 TagManager.RefreshMode 重新整理容器的模式。

公用方法摘要

容器
getContainer(字串 containerId)
背景資訊
getContext()
DataLayer
getDataLayer()
靜態 TagManager
getInstance(背景資訊背景資訊)
記錄器
getLogger()
TagManager.RefreshMode
getRefreshMode()
容器
openContainer(字串 containerId、Container.Callback 回呼)
void
setLogger(Logger logger)
void
setRefreshMode(TagManager.RefreshMode mode)

公用方法

公開 容器 getContainer (字串 containerId)

傳回與 containerId 相關聯的已開啟容器； 如果容器尚未開啟，則會傳回 null。

公開 背景資訊 getContext ()

傳回與這個物件相關聯的已儲存背景資訊。

公開 DataLayer getDataLayer ()

傳回代碼管理工具使用的資料層物件。

公開 靜態 TagManager getInstance (背景資訊背景資訊)

取得 TagManager 類別的單例模式例項，必要時建立。

公開 記錄器 getLogger ()

傳回代碼管理工具目前使用的記錄器。

公開 TagManager.RefreshMode getRefreshMode ()

傳回所有容器使用的重新整理模式。

公開 容器 openContainer (字串 containerId、Container.Callback 回呼)

傳回容器。為因應 至少，openContainer 會嘗試載入 都會在 Docker 容器中執行如果沒有儲存的版本，或儲存的版本已過期，請嘗試 將要從網路載入。

傳回的容器通常為空白，但載入作業會在個別的 因此在傳回容器之前，系統可能會在傳回容器之前重新整理。 也可能永遠不會重新整理 (例如，在生命週期內沒有網路連線) 容器)。

如果針對指定的 containerId 再次呼叫 openContainer， 系統會擲回例外狀況

參數
containerId 要開啟的容器 ID
回呼 在載入期間，系統會呼叫其各種方法的物件 上傳資料集之後，您可以運用 AutoML 自動完成部分資料準備工作請注意，這些方法可能從不同執行緒呼叫。此外，他們可能 在 openContainer 傳回之前呼叫。

公開 void setLogger (Logger 記錄器)

取代代碼管理工具使用的現有記錄器。

公開 void setRefreshMode (TagManager.RefreshMode 模式)

設定所有容器使用的重新整理模式。