個人用設定

どのように動作するか

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

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

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

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

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

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

使用に適した方

ゲームキーの直接販売を統合し、ゲームキーの販売を設定したパートナー。
エクソーラのゲームカタログの個人用設定や独自の個人用設定を利用したいパートナー。

前提条件

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

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

ユーザーフロー

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

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

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

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

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

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

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

カタログの表示ルール

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

すでにベースゲームを所有しているユーザーにはDLCを割り引くなど、パーソナライズされたプロモーションを設定することができます。

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

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

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

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

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

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

ユーザーフロー

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

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

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

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

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

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

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

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

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