추가 가이드

now.gg의 서비스와 API를 편리하게 설정 및 적용하는 데 도움이 될 만한 Cloud와 관련된 추가 가이드입니다.

추가 가이드

아래를 참조해 주시기 바랍니다:

• 유저 상태 저장을 위한 클라우드 스토리지 설정
• 앱 파일 준비
• 커스텀 도메인 추가 및 구성
• now.gg CLI를 통한 앱 업로드
• 구독 이해하기

유저 상태 저장을 위한 클라우드 스토리지 설정

이때 저장 파일 경로와 제외 파일 경로를 정의하여 유저의 게임 진행 데이터를 저장하고 복원하기 위한 now.gg 클라우드 스토리지를 설정하실 수 있습니다.

‘저장’ 및 ‘제외’ 파일 경로를 정의하는 것은 게임 로딩 시간을 줄여 유저의 플레이 경험을 향상하고 now.gg 클라우드 스토리지를 최적으로 사용하는 필수 방법 중 하나입니다.

스토리지 설정 요구 사항:

• 저장 파일 경로
  클라우드에 저장할 파일이나 폴더의 위치를 나타내며 일반적으로 /data/data/<package_name>/<file_name>에 저장됩니다.
• 제외 파일 경로
  클라우드에 저장하지 않을 파일 및 폴더의 위치를 나타냅니다.

파일 경로 설정

현재 now.gg에서 새로 출시하는 모든 앱에 대해 해당 설정을 적용하실 수 있으며 이미 출시된 앱의 경우 새 버전의 앱을 출시해야 합니다.

방법:

• nowStudio에 로그인합니다.
• 선택:
  • 새 앱 추가
    • 여기를 따라 새 앱을 추가합니다.
  • 새 버전 출시
    • 여기를 따라 새 버전을 출시합니다.
• ‘앱 콘텐츠’ 탭에서:
  • 저장 파일 경로 및 제외 파일 경로를 입력합니다.
    
  • 저장을 클릭합니다.
• 왼쪽 메뉴에서 릴리스를 클릭합니다.
  • 릴리스를 생성합니다.

설명:

• 파일 경로가 여러 개인 경우 공백이나 쉼표 대신 새 줄로 각 경로를 구분합니다.
• 저장 파일 경로의 경우 지정한 파일과 폴더만 다음 플레이 세션을 위해 저장되고 복원됩니다.
• 제외 파일 경로(선택 사항)의 경우 지정한 파일과 폴더가 클라우드에 저장되지 않습니다.

앱 파일 준비

nowStudio에 업로드할 앱 파일을 준비합니다.

nowStudio를 사용하여 릴리스를 생성하려면 앱 파일을 준비해야 하며 이때 Standalone(독립형) APK, APK 및 에셋 Zip 파일이 허용됩니다.

{
    "assets": [
        {    
            "name": "asset1.xyz",
            "location": "/data/media/0/Android/data/<packageName>/files"
        },
        {
            "name": "asset2.unity3d",
            "location": "/data/media/0/Android/data/<packageName>/files"
        },
        {
            "name": "OtherAssets",
            "location": "/data/data/<packageName>/files"
        }
    ]
}

커스텀 도메인 추가 및 구성

now.gg가 아닌 다른 도메인에 앱을 호스팅하려는 경우 커스텀 도메인을 추가하는 과정입니다.

now.gg 클라우드 외에도 커스텀 도메인을 추가하여 다른 도메인에서 앱을 호스팅하실 수도 있습니다.

시나리오:

• 새 앱에 커스텀 도메인 추가
• 이미 출시된 앱에 커스텀 도메인 추가

1. 새 앱에 커스텀 도메인 추가

새 앱에 커스텀 도메인을 추가하는 단계입니다.

방법:

• 새 앱을 추가합니다.
• 모든 앱에서 앱을 선택합니다.
  • 앱 이름 옆에 있는 세부 정보를 클릭합니다.
• 프로덕션 내의 정보를 클릭합니다.
• 아래와 같이 해당 필드에 커스텀 도메인 주소를 입력합니다.
  
  중요: 추가하려는 도메인을 소유하고 있는지 확인해 주시기 바랍니다.
• 기타 필수 세부 정보를 입력했는지 확인합니다.
• 저장을 클릭합니다.
  • 입력된 도메인 정보는 검토되며 컨펌 후 도메인 매핑을 계속 진행하실 수 있습니다.
• 필요한 앱 세부 정보를 모두 입력한 후 릴리스를 생성하실 수 있습니다.
• 매핑 세부 정보를 받은 후 아래와 같이 ‘정보‘ 탭 내 ‘매핑 세부 정보‘를 클릭하면 해당 정보를 확인하실 수 있습니다.
  
