メールアドレスや電話番号の収集

どのように動作するか

ログイン製品は、ログインプロジェクトに提供されたユーザーがアプリケーションに登録またはログインする際に、自動的に連絡先情報を保存します。この情報はエクソーラのデータベースに保存され、ユーザーの電子メールアドレスや電話番号も含まれます。場合によっては、例えば、すべての連絡先が渡されるわけではありません：

• パスワードレスログインオプションでは、ワンタイムコードを受け取るためにユーザーが指定した連絡先情報のみが、ログインプロジェクトに渡されます。
• ソーシャルネットワークを通じて認証する場合、そのプロバイダーはユーザーのメールアドレスに関する情報を渡さない場合があります。

さらに、ログイン製品を使用して欠落している連絡先の詳細を要求し、それらを使用して次のことを行うことができます：

• ユーザーのメールをMailchimpアカウントにエクスポートし、ニュースレターリストに追加します。
• メールアドレスまたは電話番号に基づいて、ユーザーの一意の識別子を作成します。

使用に適した方

すでにログインを統合しているパートナーはもちろん、ソーシャルネットワーク経由でアプリケーションにログインするオプションやパスワードレス認証を使用するオプションも設定されています。

入手方法

ログインプロジェクトで選択した統合オプションに応じて、メールアドレスと電話番号の収集方法を設定することができます：

• Login widget v2.0経由
• ログインAPIコール経由

Login widget v2.0経由でメールアドレスや電話番号の収集

ログインウィジェットv2.0では、メールアドレスや電話番号が提供されていない場合、ユーザーに入力を促すことができます：

• ソーシャルネットワークから登録した場合；
• ワンタイムコードで入力する場合（パスワードレス認証の場合）。

発行者アカウントで電子メールアドレスや電話番号のリクエストを有効にすると、ログインプロジェクトが自動的に以下のことを実行されます：

1. 電子メールアドレスや電話番号を入力するためのフォームを表示する；
2. フォームに入力した後、入力した情報を確認するためのコードやリンクをユーザーに送信する；
3. 確認コードをチェックし、受信した情報をデータベースに保存する。

ユーザーがフォームに記入することを義務付けることができます。

ユーザーのメールアドレスと電話番号の収集を有効にするには：

1. アドミンページでプロジェクトを開き、「ログイン」セクションに移動します。
2. ログインプロジェクトのパネルで「構成」をクリックします。
3. 「認証」ブロックに移動し、「雑多なデータフォーム」セクションを選択します。

4. ログインプロジェクトで、ユーザーがメールアドレスを指定できるフォームを表示させたい場合：
   1. ユーザーのメールアドレスを収集するトグルをオンに設定します。
   2. メールアドレスの確認方法を選択します：コードによるまたはコードとリンクによる。
5. ユーザーにメールアドレスの入力を要求するには、ユーザーにメールフォームへの入力を要求するをオンに切り替えます。
6. ログインプロジェクトで、ユーザーが自分の電話番号を指定できるフォームを表示する場合は、ユーザーの電話番号を収集するトグルをオンに設定します。

7. ユーザーに電話番号の入力を求めるには、ユーザーに電話番号の入力を要求するトグルをオンに設定します。
8. メールアドレス収集フォームと電話番号収集フォームの両方を有効にした場合、ページ下部のドロップダウンリストで、ユーザーに表示する順番を選択します。

ログインAPIコール経由でメールアドレスの収集

ログインAPIを使用すると、ソーシャルネットワーク経由で登録した際にメールアドレスが提供されなかった場合、ユーザーにメールアドレスの入力を促すことができます。

ログインプロジェクトをログインAPIコールで統合した場合：

• JWT標準のAuth via social networkコールを使用する時、fields=emailパラメータを追加します。

リクエストの例：

GET https://login.xsolla.com/api/social/{providerName}/login_redirect?projectId={projectId}&fields=email&login_url={login_url} HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/social/providerName/login_redirect?projectId=projectId&fields=email&login_url=login_url'

• OAuth 2.0プロトコルでのAuth via social networkコールを使用する時、scope=emailパラメータを追加します。

リクエストの例：

GET https://login.xsolla.com/api/oauth2/social/{providerName}/login_redirect?scope=email&client_id={client_id}&redirect_uri={redirect_uri}&state={state}&response_type=code HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/social/provider_name/login_redirect?scope=email&client_id=client_id&redirect_uri=redirect_uri&state=state&response_type=code'