ユーザーデータ収集の管理
どのように動作するか
ユーザー登録時に、次の基本データが要求されます:
- Login APIを使用する場合:
- ユーザー名
- メールアドレス
- パスワード
- ログインウィジェットを使用する場合:
- メールアドレス
- パスワード
ユーザーから追加の個人データを要求することができます。これを行うには、パブリッシャーアカウントで、登録フォームに含める追加フィールドを指定します。ユーザー登録は、必須項目としてマークしたすべてのフィールドに入力した後にのみ可能です。ユーザーから提供されたデータは、データベース内のユーザーのプロファイルに保存されます。
既に登録されているユーザーの認証時に、そのユーザーのプロファイルのいくつかのフィールドが入力されていないことが判明した場合、ログイン製品は、不足している情報を収集するためのフォームを表示します。ログインするには、このフォームのすべての必須フィールドに入力する必要があります。
入手方法
- パブリッシャーアカウントでログインプロジェクトをセットアップします。
- ユーザー登録フォームにカスタムフィールドを追加するリクエストをアカウントマネージャに送信します(任意)。
- アプリケーション側でソリューションを統合します。
パブリッシャーアカウントでのセットアップ
- パブリッシャーアカウントでプロジェクトを開き、ログインセクションに移動します。
- ログインプロジェクトのパネルにある構成するをクリックします。
- ナビゲーションページで、ユーザーデータベースブロックに移動し、補足ユーザー情報セクションを選択します。

- 収集するユーザー情報を選択します。以下のフィールドが利用できます:
- ユーザー名
- 名前
- 苗字
- 生年月日
- 国
- 性別
- 項目を必須項目にするには、項目の説明行にある★アイコンをクリックします。アイコンが青くなります。
- 変更を保存するをクリックします。
登録フォームにカスタムフィールドを追加するリクエスト
登録フォームには、パブリッシャーアカウントで利用可能なフィールドに加え、独自のフィールドを追加することができます。これを行うには、アカウントマネージャーに連絡し(またはam@xsolla.comまでお問い合わせ)、フィールドのリストと各フィールドについて以下の情報を提供してください:
- 英語のフィールド名;
- タイプ:
string
;date
;select
— リストから1つのオプションを選択します;multi-select
— リストから複数のオプションを選択します;
- フィールドが必須であるかどうか。
select
およびmulti-select
フィールドについては、これらのフィールドに取り得る値のセットもアカウントマネージャーに提供してください。
アプリケーション側の統合
ログインウィジェットによる統合を利用した場合、アプリケーション側で拡張登録フォームを統合するための操作は必要ありません。
エクソラSDKを通じて統合する場合、ユーザーに関する追加情報の収集はまだ利用できません。
Login API経由で統合する場合は、fields
パラメータを使用して、収集した追加ユーザーデータを新規ユーザーを登録するリクエストで渡します。このパラメータは、プロパティと値のペアのセットです。パブリッシャーアカウントで接続可能な登録フォームのフィールドは、fields
パラメータの以下のプロパティに対応します:
フィールド名 | 種類 | fields パラメータプロパティ |
---|---|---|
ユーザー名 | string | username |
苗字 | string | given-name |
苗字 | string | family-name |
生年月日 | date (YYYY-MM-DD) | bday |
国 | select (ISO 3166-1 alpha-2) | country-name |
性別 | 列挙型(f およびm 値を使用) | gender |
リクエストの例:
- http
- curl
POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
Content-Type: application/json
{
"username": "john-email@email.com",
"password": "123456",
"email": "john-email@email.com",
"fields": {
"nickname": "John",
"country-name": "US",
"bday": "1997-07-16"
}
}
curl --request POST \
--url 'https://login.xsolla.com/api/user?login_url=https%3A%2F%2Fexample.com&projectId=projectId' \
--header 'content-type: application/json' \
--data '{"username":"john-email@email.com","password":"123456","email":"john-email@email.com","fields":{"nickname":"John","country-name":"US","bday":"1997-07-16"}}'
登録フォームに項目を追加するオプションや、収集した情報を保存する場所は、選択したユーザーデータの保存形式によって異なります:
エクソラストレージ
エクソラストレージを使用する場合、登録フォームにはパブリッシャーアカウントで利用可能なフィールドのみを追加することができます。ユーザーから収集された追加情報はエクソラ側で保存されます。
PlayFabストレージ
PlayFabストレージを使用する場合、パブリッシャーアカウントで利用可能なフィールドと独自のフィールドの両方を登録フォームに追加することができます。
追加フィールドの情報とその値は、ユーザーデータとしてPlayFabストレージに保存されます。このユーザーデータには、PlayFab APIまたはPlayFabアカウントでアクセスできます:
- プレヤーセクションに移動し、ユーザーIDをクリックします。
- Player Data (Title)タブを選択します。
Firebaseストレージ
Firebaseストレージを使用する場合、パブリッシャーアカウントで利用可能なフィールドと独自のフィールドの両方を登録フォームに追加することができます。ユーザーから収集した追加情報はエクソラ側で保存されます。
カスタムストレージ
カスタムストレージを使用する場合、パブリッシャーアカウントで利用可能なフィールドと独自のフィールドの両方を登録フォームに追加することができます。
追加フィールドの情報とその値は、カスタムストレージ接続時にパブリッシャーアカウントの新規ユーザーURLフィールドで指定されたURLに、エクソラログインサーバーから登録リクエストで送信されます。
例:
ユーザー登録フォームに以下の項目が追加されます:
- 国;
string
タイプのカスタムnickname
フィールド;- 可能な値を持つ
multi-select
タイプのカスタムplatform
フィールド:windows
、mac os
とlinux
。
ユーザー登録の際、エクソラログインサーバーは新規ユーザーURLに以下のリクエストを送信します:
- http
- curl
POST https://your.hostname/new_user_url.path HTTP/1.1
Content-Type: application/json
Authorization: Bearer {JWT}
{
"email": "john@gmail.com",
"password": "123456",
"country-name": "DE",
"nickname": "JohnSnow",
"platform": ["windows", "mac os"]
}
curl --request POST \
--url 'https://your.hostname/new_user_url.path' \
--header 'authorization: bearer_JWT' \
--header 'content-type: application/json' \
--data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'
この記事は役に立ちましたか?
このページを評価する
答えたくない
ご意見ありがとうございました!
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。