このAPIを使用すると、イベントを取り込み、Treasure Dataのリアルタイムシステムからパーソナライゼーションレスポンスを受信できます。
リアルタイムパーソナライゼーションAPI呼び出しを正常に行うには、次のことを実行する必要があります:
- TD Consoleでリアルタイムサービスにアクセスするためにアカウントを有効にします。
- 設定されたイベントとオファーの詳細な知識を持つWebパーソナライゼーション用のデータベースを設定します。
- 書き込み専用APIキー
- 有効なWebパーソナライゼーショントークン。
パーソナライゼーションAPIは、これらのベースURLを使用します。
| リージョン | ベースURL |
|---|---|
| US (us01) | https://us01.p13n.in.treasuredata.com |
| Europe (eu01) | https://eu01.p13n.in.treasuredata.com |
| Japan (ap01) | https://ap01.p13n.in.treasuredata.com |
パーソナライゼーションAPIの完全なURLは
{baseURL}/{database}/{table}
例:
https://us01.p13n.in.treasuredata.com/personalization__database/preferences_table
これらは、API呼び出しに必要なヘッダーです。
| 名前 | 内容 |
|---|---|
Content-Type | ベンダー固有のJSON application/vnd.treasuredata.v1+json |
WP13n-Token | 連結されたトークン トークンは次の要素を組み合わせて作成されます: {account id}/{instance id}/{token} たとえば、アカウントID 1、インスタンスID 8、有効なWebパーソナライゼーショントークンの場合、トークンは次のようにフォーマットされます |
Authorization | TD APIキー
|
| HTTP動詞 | リソース | 説明 |
|---|---|---|
| POST | /{database}/{tables} | リクエストのオファーを取得 |
[進行中: ご容赦ください]
204 正常な取り込み
400 不正なリクエスト
- 3000: RTトークンが提供されませんでした(X-Tokenヘッダー)
- 3001: RTトークンが設定にありません
- 3002: RTトークンアカウントが認証されたユーザーアカウントと競合しています
- 3003: RTトークンの形式が無効です
- 3004: 無効なイベントオブジェクト。
429 リクエストが多すぎます
- 2003: 制限を超えたことによるKinesisエラー
- 2013: Lambdaの総同時実行数が予約された同時実行数を超えています
500 内部サーバーエラー
- 9999: 不明/未診断
- 1001: TD APIに到達できないか、タイムアウトしました
- 1002: テーブルAPIに到達できないか、タイムアウトしました
- 1003: Kinesisに到達できないか、タイムアウトしました
- 1004: Lambdaに到達できないか、タイムアウトしました
- 1005: MemoryDBに到達できないか、タイムアウトしました
- 2001: Kinesisストリームが見つかりませんでした
- 2002: Kinesis操作がエラーをスローしました
- 2011: Lambda関数が見つかりませんでした
- 2012: Lambda関数がエラーをスローしたか、レスポンスが処理されませんでした
- 2014: Lambda呼び出しが失敗しました
- 2015: Lambdaリアクター設定にまだトークンがありません
- 2021: MemoryDB操作がエラーをスローしました
- 3010: RTトークンは、トークンが一貫性のない(アカウントまたはリアクターID)リアクターで設定されています