サーバーサイドデータレイヤーエンリッチメントの有効化

動作原理

データレイヤーエンリッチメントは、以下の二つの公開された認証されていないAPIを通じて訪問データへのアクセスを提供します：

• データレイヤーエンリッチメントAPIは、フィルタリングなしで完全な訪問プロファイルを返します。
• プロファイル定義APIは、プロファイルのバッジとオーディエンス定義を返します。

この構成は、Tealium iQ内のデータレイヤーエンリッチメントの構成とは別です。Tealium iQの構成は、どのAudienceStreamプロファイルがデータレイヤーに属性を提供するかを決定しますが、データレイヤーエンリッチメントAPIへのアクセスを制御するわけではありません。

データレイヤーエンリッチメントが有効になっている場合、両方のAPIは有効なリクエストに対してデータを返します。

データレイヤーエンリッチメントが無効になっている場合、データレイヤーエンリッチメントAPIとプロファイル定義APIはどちらも200のレスポンスと空のJSONオブジェクトを返します。これらのAPIに依存している既存の統合は、それらからデータを受け取ることが停止します。Tealium Collectタグもこのエンドポイントを使用して訪問属性を取得するため、データレイヤーエンリッチメントを無効にするとTealium iQでのクライアントサイド属性の同期も停止します。

データレイヤーエンリッチメントは、既存のプロファイルではデフォルトで有効になっており、新しいプロファイルではデフォルトで無効になっています。新しいプロファイルでデータレイヤーエンリッチメントを構成する場合は、APIを使用する前にこの構成を有効にしてください。

データレイヤーエンリッチメントの有効化または無効化

1. 管理メニューでデータレイヤーエンリッチメントをクリックします。
2. データレイヤーエンリッチメントを有効または無効にします。
3. 保存をクリックします。
4. 変更を保存して公開します。

ドメイン許可リスト

デフォルトでは、データレイヤーエンリッチメントはTAPIDクッキーが存在する場合、リクエストがどのドメインから来たかに関わらず訪問プロファイルを検索します。

許可リストを作成することで、信頼できないドメインからTAPIDクッキーに基づいて訪問プロファイルにアクセスすることを防ぎます。

データレイヤーエンリッチメントは、リクエストドメインと構成した許可リストに応じて訪問IDを取得します：

• ドメインが一致する場合
  リファラが許可リストのドメインと一致する場合、データレイヤーエンリッチメントは第三者のTAPIDクッキーにある訪問IDを使用します。それ以外の場合はURLパスの訪問IDが使用されます。
• ドメインが一致しない場合
  リファラが許可リストのドメインと一致しない場合、データレイヤーエンリッチメントはTAPIDクッキーを無視し、URLパスの訪問IDを使用します。

サブドメイン

許可リストにドメインを追加すると、そのすべてのサブドメインが自動的に含まれます。たとえば、example.comを許可すると、*.example.comに一致する任意のサブドメインが含まれます。

http://example.com
https://mobile.example.com/xyz/index.html
http://app.mobile.example.com

許可リストの作成

特定の信頼できるドメインからのみリクエストを制限するために、プロファイルで許可リストを作成します。

1. 管理メニュー > データレイヤーエンリッチメントに移動します。
2. 信頼するドメインのカンマ区切りリストを入力します。プロファイルごとに最大250ドメインを追加できます。ドメインの前にhttpまたはhttpsプロトコルを含めないでください（例：example.com）。
3. 保存をクリックします。
4. 変更を保存して公開します。

データレイヤーエンリッチメントを無効にするタイミング

以下の場合にデータレイヤーエンリッチメントを無効にします：

• 訪問データの露出をプライバシーやコンプライアンスの理由で制限するため。
• 外部システムやベンダーによるアクセスを制限するため。
• 訪問プロファイルデータにアクセスできるシステムの数を減らすため。

認証されたアクセスの使用

データレイヤーエンリッチメントAPIは公開されており、認証されていません。

訪問データへの認証されたアクセスが必要な場合は、Context APIを使用してください。詳細については、Context APIについてを参照してください。