コンテキストAPIについて（旧モーメンツAPI）

アカウントマネージャーに連絡して、アカウントでコンテキストAPIを有効にしてください。

コンテキストAPIは、AudienceStream APIの構成可能な部分であり、ライブ訪問コンテキストの迅速でターゲットされたスライスを取得します。完全な訪問プロファイルを返すのではなく、アプリ、サービスワークフロー、またはAIシステムが特定の決定や体験に必要なオーディエンス、バッジ、属性のみを返します。utag.jsがインストールされているTealiumクライアントサイドアプリケーション、Tealium for Mobile、またはLangChainのような任意のエージェントベースのAIフレームワークにコンテキストAPIを統合します。

動作原理

コンテキストAPIは、エンジン と呼ばれる構成を使用して、現在の訪問に必要なデータのみを取得するようにAPI応答をカスタマイズします。たとえば、完全な訪問プロファイルを取得する代わりに、エンジン構成で選択したオーディエンス、バッジ、属性データのみをコンテキストAPIが取得します。

エンジンを構成した後、コンテキストAPIはワークフローに統合するためのユニークなエンドポイントを作成します。

使用例

コンテキストAPIは、リアルタイムの訪問データが必要な場合にいつでも使用できます。これには以下が含まれます：

• パーソナライゼーション（最初のページおよびそれ以降）、アクティブなセッションが確立される前の匿名訪問の検索を含む。
• データエンリッチメントロジックと組み合わせた次の最適なアクション。
• デバイスやチャネルをまたいだ訪問ID検索を使用したカスタマーサービスおよびクロスチャネルエクスペリエンス。
• 管理されたMCPサーバーを介したAIおよびエージェントベースのシステム。
• エンタープライズグレードのAPI管理とコンプライアンス。

たとえば、訪問がウェブサイトやアプリに戻ったとき、訪問データのためにユニークなコンテキストAPIエンドポイントへのリクエストが行われます。コンテキストAPIは必要なデータのみを提供するように最適化されているため、APIはリアルタイムでストリームライン化された応答をアプリに送信します。その重要なデータを使用して、訪問のためのパーソナライズされた体験をトリガーする追加のロジックをアクティブ化できます。

エンジン

コンテキストAPIエンジンを使用すると、各ユニークなエンドポイントに格納する訪問データと、それらのエンドポイントにアクセスできるドメインを構成できます。

エンジンを構成するとき、使用例に必要なオーディエンス、バッジ、属性のみを選択します。コンテキストAPIエンジンは、構築する際にJSON応答を表示するため、リクエストの正確性と範囲を確認できます。

訪問がサイトを訪れると、コンテキストAPIは新しい訪問イベントがエンジン構成で定義されたオーディエンス、バッジ、属性に影響を与えるかどうかを判断します。訪問データが更新される必要がある場合にのみ、各エンジンのためのユニークなデータストアにデータが書き込まれます。

エンジンはリアルタイムでデータストアを更新するため、訪問がブランドとのやり取りを行うにつれて、APIエンドポイントのデータは最新の状態を保ちます。

デフォルトでは、特定のビジネスケースごとにカスタマイズされたエンジンを作成できるように、プロファイルごとに最大10個のエンジンを有効にすることができます。追加のエンジンを有効にする必要がある場合は、Tealiumサポートに連絡してください。

読み取りと書き込み

読み取り は、エンジンから訪問データを取得するリクエストです。データが見つかるかどうかにかかわらず、読み取りはクォータにカウントされます。Tealiumがレート制限のために読み取りを拒否した場合、料金は発生しません。

書き込み は、エンジンによって格納された訪問プロファイルデータを更新することです。ステッチされた訪問の場合、コンテキストAPIは関連する各訪問ID（匿名IDや構成された訪問ID値など）に対して別々の書き込みを実行します。書き込みの総数は、エンジンの数とステッチされた訪問にリンクされた訪問IDの数に依存します。

たとえば、訪問が2台のデバイスからサイトを訪れた場合、次の2つの匿名IDが発生します：

• デスクトップ匿名ID tealium_visitor_id = abc123。
• モバイル匿名ID tealium_visitor_id = bcd234。

これにより、AおよびBの2つの訪問プロファイルが生成されます：

訪問のメールアドレスは user@example.com で、構成された訪問ID属性に値が入力され、両方のデバイスに関連するプロファイルが新しいマスタープロファイル（C）にステッチされます。

アカウントに単一のエンジンがあり、訪問に書き込みの対象となる属性がある場合、システムは各訪問プロファイルに対してそのデータを1回書き込みます：

• 訪問ID検索が有効な場合、3回の書き込み（3つの訪問プロファイル × 1エンジン）。
• 訪問ID検索が無効な場合、2回の書き込み（2つの訪問プロファイル × 1エンジン）。

アカウントに同じように構成された5つのエンジンがあり、訪問に書き込みの対象となる属性がある場合、システムは各訪問プロファイルに対してそのデータを5回書き込みます：

• 訪問ID検索が有効な場合、15回の書き込み（3つの訪問プロファイル × 5エンジン）。
• 訪問ID検索が無効な場合、10回の書き込み（2つの訪問プロファイル × 5エンジン）。

訪問スティッチングについての詳細は、訪問スティッチングについてを参照してください。

エンドポイント

コンテキストAPIは、各エンジンに対してユニークなエンドポイントを作成します。訪問データはJSONオブジェクトとして返されます。

Tealiumは、ペイロードサイズが1kB以下の場合、平均コンテキストAPIエンドポイントのパフォーマンスを60 msでベンチマークしています。

訪問データを取得するには、Tealium iQ Advanced JavaScript Code Extensionを構成して、Context APIエンドポイントにリクエストを行います。

