カスタムアカウント
パブリッシャーがすでにプレイヤーアカウントシステムを運用している場合、FirstLookと連携することで、プレイヤーは既存のパブリッシャーアカウントを使ってプレイテストにサインアップ・ログインできます。FirstLookはプレイヤーのID情報の正源としてパブリッシャーアカウントを信頼し、パブリッシャーアカウントが対応している場合には、プレイヤーがすでに連携済みのプラットフォームアカウントを自動的に取り込むため、サインアップ時に再連携する手間がかかりません。
カスタムアカウント連携は個別に設定するものであり、FirstLookとのパートナーシップのもとで構築します。主に、グローバルなアカウントサービスのもとで複数のゲームを運営するパブリッシャーに適しています。導入をご検討の場合は、FirstLookチームまでお問い合わせください。
OAuth標準
Section titled “OAuth標準”FirstLookはOAuth 2.0 Authorization Code フローを使用してパブリッシャーアカウントと連携し、理想的にはOpenID Connectを組み合わせて使用します。パブリッシャーアカウントプロバイダーは以下を公開する必要があります：
- Authorization Code グラント：
S256を使用したPKCEを強く推奨します。PKCEをサポートしていない場合、FirstLookはクライアントクレデンシャルを使用したトークンエンドポイントでのHTTP Basic認証にフォールバックできます。 - 標準OIDCエンドポイント：
authorize、token、userinfo。 - スコープ：最低限
openid。メール、ニックネーム、年齢、連携アカウントデータへのアクセスに必要に応じて追加スコープをリクエストします。 - リダイレクトURI：FirstLookはパブリッシャーアカウントプロバイダーが受け入れるリダイレクトURIを所有します。正確なURIはオンボーディング後にFirstLookの管理設定ページに表示されます。
- 安定したサブジェクト：トークンまたはuserinfoレスポンスに含まれる安定した
sub識別子。FirstLookはこれをプレイヤーレコードのパブリッシャーアカウントIDとして保存し、リピートプレイヤーの識別に使用します。
FirstLookがuserinfoから読み取る情報
Section titled “FirstLookがuserinfoから読み取る情報”| フィールド | 用途 |
|---|---|
sub | 必須。FirstLookプレイヤーのパブリッシャーアカウントIDとして保存され、リピートプレイヤーの照合に使用されます。 |
| ユーザー名 / ニックネーム | プレイヤーレコードに表示されます。 |
| メール（オプションで確認済み） | サインアップのメールステップに事前入力されます。ここで返すか、コンパニオン管理APIを通じて返すことができます。 |
| 年齢 | オプション。年齢制限のあるフローで年齢適格性のゲーティングに使用されます。 |
| 連携プラットフォームアカウント | オプションですが強力な機能です。以下を参照してください。 |
既存の連携プラットフォームアカウントの同期
Section titled “既存の連携プラットフォームアカウントの同期”パブリッシャーアカウントがすでにプレイヤーのSteam、Xbox、PlayStation、Epic、Discord、Google、またはAppleアカウントの連携を把握している場合、FirstLookはサインアップ時にそれらを自動的に取り込めます。プレイヤーはプレイテストフローで各プラットフォームを再連携する必要がなく、パブリッシャーアカウントでサインインするだけで連携済みプラットフォームのIDがFirstLookに引き継がれます。
各連携プラットフォームについて、FirstLookは安定したプロバイダーIDと表示名を必要とします。代表的な識別子は以下のとおりです：
| プラットフォーム | 識別子 |
|---|---|
| Steam | steam_id |
| Xbox | xbox_live_id |
| PlayStation | psn_id |
| Epic | epic_id |
| Discord | discord_id |
google_id | |
| Apple | apple_id |
パブリッシャーアカウントプロバイダーは、以下のいずれかの方法でこれらを公開できます：
- userinfoレスポンスにインラインで含める — 最もシンプルな方法です。FirstLookはプレイヤーが認証した後に返されるuserinfoペイロードから連携アカウントのマップを直接読み取ります。
- コンパニオン管理APIを経由する — 連携アカウントデータがuserinfoに含めるには機密性が高すぎるか、データ量が大きすぎる場合、FirstLookはClient Credentialsグラントで別のアクセストークンを取得し、サーバー間エンドポイント（例：
GET /users/:sub）を呼び出してデータを取得できます。
取り込まれた連携アカウントはFirstLook独自のプラットフォーム連携によってデータが拡充されます。たとえば、連携済みのSteamアカウントはSteam連携を通じて国、プレイ時間、ウィッシュリストのデータを取得できます。
FirstLook APIの使用
Section titled “FirstLook APIの使用”FirstLookにパブリッシャーアカウントのプレイヤーが存在するようになると、独自のバックエンドからすでに発行済みの識別子を使ってデータを取得できます。FirstLook APIトークンは/players/searchと/players/findエンドポイントを公開しており、パブリッシャーアカウントIDをルックアップキーとして受け付けます。これにより以下が可能になります：
- FirstLookのプレイヤーを自社システムのレコードと照合する
- ネイティブIDに対してアナリティクス、所有権、ウィッシュリスト、プレイ時間データをエクスポートする
- 二重のマッピングレイヤーなしにダッシュボード、CRM、またはコミュニティツールを拡充する
完全なAPIリファレンスはapi.firstlook.gg/external/swagger-uiでご覧いただけます。必要な機能が公開されていない場合は、お問い合わせいただければ追加を検討します。
SSOモード
Section titled “SSOモード”FirstLookはサインアップをパブリッシャーアカウントに限定する「ロック」モードをサポートしています。idp_hintクエリパラメータを使ってプレイヤーをプレイテストに誘導すると、パブリッシャーアカウントのOAuthフローに直接ルーティングされ、パブリッシャーが提供するデータがフローの要件をすでに満たしている場合は、標準のマルチメソッドサインアップフォームをスキップします：
https://your-playtest.firstlook.gg/signup/your-flow?idp_hint=your-providerSSOモードと他のサインアップ方法の無効化を組み合わせることで、パブリッシャーアカウントを唯一の入口にできます。これは、リワードプログラムのメンバーやアクティブなパブリッシャーアカウントの保有者など、エコシステムの認証済みメンバーにプレイテストをゲーティングする必要がある場合に有効です。
セットアップの準備
Section titled “セットアップの準備”カスタムアカウント連携はFirstLookチームとともにスコープを決定します。準備として、以下を揃えておいてください：
- パブリッシャーアカウントプロバイダーのOAuthエンドポイントURL（
authorize、token、userinfo、および管理APIがある場合はそのURL）。 - FirstLook向けに発行されたクライアントクレデンシャル（
client_idとclient_secret）。 - メール、ニックネーム、年齢、連携アカウントデータを取得するために必要なスコープ。
- FirstLookのリダイレクトURIをご自身のシステムに登録すること（FirstLookから提供されます）。
- 連携アカウントデータの公開方法の決定 — userinfoにインラインで含めるか、サーバー間管理APIを経由するか。
- 連携をSSOモード（パブリッシャーアカウントのみ）で運用するか、FirstLookの他のサインアップ方法と並列して提供するかの決定。