ユーザー認証をセットアップする
認証されたユーザーは、ウェブショップで商品を購入したり、カタログでユニークなオファーを見ることができます。
認証付きウェブショップの主な機能:
- ウェブショップでの複数の認証方法。
- パーソナライズされたストアフロントと正規ユーザー用のプロモコードを設定することができます。
- 個人情報の保護と処理に関する地域の法令を遵守します。
- レート制限とDDoS対策。
以下の認証方法のいずれかを選択することができます:
- ユーザーID認証:
- ウェブショップとゲームとの連携を簡略化します。
- 認証ウィジェットには登録やパスワード入力は必要ありません。ユーザーは、ゲームからユーザーIDを入力するか、ゲームへのログインと同じソーシャルネットワークアカウントを使用する必要があります。
- ユーザーIDとディープリンク認証:
- ディープリンクは、ユーザーIDでログインする際の追加の認証方法として使用できます。
- ユーザーIDとディープリンク認証ウィジェットには、登録やパスワードの入力は必要ありません。ユーザーは、ゲームからユーザーIDを入力するか、ディープリンクを使用してゲーム経由でログインするだけです。
- ディープリンク認証:
- ディープリンクを主なログイン方法として使用すると、ユーザーID認証では不可能な支払いの詳細を保存できます。
- エクソーラログインによる認証:
- 幅広い認証方法を提供します:ソーシャルネットワーク、ワンタイムコードやリンク、ログインとパスワード。
- エクソーラログインウィジェットをカスタマイズできます。
- 認証に年齢制限を課すことができます。
ディープリンクとは、アプリケーションやウェブサイトのメインページだけでなく、特定のセクション、ページ、アクションに直接ユーザーを誘導する特別なURLのことです。
ディープリンクは、ユーザーIDでログインする際の追加の認証方法として使用できます。 ゲームがユーザーのモバイル端末にインストールされている場合、ディープリンクを介してゲームにリダイレクトされ、認証トークンが取得されます。
ユーザーフロー
モバイルアプリの場合
- ウェブショップで未認証のユーザーがログインボタンまたは購入ボタンをクリックします。ユーザーIDを入力するか、モバイルゲームからログインするためのモーダルウィンドウが開きます。
- ユーザーは「モバイルゲームからログイン」ボタンをクリックします。
- ユーザーはゲームにリダイレクトされ、認証されたユーザーとして自動的にウェブショップに戻ります。
デスクトップ版
- ウェブショップで未認証のユーザーがログインボタンまたは購入ボタンをクリックします。ユーザーIDを入力するか、QRコードを使ってモバイル版ゲームにログインするためのモーダルウィンドウが開きます。
- ユーザーはモバイルデバイスを使用してQRコードをスキャンします。
- ウェブショップはユーザーのモバイル端末で開きます。
- ユーザーは自動的にゲームにリダイレクトされ、認証されたユーザーとしてウェブショップに戻ります。
サービスインタラクションフロー
セットアップ方法
ゲーム側
- ゲームのモバイルアプリ設定で、ディープリンク経由でゲームを開くためのURLスキームを新規登録してください:
- Androidアプリ —
AndroidManifest.xml
ファイル - iOSアプリ —
Info.plist
ファイル
- Androidアプリ —
- スキームを登録した後、ユーザーがゲームを介してウェブショップで認証すると、ゲームは指定されたアドレスでゲームが開きます。
- ゲームを登録するためのURLスキームの例:
gamename
— ユーザー認証のためにモバイル端末で開く必要があるゲームの名前。authorize
— ゲーム名のゲームが開いた後に実行されるべきアクション名の例。アプリケーションのOSのアクションと一致するアクション名を使用します。operationPayload=<VALUE>
— 認証時にトークンを生成するための情報を含む追加パラメータ。
gamename://authorize?operationPayload=<VALUE>
、ここで:- 例:
- xml
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLSchemes</key>
<array>
<string>gamename</string>
</array>
</dict>
</array>