エンジンをオンにしてからアクティブなセッションを持っていない訪問のデータは利用できません。

MCPサーバー

コンテキストAPI管理MCPサーバーは、AIシステムおよびLLMに、モデルコンテキストプロトコル（MCP）を使用して訪問プロファイルデータに対する安全でリアルタイムのアクセスを提供します。Tealiumがサーバーをホストおよび管理するため、デプロイまたは維持するインフラストラクチャはありません。AIエージェントは、パーソナライゼーション、分析、および自動化のためにターゲットされた顧客コンテキストを取得するためにサーバーに接続します。

サーバーは、標準エンドポイントを通じて利用可能な同じ検索方法で、匿名IDおよび訪問ID属性の検索をサポートします。

詳細については、Context API管理MCPサーバーを参照してください。

訪問識別子

コンテキストAPIエンドポイントは、Tealiumの匿名IDと訪問ID属性の両方を使用して訪問データを取得するGETリクエストをサポートします。

• 匿名ID：訪問にサイトを訪れるたび、またはアプリを使用するたびに割り当てられる一意で匿名の値です。匿名IDは、同じブラウザーやアプリからの複数の訪問を通じて訪問を追跡しますが、異なるブラウザーやデバイス間では追跡しません。
• 訪問ID属性：AudienceStream内の特別な属性タイプで、ユーザー識別子からその値を取得し、訪問スティッチングに使用されます。

詳細については、匿名ID、ユーザー識別子、および訪問ID属性を参照してください。

ガバナンス

Context APIには、安全で本格的なデプロイメントのための組み込みコントロールが含まれています：

• PIIアクセスなし：制限データとして指定された属性はAPIレスポンスに含めることができません。
• ドメイン許可リスト：どのドメインがエンジンエンドポイントをクエリできるかを制限します。
• 権限：ロールベースのアクセスで、誰がエンジンを作成、編集、または削除できるかを制御します。
• データの消去：訪問の記録に影響を与えることなく、いつでも古いエンジンデータを削除します。

詳細については、ドメイン許可リスト、権限、およびデータの消去を参照してください。

制限

Context APIには以下のデフォルト制限があります：

• 全エンジンにわたるプロファイルごとの読み取りレート制限：200リクエスト/秒/プロファイル

• プロファイルごとに有効なエンジンの最大数：10

• 訪問ごとのエンジンごとに保存できるContext APIデータの最大サイズ：1 kB

  訪問の属性データがデータストアの制限を超える場合、その訪問のためには保存されません。

• Context APIエンドポイントで利用可能なデータ：新しいイベントが処理されない場合の30日間の保持

使用事例に応じてより高い制限が必要な場合は、Tealiumアカウントマネージャーに連絡してください。

データの消去

Context APIでは、データの消去機能を使用してエンドポイントから古いデータを削除できます。

以下の例は、エンドポイントからデータを消去したい場合の状況を説明しています：

• エンジン構成に含まれるオーディエンス、バッジ、または属性の名前を変更または削除する。
• 属性の個人識別情報（PII）ステータスを変更する。属性のPIIステータスを変更すると、機密情報がAPIエンドポイントに引き続き保存される可能性があります。
• エンジン構成からオーディエンス、バッジ、または属性を削除する。

オーディエンス、バッジ、または属性がAudienceStreamまたはエンジン構成から削除された場合、そのアイテムは今後エンドポイントには表示されません。削除された属性を含むエンジンデータは変更されません。一般的に、依存関係の削除がエンドポイント統合に重大な変更を引き起こす場合、エンジンデータを消去することを検討するかもしれません。

データの消去はContext APIエンジンデータのみを削除します。AudienceStreamの訪問記録は影響を受けません。

エンジンデータの消去についての詳細は、Context APIエンジンの管理 > データの消去を参照してください。

ドメイン許可リスト

APIエンドポイントをテストした後にドメイン許可リストを作成することをお勧めします。

許可リストは、信頼できないドメインがContext APIエンドポイントへのリクエストを行うのを防ぎます。エンジンを構成するときに特定のドメインを許可リストに追加します。

Context APIは、Referer HTTPリクエストヘッダーのドメインとContext APIエンジンで定義された許可リストを比較することにより、エンドポイントへの呼び出しを許可または制限します：

• ドメインが一致：リクエストは処理されます。
• ドメインが一致しない：リクエストは処理されず、403エラーが返されます。

ドメインをリストに記載しない場合、すべてのドメインが許可されます。

サブドメイン

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

権限

Context APIの機能は、以下の権限レベルを通じて管理されます：

• エンジンの作成、編集、削除およびエンジンデータの消去
  • 編集者または発行者のレガシー権限
  • プラットフォーム権限での書き込みまたは削除アクセス
• エンジンリストの表示
  • 閲覧者のレガシー権限またはプラットフォーム権限での読み取りアクセス

Context APIとData Layer Enrichment APIの比較

Context APIとData Layer Enrichment APIはどちらもライブ訪問データを取得できますが、使用事例、構成、実装が異なります。これら二つの訪問プロファイルデータ取得方法の違いについて学ぶために、以下の比較を参照してください。

はじめに

Context APIを使用するワークフローには、次のステップが含まれます：

1. パーソナライズされたエクスペリエンスを作成するために必要なオーディエンス、バッジ、および属性を検討します。
2. 訪問データでカスタマイズされたエンドポイントを構成するためのContext APIエンジンを作成します。
3. エンドポイントをTealiumのクライアントサイドアプリケーション、utag.jsがインストールされている場所、またはTealium for Mobileに統合します。
4. データを収集して活用します。