• 아래와 같이 도메인 매핑 세부 정보가 제공됩니다.
  
• 제공된 세부 정보를 통해 DNS 공급자를 설정하실 수 있습니다.
• DNS 공급자를 통해 설정 후 해당 도메인에서 게임을 호스팅하실 수 있습니다.

2. 이미 출시된 앱에 커스텀 도메인 추가

이미 출시된 앱에 커스텀 도메인을 추가하는 단계입니다.

방법:

• 모든 앱에서 앱을 선택합니다.
  • 앱 이름 옆에 있는 세부 정보를 클릭합니다.
• 프로덕션 내의 정보를 클릭합니다.
• 오른쪽 하단의 수정 버튼을 클릭합니다.
  (이후 필드를 수정하실 수 있습니다)
• 아래와 같이 해당 필드에 커스텀 도메인 주소를 입력합니다.
  
  중요: 추가하려는 도메인을 소유하고 있는지 확인해 주시기 바랍니다.
• 저장을 클릭합니다.
• 아래와 같이 확인 메시지가 화면에 표시됩니다.
  
• 입력된 도메인 정보는 검토되며 컨펌 후 도메인 매핑을 계속 진행하실 수 있습니다.
• 매핑 세부 정보를 받은 후 아래와 같이 ‘정보‘ 탭 내 ‘매핑 세부 정보‘를 클릭하면 해당 정보를 확인하실 수 있습니다.
  
• 아래와 같이 도메인 매핑 세부 정보가 제공됩니다.
  
• 제공된 세부 정보를 통해 DNS 공급자를 설정하실 수 있습니다.
• DNS 공급자를 통해 설정 후 해당 도메인에서 게임을 호스팅하실 수 있습니다.

CLI를 통한 앱 업로드

nowgg CLI는 앱 빌드를 nowStudio에 쉽게 업로드할 수 있게 도와주는 커맨드 라인 도구입니다.

nowgg CLI

macOS 또는 Windows에서 터미널을 실행합니다.

설치 및 초기화

  pip install nowgg

  nowgg init --token "<your_publisherToken_from_nowStudio>"

nowgg CLI로 nowStudio에 앱 업로드

  nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <app_version_name> --version_code <app_version_code>

  nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <apk_version> --version_code <app_version_code> --deploy 

지원

  nowgg -h
   nowgg init -h
   nowgg upload -h

구독 이해하기

다음 문서는 nowStudio에서 제공하는 구독 기능의 중요한 측면에 초점을 맞춥니다.

구독은 now.gg에서 제공하는 앱 내 상품으로, 사용자에게 내 앱의 콘텐츠나 서비스에 접근할 수 있는 정기 요금을 부과합니다.

nowStudio는 ‘구독’ 기능을 통해 구독을 쉽게 생성, 관리 및 판매할 수 있는 다양한 기능을 제공합니다. 앱 내 상품과 구독 상품의 주요 차이점은 앱 내 상품은 사용자에게 일회성 요금이 부과되지만, 구독은 정기적인 요금이 부과된다는 점입니다.

nowStudio에서 구독을 생성하고 관리하는 방법을 이해하기 위해서는:

• 구독 생성 및 관리 섹션을 참조하세요.

now.gg 결제 모듈을 사용하여 앱에서 구독을 구현하는 방법을 이해하기 위해서는 다음 가이드를 따르세요:

• Unity
• 네이티브 안드로이드

중요: 이 페이지의 정보 외에도 now.gg 정책을 참조해야 합니다.

구독 개요

이 섹션에서는 구독에 대해 소개합니다.

• 구독
• 청구 기간
  • 자동 갱신
• 혜택
• 가격
  • 가격 변경

구독

구독은 사용자가 특정 기간 동안 접근할 수 있는 혜택의 집합을 제공합니다. 같은 앱 내에서 여러 구독을 가질 수 있어 다른 혜택 세트나 단일 혜택 세트의 다양한 계층을 나타낼 수 있습니다(예: ‘골드’ 및 ‘다이아몬드’ 팩). 사용자는 now.gg 앱 내에서 구매함으로써 구독에 접근할 수 있습니다.

청구 기간

now.gg에서는 구독 기간을 선택할 수 있습니다. 가능한 청구 기간은 다음과 같습니다:

• 4주마다
• 월간
• 2개월마다
• 3개월마다
• 4개월마다
• 6개월마다
• 8개월마다
• 연간

혜택

구독에 최대 네 가지 혜택을 추가할 수 있어 사용자가 받게 될 핵심 혜택을 강조해야 합니다.

결제 거절

갱신 결제가 거절되면 now.gg는 사용자에게 결제 문제를 해결하도록 요구합니다. 해결되지 않을 경우 구독이 자동으로 만료됩니다.