Steam

FirstLook은 Steamworks(Steam 퍼블리셔 계정)와 깊게 연동되어, 스토어에 노출되지 않는 플레이테스트 등 모든 게임의 플레이 시간을 추적할 수 있습니다. 또한 플레이테스터의 위시리스트·소유 여부를 추적합니다.

Steamworks를 FirstLook에 연동하려면

연동을 켜려면 Steam Publisher WebAPI 키를 만들어 FirstLook과 공유해야 합니다. 이 키는 Steam Web API에 접근해 필요한 정보를 가져오는 데 쓰이며, 안전하게 저장되고 플레이 시간 데이터 조회 목적으로만 사용됩니다. 사용하는 엔드포인트·데이터는 다음과 같습니다.

• 플레이어 소유·플레이 시간 – 플레이어가 게임을 소유하는지, 얼마나 플레이했는지 확인합니다.
• 앱 ID·빌드 목록 – 퍼블리셔 계정의 앱 ID와 빌드 목록을 가져와 추적에 맞는 항목을 선택합니다.

Publisher Web API 키에 대한 자세한 내용은 Steamworks 공식 문서를 참고하세요.

WebAPI 키 만들기

1. Steamworks 파트너 포털에 로그인합니다.
2. ‘Users & Permissions > Manage Groups’로 이동합니다.
3. ‘Create New Group’을 클릭하고 알아보기 쉬운 그룹 이름을 입력합니다(예: ‘FirstLook WebAPI’).
4. 새 그룹 페이지에서 ‘Add Application’으로 게임을 추가합니다.
5. 자동완성에 메인 게임 제목을 입력하고, ‘Include child apps (DLC, demos, tools) when adding the parent app’ 체크박스를 선택합니다.
6. 사이드바에서 ‘Create WebAPI Key’를 클릭합니다.
7. ‘Manage WebAPI Key’ 탭에서 ‘Key Permissions’ 아래 General이 선택되어 있는지 확인합니다.
8. 아래 상자에 표시된 키를 복사합니다.

이제 FirstLook Steam 연동 설정에 키를 붙여 넣고 ‘Save’를 클릭합니다.

스토어 페이지 노출 및 위시리스트 추적

Steamworks를 연동한 뒤에는 드롭다운에서 스토어 페이지로 쓸 앱 ID를 선택할 수 있습니다. 스토어 페이지나 위시리스트를 요청할 때 이 앱 ID가 사용됩니다.

스토어 앱 ID를 수동 입력하는 경우

WebAPI 키를 아직 넣지 않았다면 스토어 앱 ID만 수동으로 넣을 수 있습니다. 스팀 스토어에 공개된 게임에 한해 위시리스트 추적이 제한적으로 가능합니다. 일반적으로 플레이테스트는 플레이어 프로필에 보이지 않아 제대로 추적되지 않을 수 있습니다. 더 정확한 추적을 위해 WebAPI 키 사용을 권장합니다.

위시리스트 분석 (Financial API Key)

Steamworks Financial API 키를 추가하면 FirstLook이 Steam의 공식 위시리스트 리포트를 통해 앱의 일별 위시리스트 성과(신규 위시리스트, 삭제, 구매, 누적 합계)를 추적합니다. 데이터는 Steam 분석 페이지에 Steam Wishlists 그래프로 표시됩니다.

Financial API 키는 Financial 권한이 있는 별도의 Publisher WebAPI 키입니다. 안전하게 저장되며 위시리스트 리포트(Steam의 GetAppWishlistReporting 엔드포인트) 용도로만 사용됩니다. 일별 집계 수치만 다루며 개별 플레이어 정보는 포함하지 않습니다.

요구 사항

• 인증된 Steam 스토어 앱 ID – 스토어 앱 ID를 설정하고(위 참고) WebAPI 키를 저장하면 앱 ID가 자동으로 인증됩니다.
• Financial 권한이 있는 키를 만들 수 있도록 Steamworks 계정에서 재무 데이터에 접근할 수 있어야 합니다.

Financial API Key 만들기

위의 WebAPI 키 만들기와 거의 같은 단계입니다. 참고 스크린샷은 해당 섹션을 확인하세요.

1. Steamworks 파트너 포털에 로그인합니다.
2. ‘Users & Permissions > Manage Groups’로 이동합니다.
3. FirstLook WebAPI 키에 사용한 그룹을 열거나, 새 그룹(예: ‘FirstLook Financial’)을 만들어 게임을 추가합니다. 위 WebAPI 키 단계와 같은 흐름입니다.
4. 사이드바에서 ‘Create WebAPI Key’를 클릭합니다.
5. ‘Manage WebAPI Key’ 탭에서 ‘Key Permissions’ 아래 Financial이 선택되어 있는지 확인합니다.
6. 아래 상자에 표시된 키를 복사합니다.

이제 Steam 연동 설정의 ‘Financial API Key’ 필드에 키를 붙여 넣고 ‘Save’를 클릭합니다.

저장하면 FirstLook이 스토어 앱 ID의 위시리스트 리포트를 요청해 키를 검증합니다. 다음 두 가지 오류가 발생할 수 있습니다.

• “Invalid Steam Financial API Key” – Steam이 키를 거부했습니다. 오타가 없는지, ‘Key Permissions’에서 Financial이 선택되어 있는지 확인하세요.
• “The Financial API Key does not have access to this game’s Steam app” – 키는 유효하지만 키가 속한 그룹이 스토어 앱 ID에 접근할 수 없습니다. Steamworks 포털에서 키의 그룹에 게임을 추가하세요.

저장이 끝나면 FirstLook이 Steam에 위시리스트 데이터가 있는 가장 이른 날짜까지 전체 기록을 백필하고, 이후 하루에 한 번 수치를 갱신합니다.

인사이트

수집된 데이터에는 공개 프로필 기준 위시리스트와 모든 플레이테스터의 플레이 시간, 그리고 Financial API 키를 추가한 경우 앱의 일별 위시리스트 합계가 포함됩니다.