TagManager

パブリック クラス 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"));
コンテナとは、マクロ、タグ、ルールをまとめたものです。Terraform Registry は GTM アプリケーションであり、コンテナ ID が割り当てられています。 このコンテナ ID は、この API 内で使用される ID です。

Container クラスは、指定されたキーで値を取得するためのメソッドを提供します。 ルーティン getBoolean(String)getDouble(String)getLong(String)getString(String) は現在の 値のコレクション マクロのキーに値を指定します。 コンテナに関連するルールに応じて異なります。

たとえば、コンテナにキー speed を含む値収集マクロがあり、 値が 32、有効化ルールが Language である。もう一つの値コレクションは 値が 45 のキー speed、有効化ルールが指定されたマクロ Language が「en」でない場合、次の呼び出しを行います。

 container.getLong("speed")
は、デバイスの現在の言語が英語の場合は 32、そうでない場合は 45 を返します。

データレイヤは、アプリケーションに関する一般的な情報を保持するマップです。 DataLayer クラスは、データレイヤーに対してデータのプッシュと取得を行うメソッドを提供します。 event キーをデータレイヤーにプッシュすると、このイベントに一致するタグが生成されます 発生します。

コンテナの初期バージョンは、アプリケーションにバンドルされています。必要があります。 tagmanager/containerId という名前のアセットとして配置。containerId は同一である。 コンテナ ID を指定します。openContainer(String, Container.Callback) を呼び出すと、コンテナは バンドルされたルールやマクロとともに返されます。 UI でコンテナを作成し、[Download] ボタンを使用してダウンロードします。

UI でコンテナを変更し、新しいバージョンを公開できます。この場合 モバイルアプリがネットワークからコンテナを更新します(現在は 12 時間ごと)。 新しいバージョンが取得されます。ユーザーが get... ルーチンの 1 つを呼び出すと、最新のルールを使用して値が計算されます。

ダウンロードしたコンテナはローカルに保存されます。openContainer(String, Container.Callback) を呼び出すと、最初に デフォルトのコンテナが読み込まれた後、保存されたコンテナが非同期で読み込まれます。いずれも あるいは 12 時間以上経過している場合は、ネットワークから新しいバージョンを取得しようとします。 これらの非同期読み込みのステータスは、 Container.Callback から openContainer(String, Container.Callback) に変更。

場合によっては、デフォルト以外のコンテナが使用可能になるまで、または 最新の新しいコンテナが利用可能になりますContainerOpener は、そのような場合に役立つユーティリティ クラスです。

コンテナの作業が完了したら、close() を呼び出します。

ネストクラスの概要

インターフェース TagManager.Logger エラー、警告、情報、デバッグ、詳細ログ用のシンプルなインターフェース。
enum TagManager.RefreshMode コンテナを更新するためのモード。

パブリック メソッドの概要

コンテナ
getContainer文字列 containerId
背景情報
DataLayer
静的 TagManager
getInstanceコンテキスト context
ロガー
TagManager.RefreshMode
コンテナ
openContainerString containerIdContainer.Callback callback
無効
setLoggerLogger logger
無効

パブリック メソッド

<ph type="x-smartling-placeholder"></ph> 一般公開 コンテナ をご覧ください。 getContainer 文字列 containerId

containerId に関連付けられている開いているコンテナを返します。 コンテナがまだ開いていない場合は、null を返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 背景情報 getContext ()

このオブジェクトに関連付けられている保存済みコンテキストを返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 DataLayer をご覧ください。 getDataLayer ()

タグ マネージャーが使用するデータレイヤー オブジェクトを返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 静的 TagManager をご覧ください。 getInstance コンテキスト context

TagManager クラスのシングルトン インスタンスを取得し、必要に応じて作成します。

<ph type="x-smartling-placeholder"></ph> 一般公開 ロガー をご覧ください。 getLogger ()

タグ マネージャーで使用されているロガーを返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 TagManager.RefreshMode をご覧ください。 getRefreshMode ()

すべてのコンテナに使用される更新モードを返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 コンテナ をご覧ください。 openContainer (String containerId, Container.Callback callback)

コンテナを返します。コールバックは、API 呼び出しでさまざまなことが 作成されます。少なくとも、openContainer は保存されているバージョンのコンテナを されます。保存されたバージョンがない場合や、保存されたバージョンが古くなっている場合は、 ネットワークから読み込みが行われます。

通常、返されるコンテナは空ですが、読み込みは別のコンテナで行われます。 返されたコンテナは、返される前、返された後に更新される場合があります。 または更新されないこともある(たとえば、有効期間中にネットワーク接続がない場合) あります。

特定の containerId に対して 2 回目の openContainer を呼び出すと、 例外がスローされます。

パラメータ
containerId 開くコンテナの ID
callback 読み込みの処理中にさまざまなメソッドが呼び出されるオブジェクト プロセスですこれらのメソッドは、異なるスレッドから呼び出される場合があります。また、 openContainer が返される前に呼び出す必要があります。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setLogger ロガー ロガー

タグ マネージャーで使用されている既存のロガーを置き換えます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setRefreshMode TagManager.RefreshMode モード

すべてのコンテナに使用される更新モードを設定します。