- ゲームのユーザーIDを使用したJWT形式の認証トークンの生成を実装します。
パラメータ | 種類 | 説明文 |
---|---|---|
loginId | string | アドミンページからの認証メソッドのID。必須。 |
settings.projectId | string | ブラウザのアドレスバーでプロジェクト名の横に指定されている、アドミンページで確認できるプロジェクトID。URLの形式は次のようになります:https://publisher.xsolla.com/<merchantId>/projects/<projectId> 。必須。 |
settings.merchantId | string | パブリッシャーアカウントにあるマーチャントID。パブリッシャーアカウントの任意のページの会社設定 > 会社セクションまたはブラウザアドレスバーで指定されます。URLの形式は次のようになります:https://publisher.xsolla.com/<merchantId>/ 。必須。 |
user.id | string | ゲーム内のユーザーID。必須。 |
user.country | string | 2文字の国コードは、ISO 3166-1 alpha-2に従って使用されます。エクソーラがサポートしている国と国の決定プロセスの詳細については、ドキュメンテーションを確認してください。必須。 例:US |
operationPayload | string | 認証時のトークン生成に関する情報を含む追加のパラメーターです。必須。 |
- curlを使用してユーザートークン生成のAPIメソッドを呼び出す例:
- curl
- 認証成功の通知を含むポップアップウィンドウを追加します(任意)。
- 取得したユーザートークンを使用して、「ブラウザでウェブショップを開く」を実装します。
- カスタムドメインを使用している場合は
https://example.com/?token={token}
- エクソーラドメインをしようしている場合は
https://example.xsolla.site/?token={token}
- パブリッシャーアカウントのプロジェクトを開き、サイトビルダーに移動します。
- ウェブショップサイトのカード上で、ユーザーID経由の認証が設定されている場合、「構成」をクリックしてください。
- 「ログイン設定」に移動し、「ユーザーID」セクションを選択します。
- 「ディープリンク認」トグルを有効にします。
- 「ディープリンクURL」フィールドに、ユーザー認証用のリンクを入力します。
- サイトで「ファストログイン」ブロックを使用している場合:
- ファストログインブロックに移動します。
- 「レイアウト」セクションで、「QRコード」トグルを有効にします。
- 認証を確認するには、「プレビュー」をクリックしてください。
- ウェブサイトを公開するには、「公開」をクリックします。
curl -X 'POST' \
'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
-H 'accept: /' \
-H 'Content-Type: application/json' \
-d '{
"loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
"settings": {
"projectId": 123456,
"merchantId": 123456
},
"user": {
"id": "123",
"country": "US"
}
"operationPayload": "kosarb2NyrtIWaegJAH1f6P7XrBYPXYDya5coc_ZzcfiS_5o4QTUAL-CcGRC_Kv4CAtg"
}'
{token="JWT_TOKEN"}
のような応答が返されます。- 認証されたユーザーがブラウザでウェブショップを開くためのURLを作成する例:
- ここで、
{token}
はユーザーの認証トークンです。サイトビルダー内
「ファストログイン」ブロックのセットアップ
ファストログインブロックは、ユーザーがサイト上で認証するための追加の方法を提供します。
ブロックの外観とその機能は、選択した認証方法によって異なります。
サイトにユーザーIDによる認証が構成されている場合、ファストログインブロックにはIDを入力するフィールドとログインボタンが表示されます。
機能:
- モーダルウィンドウへの追加の遷移なしでのユーザー認証。
- ブロックのコンテンツを設定します。以下のセクションを有効にして構成することができます:
- タイトル
- 説明
- ユーザーIDの見つけ方
- カスタム背景
また、JSコードを使って、テキストやボタン、画像を追加するなど、ブロックの機能を拡張することもできます。

サイトにエクソーラログインによる認証が設定されている場合、ファストログインブロックに認証を呼び出す追加のボタンが表示されます。ブロック内のボタンをクリックすると、「エクソーラログイン」メソッドのいずれかを使って認証するためのモーダルウィンドウが開きます。
機能:
- 認証を求めるボタンのテキストを設定する
- カスタム背景を設定する
また、JSコードを使って、テキストやボタン、画像を追加するなど、ブロックの機能を拡張することもできます。
新しいサイトの場合、ファストログインブロックはデフォルトでウェブショップテンプレートに追加されますが、必要に応じて削除できます。
先に作成したサイトにファストログインブロックがない場合は、追加することができます。
ファストログインブロックを追加するには:
- アドミンページであなたのプロジェクトを開きます。
- サイドメニューで、「サイトビルダー」をクリックします。
- 「サイト」セクションで、サイトを選択し、「サイトビルダーを開く」をクリックします。
- 「ブロックを追加」をクリックします。
- 「ファストログイン」ブロックを選択します。
次のステップ
お役立ちリンク
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。