LiveOps API (2.0.0)
- バージョン： 2.0.0
- サーバー：
https://store.xsolla.com/api - メールでお問い合わせ
- 連絡先URL： https://xsolla.com/
- 要求されるTLSバージョン： 1.2
LiveOpsは、プロモーションやパーソナライズされたオファーを通じて、プレイヤーの継続的なエンゲージメントを促進するためのツールキットです。
APIを使用して、以下の機能を管理できます：
- プロモーション — ーポン、プロモーションコード、割引、ボーナスキャンペーンを作成または管理します。
- 個人用設定 — 特定の認証済みユーザーに対してのみ、アイテムカタログの表示やプロモーションの適用を行うための条件を指定します。
- プロモーション制限 — ユーザーごとのプロモーション利用回数制限を設定、およびそれらの制限の定期的なリセットを設定します。
- 報酬チェーンとバリューポイント — ポイント蓄積に連動した報酬進行（プログレッシブ報酬）を設定します。
- デイリーチェーン — 定期的なログインを促すための、反復的なデイリー報酬をセットアップします。
- オファーチェーン — 段階的な価格設定や無料報酬オプションを含む、一連の連続購入オファーを構築します。
- アップセル — 付加価値の高いアイテムの購入をユーザーに促す販売手法。
本APIは以下のグループに分かれています：
Admin — キャンペーンやチェーン設定の作成、更新、有効化、削除を行うためのコール。マーチャントまたはプロジェクトの認証情報を使用した基本アクセス認証で認証されます。Client — 認証済みエンドユーザーに代わって、利用可能なプロモーションの取得、有効なチェーンの確認、コードの引き換え、報酬の受け取りなどを行うためのコール。ユーザーJWTで認証されます。
個人用カタログ
ユーザー属性に応じたルールを指定することができるAPIです。 ユーザーが具体的なルールの条件をすべて満たした場合、パーソナライズされたアイテムが表示されます。
パーソナライズされたプロモーションについては、プロモーションセクションを参照してください。
購入前に属性を渡すには、Xsolla Login APIを使うか、Pay Station APIを使ってトークンを生成する際にそれをuser.attributesプロパティに渡します。
- https://store.xsolla.com/api/v2/project/{project_id}/admin/user/attribute/rule/all
- Mock serverhttps://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/{project_id}/admin/user/attribute/rule/all
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://store.xsolla.com/api/v2/project/44056/admin/user/attribute/rule/all{ "items": [ { … }, { … } ] }
- https://store.xsolla.com/api/v2/project/{project_id}/admin/user/attribute/rule/{rule_id}
- Mock serverhttps://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/{project_id}/admin/user/attribute/rule/{rule_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
-u <username>:<password> \
https://store.xsolla.com/api/v2/project/44056/admin/user/attribute/rule/1- https://store.xsolla.com/api/v2/project/{project_id}/admin/user/attribute/rule/{rule_id}
- Mock serverhttps://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/{project_id}/admin/user/attribute/rule/{rule_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://store.xsolla.com/api/v2/project/44056/admin/user/attribute/rule/1ルールは正常に受信されました。
ユーザー属性を検証するための条件。 ユーザー属性が指定されたすべての条件に一致するかどうかに基づいて、カタログ内のアイテムの可用性を決定します。
ユーザー属性コード。
ユーザー属性に属性がない場合でも条件を満たすことを示します。trueを渡すと、この属性を持たないユーザーにもアイテムを表示します。属性は持っているが、値が条件で指定されたものと一致しないユーザーには、アイテムは表示されません。false - その属性を持っているが、値が条件に指定されたものと一致しないか、属性が欠落しているユーザーには、アイテムは表示されません。
条件によって実行される操作のタイプ。string属性タイプの場合。
| 列挙型 値 | 説明 |
|---|---|
| eq | イコール |
| ne | ノットイコール |
ユーザー属性タイプ。
アイテムを無許可のユーザーに表示するかどうか。「true」の場合、カタログ表示ルールに関係なく、アイテムは権限のないユーザーに表示されます。デフォルトでは「false」です。
{ "attribute_conditions": [ { … } ], "is_enabled": true, "is_satisfied_for_unauth": true, "items": [ { … } ], "name": "Ork race armor rule", "rule_id": 1 }