モーメントAPIエンドポイント

仕組み

モーメントAPIエンジンは、あなたの地域、アカウント、プロファイルに対してユニークなエンドポイントを作成します。各エンジンは、各エンドポイントにユニークなエンジンIDを割り当てます。

訪問者のデータは、エンジンを有効にし、訪問者がアクティブなセッションをログし、システム内でイベントを生成した後に利用可能になります。訪問者のデータをリクエストし、まだアクティブなセッションをログしていない場合、APIはデータを返しません。

訪問者のデータを取得するには、Tealium iQ Advanced JavaScript Code Extensionを設定して、Moments API endpointにリクエストを行います。

GETメソッド

GETメソッドを使用して、Moments APIエンジンで指定したオーディエンス、バッジ、属性データを取得します：

GET  https://personalization-api.{REGION}.prod.tealiumapis.com/personalization/accounts/{ACCOUNT}/profiles/{PROFILE}/engines/{ENGINE_ID}/visitors/{IDENTIFIER}?ignoreTapid={IGNORE_TAPID}&suppressNotFound={SUPPRESS_NOT_FOUND}

このコマンドは以下のパラメータを使用します：

オブジェクト

Moments APIは、エンジン設定で指定したオーディエンス、バッジ、属性フィールドを含むJSONオブジェクトとして訪問者データを返します。

訪問者の属性をIDまたは名前で返すように設定できます。以下のレスポンスボディの例を参照してください：

{
    "audiences": [
        "VIP", 
        "Women's Apparel",
        "Lifetime visit count"
    ],
    "badges": [
        "13",
        "26",
        "52"
    ],
    "properties": {
        "5063": 6.0,
        "6021": "banner_007",
        "6022": "voucher_614",
        "6023": "https://domain.com/example.html"
    }  
}

以下のデータタイプは、Moments APIではサポートされていません：

• PIIとしてマークされた属性
• ブール値の配列
• 数値の配列
• 文字列の配列
• ファネル
• 文字列のセット
• 集計
• タイムライン

ヘッダー

以下のHTTPヘッダーは、Moments APIリクエストで必要です：

• Referer - ドメイン許可リストと比較される値。リファラーと許可リストが一致しない場合、リクエストは拒否されます。
  • 例：https://www.example.com/
• Origin - JavaScriptからAPIを呼び出す際のCORSエラーを対処するために使用される値。
  • 例：https://www.example.com/

エラーメッセージ

このエンドポイントの可能性のあるエラーメッセージ：