Moments APIについて

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

Moments APIは、リアルタイムの訪問パーソナライゼーションのための高性能データを取得するための、組み合わせ可能なAudienceStream APIです。Moments APIをTealiumのクライアントサイドアプリケーションに統合し、utag.jsがインストールされている場所やTealium for Mobileで使用します。

動作原理

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

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

使用例

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

• パーソナライゼーション（最初のページ以降）
• データエンリッチメントロジックと組み合わせた次の最適なアクション
• エンタープライズグレードのAPI管理とコンプライアンス

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

エンジン

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

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

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

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

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

エンドポイント

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

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

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

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

MCPサーバー

Moments APIはMCPサーバーとの統合をサポートしており、高度なパーソナライゼーションとオートメーションの使用例に対して大規模な言語モデル（LLM）およびエージェントベースのソリューションとのシームレスな接続を可能にします。詳細については、Moments API 管理MCPサーバーを参照してください。

訪問識別子

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

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

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

制限

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

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

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

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

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

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

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

データの削除

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

次の例は、エンドポイントからデータを削除する場合に参考になる状況を説明しています：

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

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

データの削除は、Moments APIエンジンデータのみを削除します。AudienceStreamの訪問レコードは影響を受けません。

エンジンデータの削除についての詳細は、Manage Moments API engines > Purge dataを参照してください。

ドメイン許可リスト

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はどちらもリアルタイムで訪問データを取得できますが、使用例、構成、実装が異なります。これら二つの訪問プロファイルデータ取得方法の違いについて学ぶために、以下の比較を参照してください。

	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. utag.jsがインストールされているTealiumクライアントサイドアプリケーションやTealium for Mobileにエンドポイントを統合します。
4. データを収集し、活用します。