Moments APIについて

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

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

動作原理

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

エンジンを構成した後、ワークフローに統合するためのユニークなエンドポイントがMoments APIによって作成されます。

使用例

Moments APIは、パーソナライズされた体験にリアルタイムの訪問データが必要な場合にいつでも使用できます。これには以下が含まれます：

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

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

エンジン

Moments APIのエンジンは、各ユニークなエンドポイントに格納する訪問データを構成し、それらのエンドポイントにアクセスできるドメインを構成することを可能にします。

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

訪問がアクティブなセッションをログし、システムでイベントを生成した後、訪問データが利用可能になります。たとえば、訪問がサイトを訪れたとき、Moments APIは新しい訪問イベントがエンジン構成で定義されたオーディエンス、バッジ、属性に影響を与えるかどうかを判断します。訪問データが更新される必要がある場合にのみ、各エンジンのユニークなデータストアにデータが書き込まれます。

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

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

読み取りと書き込み

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

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

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

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

これにより、訪問プロファイルAとBが生成されます：

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

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

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

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

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

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

エンドポイント

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

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

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

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

MCPサーバー

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

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

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

訪問識別子

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

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

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

ガバナンス

Moments APIには、安全で本番環境に適したデプロイメントのための組み込みコントロールが含まれています：

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

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

制限

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

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

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

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

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

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

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

データの消去

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

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

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

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

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

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

ドメイン許可リスト

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

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

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

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

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

サブドメイン

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

権限

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

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

Moments APIとData Layer Enrichment APIの比較

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

	Moments API	Data Layer Enrichment API
使用事例	最初のページのパーソナライゼーションおよびそれ以降のリアルタイムアクセス。	初期処理イベント後のリアルタイムからほぼリアルタイムで利用可能なライブ訪問データ。
レート	200リクエスト/秒	-
アクティブな訪問セッションが必要	いいえ	はい
利用可能なデータ	オーディエンス、バッジ、またはサポートされている属性データタイプ。 オーディエンスとバッジの名前とIDが利用可能。	訪問ID、ファネル、タイムライン以外の属性、属性IDでリストされます。バッジとオーディエンスの場合、名前が利用可能。 バッジ名の場合、Profile Definition APIと組み合わせます。
ルックアップID	Tealium匿名IDまたは訪問ID属性値	Tealium匿名ID
認証されたエンドポイント	いいえ	いいえ
PIIへのアクセス	いいえ	いいえ
カスタム応答オブジェクト	はい	いいえ
実装	API	APIまたはTealium Collectタグ

はじめに

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

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