個人用設定

どのように動作するか

個人用設定では、特定の正規ユーザーに対してのみアイテムカタログを表示したり、プロモーションを適用する条件を指定することができます。

これにより、以下の機会が得られます：

特定のユーザーに最も関連性の高いアイテムやプロモーションを提供する
ユーザーを最初のゲーム内購入をするように動機づける

以下の個人用設定オプションが利用可能：

エクソーラ側の個人用設定。パーソナライズのルールやロジックはエクソーラ側で設定または保存されます。パートナーがユーザー属性をエクソーラに送信すると、エクソーラは構成されたロジックに従ってカタログを作成します。
パートナー側の個人用設定。パーソナライゼーションのルールとロジックはパートナーによって構成および保存され、パートナーは特定のユーザーのカタログをエクソーラに渡します。

個人用設定のバリアントは1種類のみ使用できます。変更したい場合は、説明を使用してください。

使用に適した方

インゲームストアを統合し、以下のアイテムタイプのうち少なくとも1つを設定したパートナー：
エクソーラがユーザーに提供するアイテムカタログの個人用設定、または独自の個人用設定を利用したいパートナー。

前提条件

アイテムカタログをパーソナライズする前に、インゲームストア製品を統合してください。

エクソーラ側の個人用設定

ユーザーフロー

未認証ユーザーがアイテムカタログにアクセスし、パーソナライズされたプロモーションに設定されていないアイテムを確認します。
ユーザーはログインをクリックしてエクソーラログイン経由で認証します。

エクソーラはエクソーラログイン経由でユーザー属性をリクエストします。
エクソーラでは、エクソーラ側で作成したアイテムの在庫状況やキャンペーンなどのルールと、エクソーラログインから取得したユーザー属性に基づき、パーソナライズされたカタログを表示します。
ユーザーは、パーソナライズされたカタログからアイテムを選択し、「今すぐ購入」をクリックします。

購入時に、エクソーラはユーザーの属性を再度要求し、ユーザーの属性を個人用設定ルールと比較します：
- ユーザーがアイテムを購入できなくなった場合、購入ができない旨のメッセージが表示されます。
- アイテムが購入できる場合、ユーザーは決済に進みます。

ユーザー属性を変更した場合は、速やかにエクソーラログインに更新データを提出してください。

パーソナライズされたアイテムカタログの設定

エクソーラのユーザー向けアイテムカタログの個人用設定を使用するには：

エクソーラ側でアイテムカタログをパーソナライズする方法については、ステップバイステップのチュートリアルを参照してください。

カタログの表示ルール

カタログの表示ルールにより、ユーザー属性に基づいたカタログの表示をカスタマイズすることができます。

ルールには、次のタイプのアイテムを無制限に含めることができます：

アイテム
バンドル
通貨のパッケージ
ゲームキー

1つのルールで、同じユーザー属性を持つ複数の条件を作成することができます。

同じアイテムに複数のルールを適用することができます。あるアイテムにルールが適用されない場合、すべてのユーザーがそのアイテムを利用できるようになります。

カタログの表示ルールを作成

カタログの表示ルールを作成するには：

アドミンページであなたのプロジェクトを開きます。
サイドメニューでストアをクリックします。
カタログ管理ペインで、構成するをクリックします。

「カタログの表示ルール」ペインで、「構成する」をクリックします。

「ルールを作成する」をクリックします。

ルール名を指定し、カタログに表示するための条件を設定します。

ルールを適用するアイテムを選択します。

設定を確認します。必要に応じて、「編集する」ボタンをクリックして変更します。

「保存して終了する」をクリックします。

ルールを編集または削除するには、•••アイコンをクリックし、メニューアイテムを選択します。ルールを有効化または無効化するには、スイッチをクリックし、アイテムを選択します。

アドミンページまたはAPIメソッドを使用して、カタログの表示方法を指定するルールを管理することができます。これには、アイテムのセットと数量、およびこれらのアイテムに適用される条件が含まれます。

