콘텐츠로 이동
Get Started

Google Play

FirstLook에서 플레이어 온보딩 과정의 일부로 Google Play를 연동할 수 있습니다.

Google Play 계정을 FirstLook에 연동하려면

섹션 제목: “Google Play 계정을 FirstLook에 연동하려면”

Google Play 비공개 테스트를 FirstLook에 연결하려면 Google Play Console에서 참여(Opt-in) URL, 즉 Join URL을 가져오는 것이 핵심입니다. 이 링크로 승인된 테스터가 초대를 수락하고 Play 스토어에서 게임을 받을 수 있습니다.

  1. Google Play Console에 로그인합니다.
  2. 목록에서 앱을 선택합니다.
  3. 왼쪽 사이드바에서 Test and release > Closed testing으로 이동합니다.
  4. 사용할 트랙(예: “Alpha”)을 찾아 Manage track을 클릭합니다.
  5. Testers 탭을 선택합니다.
  6. “How testers join your test” 섹션까지 스크롤합니다.
  7. Web URL 옆 Copy link를 클릭합니다.

Google Play

새 개인 개발자 계정을 쓰는 경우, 프로덕션 신청 전 Google이 의무적인 테스트 기간을 요구할 수 있습니다.

  • 최소 테스터: 비공개 테스트에 옵트인한 테스터가 최소 20명이어야 합니다.
  • 테스트 기간: 이 테스터는 최소 14일 동안 연속으로 옵트인 상태를 유지하고 앱을 사용해야 합니다.

FirstLook은 테스터 이메일 수집을 자동화하고, 온보딩을 마친 직후 Join 링크를 전달해 이런 요건을 맞추는 데 도움이 됩니다.

Unity SDK를 사용해 게임 클라이언트에서 직접 플레이어를 인증하는 경우, FirstLook이 Google ID 토큰을 검증할 수 있도록 OAuth 2.0 클라이언트 ID를 구성해야 합니다.

Google Cloud Console에서 OAuth 2.0 클라이언트 ID 만들기

섹션 제목: “Google Cloud Console에서 OAuth 2.0 클라이언트 ID 만들기”
  1. Google Cloud Console로 이동해 프로젝트를 열거나 새로 만듭니다.
  2. APIs & Services > Credentials로 이동합니다.
  3. Create Credentials > OAuth 2.0 Client ID를 클릭합니다.
  4. 애플리케이션 유형으로 Web application을 선택합니다.
    • 이것이 FirstLook이 서버 측에서 ID 토큰을 검증하는 데 사용하는 클라이언트 ID입니다. 여기에 Android 클라이언트 ID를 사용하지 마세요.
  5. 이름(예: “FirstLook Token Verification”)을 입력하고 Create를 클릭합니다.
  6. 클라이언트 ID(123456789-abcdefg.apps.googleusercontent.com 형태)를 복사합니다.

Android 앱 등록 (Android에서 Google 로그인에 필수)

섹션 제목: “Android 앱 등록 (Android에서 Google 로그인에 필수)”

Android 빌드에서 Google 로그인이 동작하려면, Google이 로그인 요청을 검증할 수 있도록 앱을 Android OAuth 클라이언트로도 등록해야 합니다.

  1. APIs & Services > Credentials에서 Create Credentials > OAuth 2.0 Client ID를 다시 클릭합니다.
  2. 애플리케이션 유형으로 Android를 선택합니다.
  3. 앱의 패키지 이름(예: com.yourcompany.yourgame)과 서명 키의 SHA-1 인증서 지문을 입력합니다.
    • 디버그 SHA-1 확인 방법: keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • 릴리스 빌드의 경우 릴리스 키스토어의 SHA-1을 사용하세요.
  4. Create를 클릭합니다. 이 Android 클라이언트 ID는 FirstLook에 추가할 필요가 없습니다 — Google이 앱의 로그인 요청을 수락하는 데만 필요합니다.

FirstLook에 Web 클라이언트 ID 추가하기

섹션 제목: “FirstLook에 Web 클라이언트 ID 추가하기”
  1. FirstLook 대시보드에서 Config > Google Play로 이동합니다.
  2. 위에서 만든 Web application 클라이언트 ID를 허용 목록에 추가합니다.
  3. Save를 클릭합니다.

Google 로그인 라이브러리에서 구성하는 클라이언트 ID와 FirstLook 대시보드의 클라이언트 ID가 일치해야 합니다. ID 토큰을 SDK에 전달하는 방법은 Unity SDK Setup 가이드를 참고하세요.

연동에 필요한 정보를 준비했다면 FirstLook에서 다음을 진행합니다.

  1. 여기에서 Google Play를 켜 가입·온보딩 중 계정 연결을 허용합니다.
  2. 테스터는 Google Play Console에 수동으로 올려야 합니다. 비공개 테스트 트랙의 ‘Testers’ 탭에서 CSV로 FirstLook 플레이어를 업로드합니다.
  3. 플레이어에게 배포할 새 키 유형을 만듭니다. ‘Keys & Access’ 탭에서 할 수 있습니다.
    • 앞에서 만든 URL을 여기에 넣을 수 있습니다.

Key Setup

Google Play Upload