커스텀 계정
퍼블리셔가 이미 플레이어 계정 시스템을 운영하고 있다면, FirstLook과 연결하여 플레이어가 기존 퍼블리셔 계정으로 플레이테스트에 가입하고 로그인할 수 있습니다. FirstLook은 플레이어 신원의 기준으로 퍼블리셔 계정을 신뢰하며, 퍼블리셔 계정이 지원하는 경우 플레이어가 이미 연결한 플랫폼 계정을 자동으로 가져와 가입 시 다시 연결할 필요가 없도록 합니다.
커스텀 계정 연동은 맞춤형으로 설정되며 FirstLook과 협력하여 구성됩니다. 일반적으로 글로벌 계정 서비스 아래에서 여러 게임을 운영하는 퍼블리셔에게 적합합니다. 퍼블리셔에 대한 논의를 원하시면 FirstLook 팀에 문의하세요.
OAuth 표준
섹션 제목: “OAuth 표준”FirstLook은 OAuth 2.0 Authorization Code 플로우를 사용하여 퍼블리셔 계정과 연동하며, 이상적으로는 OpenID Connect와 함께 사용합니다. 퍼블리셔 계정 제공자는 다음을 제공해야 합니다:
- Authorization Code grant:
S256을 사용하는 PKCE가 강력히 권장됩니다. PKCE가 지원되지 않는 경우, FirstLook은 클라이언트 자격증명을 사용하여 토큰 엔드포인트에서 HTTP Basic 인증으로 대체할 수 있습니다. - 표준 OIDC 엔드포인트:
authorize,token,userinfo. - 스코프: 최소
openid. 이메일, 닉네임, 나이, 연결된 계정 데이터에 접근하기 위해 필요에 따라 추가 스코프를 요청합니다. - Redirect URI: FirstLook이 redirect URI를 소유하며, 퍼블리셔 계정 제공자는 이를 허용해야 합니다. 정확한 URI는 온보딩 완료 후 FirstLook 관리자 설정 페이지에서 확인할 수 있습니다.
- 안정적인 subject: 토큰 또는 userinfo 응답에 안정적인
sub식별자가 포함되어야 하며, FirstLook은 이를 플레이어 레코드에 퍼블리셔 계정 ID로 저장하고 재방문 플레이어를 식별하는 데 사용합니다.
FirstLook이 userinfo에서 읽는 항목
섹션 제목: “FirstLook이 userinfo에서 읽는 항목”| 필드 | 목적 |
|---|---|
sub | 필수. FirstLook 플레이어의 퍼블리셔 계정 ID로 저장되며 재방문 플레이어를 매칭하는 데 사용됩니다. |
| 사용자 이름 / 닉네임 | 플레이어 레코드에 표시됩니다. |
| 이메일 (선택적으로 인증됨) | 가입의 이메일 단계를 미리 채웁니다. 여기서 반환되거나 동반 관리자 API를 통해 반환될 수 있습니다. |
| 나이 | 선택 사항. 나이 제한이 필요한 플로우에서 나이 자격 게이팅에 사용됩니다. |
| 연결된 플랫폼 계정 | 선택 사항이지만 강력한 기능 — 아래를 참조하세요. |
기존 연결된 플랫폼 계정 동기화
섹션 제목: “기존 연결된 플랫폼 계정 동기화”퍼블리셔 계정이 이미 플레이어의 Steam, Xbox, PlayStation, Epic, Discord, Google 또는 Apple 계정 연결 정보를 알고 있다면, FirstLook은 가입 중에 이를 자동으로 가져올 수 있습니다. 플레이어는 플레이테스트 플로우에서 각 플랫폼을 다시 연결할 필요 없이 퍼블리셔 계정으로 로그인하기만 하면 연결된 플랫폼 신원이 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 grant를 통해 별도의 액세스 토큰을 획득하고 서버 간 엔드포인트(예:
GET /users/:sub)를 호출하여 데이터를 가져올 수 있습니다.
가져온 후, 이러한 연결된 계정은 FirstLook의 자체 플랫폼 연동을 통해 보강됩니다. 예를 들어, 연결된 Steam 계정은 Steam 연동을 통해 국가, 플레이 시간, 위시리스트 데이터를 얻습니다.
FirstLook API 사용
섹션 제목: “FirstLook API 사용”퍼블리셔 계정 플레이어가 FirstLook에 존재하게 되면, 자체 백엔드에서 이미 발급한 동일한 식별자를 사용하여 데이터를 가져올 수 있습니다. FirstLook API 토큰은 퍼블리셔 계정 ID를 조회 키로 허용하는 /players/search 및 /players/find 엔드포인트를 노출하여 다음을 수행할 수 있습니다:
- FirstLook 플레이어를 자체 시스템의 레코드와 조정
- 네이티브 ID에 대한 분석, 소유권, 위시리스트 및 플레이 시간 데이터 내보내기
- 두 번째 매핑 레이어 없이 대시보드, CRM 또는 커뮤니티 툴링 강화
전체 API 참조는 api.firstlook.gg/external/swagger-ui에서 확인할 수 있습니다. 필요한 기능이 노출되어 있지 않다면 문의하기를 통해 추가 여부를 논의하겠습니다.
SSO 모드
섹션 제목: “SSO 모드”FirstLook은 가입이 퍼블리셔 계정으로 제한되는 “잠금” 모드를 지원합니다. idp_hint 쿼리 파라미터를 사용하여 플레이어를 플레이테스트에 연결하면 퍼블리셔 계정 OAuth 플로우로 바로 이동하며, 퍼블리셔가 제공한 데이터가 플로우의 요구 사항을 이미 충족하는 경우 표준 다중 방법 가입 양식을 완전히 건너뜁니다:
https://your-playtest.firstlook.gg/signup/your-flow?idp_hint=your-providerSSO 모드와 플로우의 다른 가입 방법 비활성화를 결합하면 퍼블리셔 계정이 유일한 진입 경로가 됩니다. 이는 플레이테스트를 생태계의 인증된 멤버(예: 리워드 프로그램 멤버 또는 활성 퍼블리셔 계정 보유자)로 제한해야 할 때 유용합니다.
설정 시작하기
섹션 제목: “설정 시작하기”커스텀 계정 연동은 FirstLook 팀과 함께 범위를 정합니다. 준비를 위해 다음을 준비해 두세요:
- 퍼블리셔 계정 제공자의 OAuth 엔드포인트 URL (
authorize,token,userinfo, 및 관리자 API 포함). - FirstLook에 발급된 클라이언트 자격증명 (
client_id및client_secret). - 이메일, 닉네임, 나이 및 연결된 계정 데이터를 가져오는 데 필요한 스코프.
- FirstLook의 redirect URI를 귀사 측에 등록 (FirstLook이 제공).
- 연결된 계정 데이터를 노출하는 방식 결정 — userinfo에 인라인으로 포함하거나 서버 간 관리자 API를 통해 제공.
- 연동을 SSO 모드(퍼블리셔 계정 전용)로 실행할지, FirstLook의 다른 가입 방법과 함께 하나의 옵션으로 제공할지 결정.