ホストされたデータレイヤー | モバイル用の開始ガイド

サポートされているプラットフォーム

以下のプラットフォームでは、ホストされたデータレイヤーがサポートされています：

仕組み

ホストされたデータレイヤーは、モバイルアプリの動的データレイヤーを補完するため、またはJSON構成ファイルをホストするために、静的にホストされたデータの使用を容易にします。モバイルアプリで実装されたデータレイヤーは、リアルタイムの情報を取得するのに役立ちますが、オフラインシステムからの追加の有益な情報を含めるのは難しい場合があります。ホストされたデータレイヤーは、静的なデータをTealiumにアップロードする便利なメカニズムを提供し、これによりモバイルアプリがデータを豊かにしたり、JSONファイルを使用するアプリケーションを動かしたりすることができます。

Tealium for mobileは、特定のデータレイヤーアイテムをリモートで保存し、アプリにダウンロードさせるホストされたデータレイヤーをサポートしています。この機能は、データレイヤーの属性がネイティブコードで利用できないが、あなたの組織から利用可能にできる任意のシナリオで役立ちます。例えば、あなたのeコマースシステムはproduct_is_in_stockやproduct_has_free_shippingのような商品属性を持っているかもしれませんが、これらはネイティブコードで簡単にアクセスすることができず、ホストされたデータレイヤーファイルとしてアップロードすることができます。

_ルックアップ変数_は、データレイヤーが対応するホストされたデータレイヤーオブジェクトを取得するために使用する変数を識別します。ホストされたデータレイヤーのデータアイテムはデフォルトで7日間保持され、期限が切れた後に再ダウンロードされます。

追加情報：

構成

Tealiumライブラリを初期化する前に、ホストされたデータレイヤーのキー（ルックアップ変数）を識別し、以下のプロパティを構成します。キー値は、ホストされたデータレイヤーモジュールがデータレイヤーIDを取得するために使用されます。

Android: hostedDataLayerEventMappings
Swift: hostedDataLayerKeys

デフォルトでは、ホストされたデータレイヤーのデータは7日間保持され、期限が切れた後に再ダウンロードされます。以下のプロパティを構成することで、ホストされたデータレイヤーのデータの有効期限を構成できます。

Android: hostedDataLayerMaxCacheTimeMinutes
Swift: hostedDataLayerExpiry

有効期限を短く構成すると、ネットワークリクエストが増えるため、モバイルデバイスのバッテリー寿命が短くなります。

ユースケース：製品データの補完

シナリオ：

モバイルアプリで販売している製品の情報をデータベースに持っています。
ID、Price、Nameなどの基本的な製品属性は、モバイルアプリで容易に利用でき、現在はデータレイヤーに格納されています。
モバイルアプリからは利用できないオフラインシステムには、データレイヤーに追加したい製品属性が含まれています。例えば、SKU、In Store Availability、Free Shipping Status、Brandなどです。

以下の手順は、このユースケースの実装プロセスを説明しています：

ルックアップ変数を識別する
データレイヤーにはproduct_idが含まれており、これはオフラインデータの識別子でもあり、ルックアップ変数の良い候補です。
ホストされたデータレイヤーオブジェクトを作成し、アップロードする
オフラインの製品データをJSONファイルにエクスポートし、それらをproduct_idの予想される値に基づいて命名します。例えば、データレイヤーにproduct_id=["PRD123"]が含まれている場合、対応するホストされたデータレイヤーファイルはPRD123.jsと命名されます。各製品について別々のファイルを作成します。

以下の表は、エンリッチメントプロセスを適用した結果を示しています。

エンリッチメント	結果
データレイヤー `utag_data`	`{ "page_type":"product", "product_id":["PRD123"]}`
ホストされたデータレイヤーオブジェクト `PRD123.js`	`{"has_free_shipping":["0"], "has_instore_pickup":["1"]}`
マージされたデータレイヤー	`{"page_type":"product", "product_id":["PRD123"], "has_free_shipping":["0"], "has_instore_pickup":["1"]}`

トラブルシューティング

以下は、トラブルシューティングのヒントです：

ディスパッチにホストされたデータレイヤーコンポーネントが含まれているトラックコールは、リモートファイルを取得するために必要な追加時間のため、順序が乱れる可能性があることに注意してください。これは、アイテムの有効なキャッシュが存在する場合は適用されません、なぜならルックアップは必要ないからです。
ホストされたデータレイヤーのリクエストが行われたときにサーバーエラーや接続エラーが発生した場合、リクエストは最大5回まで再試行されます。5回の失敗後、ホストされたデータレイヤーデータなしでトラックコールが送信されます。
Tealium上でアイテムの有効なレコードが見つからない場合、ホストされたデータレイヤーデータなしでトラックコールが送信されます。
リクエストされているホストされたデータレイヤーアイテムの有効なキャッシュが存在しない場合、最初のリクエストはキューに入れられ、キューがフラッシュされたときにのみ送信されます。この動作は、バッチ処理されたイベントの最大数に達した場合や、アプリがバックグラウンドにある場合に自動的に行われます。