パーソナライズされたプロモーションの設定

ゲーム内で一定レベル以上のユーザーには、仮想アイテムの購入時に割引を与えるなど、パーソナライズされたプロモーションを設定することが可能です。

条件は1つまたは複数設定できます。なお、プロモーションが有効な間は、変更することはできません。プロモーションのタイプと設定について詳しくは、プロモーションキャンペーンを設定するをお読みください。

パーソナライズされたプロモーションを設定するには：

ログイン製品にユーザー属性を設定します。
ボーナス付きキャンペーンや割引付きキャンペーンを設定します。特定のユーザーのみにプロモーションをトリガーするスイッチをオンに設定し、条件を指定します。

パートナー側の個人用設定

カタログをカスタマイズしたい場合は、カスタマーサクセスマネージャーにリクエストを送信するか、csm@xsolla.comに電子メールを送信してください。この機能は、高度な個人用設定ロジックをお客様側で実装し、エクソーラ側でルール設定や属性指定を行いたくない場合に有効です。

パートナー側でパーソナライズされたプロモーションを設定することはできません。エクソーラ側でのみパーソナライズされたプロモーションをカスタマイズできます。

ユーザーフロー

未認証ユーザーがアイテムカタログにアクセスし、すべてのアイテムを確認することができます。
ユーザーはログインをクリックしてエクソーラログイン経由で認証します。

エクソーラは、ユーザーIDでアイテムを要求するウェブフックを送信します。
パートナーからの応答は、このユーザーが利用可能なアイテムSKUのリストを返します。
ユーザーがパーソナライズされたカタログからアイテムを選択し、「今すぐ購入」をクリックします。

エクソーラ側では、このスクリプトのステップ3と4が実行され、購入時の商品の在庫状況を確認します：
- ユーザーが購入できるアイテムがなくなった場合、購入できない旨のメッセージが表示されます。
- アイテムが利用可能な場合、ユーザーはアイテムの決済に進みます。

パーソナライズされたアイテムカタログの設定

個人用設定を接続するには、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。
アドミンページでプロジェクトを開き、設定 > ウェブフックに移動して、ウェブフックを送信するためのURLを入力します。すでにウェブフックを設定している場合は、このステップは省略可能です。
パートナー側でのカタログ個人用設定のウェブフック処理をセットアップします：
1. エクソーラは、ユーザーがアイテムカタログを操作するときに、ユーザーとプロジェクトのパラメータを含むウェブフックをウェブフックURLに送信します。
2. 応答として、ユーザーが利用できるアイテムSKUのリストを返す必要があります。この場合、特定のユーザーが特定のアイテムを指定回数購入できるという情報を含めることもできます。この機能により、ユーザーがカートに追加して購入できるアイテムの数やタイプを制御することができます。

また、ユーザーのためにアイテムを販売するためのパーソナライズされた制限時間を設定し、ウェブフックでこの情報を渡すことができます。
ウェブフックで制限値を渡さなかった場合は、アイテム設定で設定した制限値が適用されます。

カタログを取得するためにエクソーラにリクエストするたびに、エクソーラからゲームサーバーへの新しいリクエストが生成されます。エクソーラはゲームサーバーへのリクエスト数を減らすためにデータキャッシュを使用し、キャッシュの有効期限が切れるとpartner_side_catalogウェブフックを送信します。

キャッシュがまだ完了していない場合、partner_side_catalogウェブフックはエクソーラへのリクエストごとに送信されます。例えば、エクソーラは複数のカタログリクエストを同時に受信し、ゲームサーバーは遅延で応答します。

ウェブフックは3秒以内に処理されるようにする必要があります。それ以上かかると、ユーザーはエラーを受け取ります。

ウェブフックをテストするには、アイテムカタログに問い合わせます。設定したURLにウェブフックが応答として届きます。