안드로이드 인앱결제 설정 - andeuloideu in-aebgyeolje seoljeong

인앱 상품 만들기

Google Play의 결제 시스템을 사용하면 사용자에게 일회성으로 금액을 청구하는 인앱 상품(일회성 제품)을 제공할 수 있습니다. 인앱 상품에는 Google Play의 앱에서 이용할 수 있는 가상 상품(예: 게임 레벨 또는 포션)과 프리미엄 서비스가 포함됩니다.

사용자에게 반복적으로 금액을 청구하는 정기 결제를 만들 수도 있습니다.

중요: 일회성 제품과 정기 결제를 비롯하여 모든 인앱 상품에는 Google Play 개발자 프로그램 정책 및 서비스 수수료가 적용됩니다.

사용 가능 여부

판매자 등록이 지원되는 지역에 있는 경우 Google Play 결제 시스템을 사용할 수 있습니다.

판매자 등록이 지원되는 지역에 거주 중이며 앱에서 Google Play의 결제 시스템 기능을 사용하려고 한다면 결제 프로필을 설정하고 Google Play 결제 시스템 API 문서를 검토하세요.

사용자에게 판매하려면 상품이 활성 상태이고, 앱이 게시된 상태여야 하며, 사용자의 국가에서 앱을 사용할 수 있어야 합니다.

테스트 계정을 사용 중인 경우 게시되지 않은 앱에서도 활성 상품을 구매할 수 있습니다. 자세한 내용은 Android 개발자 사이트를 참고하세요.

인앱 상품을 만들고 나면 최신 버전의 Google Play 스토어를 실행하는 사용자가 이용할 수 있게 됩니다.

필수 권한

인앱 상품을 제공하려면 앱의 APK 매니페스트 파일에서 com.android.vending.BILLING 권한을 선언해야 합니다. 전 세계에 앱을 배포하더라도 모든 국가를 대상으로 com.android.vending.BILLING 권한을 사용하는 앱을 게시할 수 있습니다.

인앱 상품 만들기

단일 인앱 상품 만들기

상품을 만들기 전에 상품 ID를 어떻게 만들지 신중하게 계획해야 합니다. 상품 ID는 앱별로 달라야 하며, 만들고 나면 변경하거나 다시 사용할 수 없습니다.

  • 상품 ID는 숫자 또는 소문자로 시작해야 하며 숫자(0~9), 소문자(a~z), 밑줄(_), 마침표(.)를 포함할 수 있습니다.
  • 상품을 만든 다음에는 상품 ID를 변경하거나 재사용할 수 없습니다. 
  • 참고: android.test라는 상품 ID는 사용할 수 없으며 android.test로 시작하는 모든 상품 ID도 마찬가지입니다.

인앱 상품을 만들려면 다음 단계를 따르세요.

  1. Play Console을 열고 인앱 상품 페이지(수익 창출 > 제품 > 인앱 상품)로 이동합니다.
  2. 상품 만들기를 클릭합니다.
  3. 상품 세부정보를 입력합니다.
    • 상품 ID: 인앱 상품의 고유 ID입니다.
    • 제목: 짧은 상품 이름입니다. 최대 길이는 55자(영문 기준)이지만, 모든 환경에서 제대로 표시되도록 25자(영문 기준) 이내로 작성하는 것이 좋습니다(예: '수면 물약').
    • 설명: 상품에 관한 긴 설명이며 최대 200자(영문 기준)까지 사용할 수 있습니다(예: '생물을 즉시 잠들게 함').
    • 아이콘: 고유하고 정확한 상품 이미지입니다. 텍스트, 프로모션 또는 브랜딩을 포함하지 않습니다. 상품 아이콘은 스토어 등록정보와 구매 흐름에서 표시됩니다.
      • 32비트 PNG
      • 512x512픽셀
      • 최대 1MB
    • 가격: 현지 통화로 가격을 입력하거나 가격 템플릿을 선택합니다.
    • 다중 수량: 이 상품의 다중 수량 결제를 허용합니다. 사용자는 거주 중인 국가/지역의 기준액 내에서 여러 수량으로 구매할 수 있습니다. 다음 정보를 참고하세요.
      • Play Console에서 다중 수량 결제를 구성하려면 앱에 Google Play 결제 라이브러리 4.0이 필요합니다. Google Play 결제 라이브러리를 앱에 통합하는 방법을 알아보려면 Android 개발자 사이트를 참고하세요.
      • 일부 국가/지역에서는 다중 수량 결제 기능을 사용할 수 없습니다.
      • 다중 수량 결제를 사용할 수 있는 대부분의 국가/지역에서는 SKU 가격 기준액이 미화 100달러 정도입니다. 다중 수량 결제를 허용하려면 가격(세전)을 각 국가/지역의 기준액 미만으로 조정해야 합니다.
    • Play Points 전용: 상품을 Google Play Points에서만 제공합니다.
  4. 변경사항을 저장하고 활성화를 클릭하여 사용자가 인앱 상품을 사용할 수 있도록 합니다.

언어 및 번역

인앱 상품은 앱과 동일한 언어를 기본값으로 사용합니다. 특정 언어 번역을 추가하려면 인앱 상품을 선택한 다음 번역 관리를 클릭하고 원하는 언어를 적용하세요. 자세한 내용을 확인하려면  앱 번역 및 현지화하기를 참고하세요.

여러 인앱 상품 일괄 만들기

각 상품의 세부정보가 포함된 CSV 파일을 업로드하여 동시에 여러 인앱 상품을 만들 수 있습니다.

CSV 파일은 쉼표(,)와 세미콜론(;)을 사용하여 데이터 값을 구분합니다. 쉼표는 기본 데이터 값을 구분하고, 세미콜론은 하위 값을 구분합니다.

인앱 상품 정보가 포함된 CSV 파일을 만들 때는 첫 번째 행에 CSV 문법을, 다음 행에 상품 세부정보를 작성합니다.

중요: CSV 파일에서 각 상품이 한 줄에 전부 표시되어야 합니다.

인앱 상품 CSV 파일 업로드하기

  1. Play Console을 엽니다.
  2. 인앱 상품 페이지(수익 창출 > 제품 > 인앱 상품)로 이동합니다.
  3. 가져오기를 클릭합니다.
    • CSV 파일을 업로드하여 여러 상품을 가져오면 CSV 파일의 상품 ID 값이 상품 목록에 있는 기존 인앱 상품의 상품 ID와 일치하는 경우에만 기존 상품을 덮어씁니다. 상품을 덮어쓰는 동안 CSV에 포함되지 않는 인앱 상품은 삭제되지 않습니다.
  4. 업로드할 CSV 파일을 드롭하거나 업로드를 클릭합니다.

기존 인앱 상품의 CSV 파일 내보내기

이전에 Play Console에서 인앱 상품을 한 번에 하나씩 만들었다면 CSV 파일 내보내기를 통해 CSV 파일로 인앱 상품을 만들어 보세요.

  1. Play Console을 엽니다.
  2. 인앱 상품 페이지(수익 창출 > 제품 > 인앱 상품)로 이동합니다.
  3. 내보내기를 클릭합니다.

CSV 파일의 예 보기

아래에서 사용 가능한 CSV 구문의 예와 인앱 상품의 세 가지 예를 확인하세요.

  • 첫 번째 예에서는 두 가지 다른 언어(ko_KR, es_ES)로 제목과 설명을 정의합니다. 또한 가격 템플릿을 사용하여 제품 가격을 정의합니다.
  • 두 번째 예에서는 가격 템플릿을 사용하지 않습니다. 대신 기본 국가(KR)에 적용할 가격을 지정합니다. Play Console은 현재 환율 및 현지 사정에 따른 가격 설정 패턴을 사용하여 앱이 배포되는 다른 모든 국가에 적용할 가격을 자동으로 설정합니다.
  • 세 번째 예에서도 가격 템플릿을 사용하지 않습니다. 대신 앱이 배포되는 각 국가에 적용할 제품 가격을 수동으로 지정했습니다.

CSV 구문 예

상품 ID,게시 상태,구매 유형,자동 번역,언어; 제목; 설명,가격 자동 완성,가격,가격 템플릿 ID

인앱 상품의 예

예 1

basic_sleeping_potion,published,managed_by_android,false,ko_KR; 기본 수면 물약; 작은 몹을 즉시 잠들게 함; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

예 2

standard_sleeping_potion, published,managed_by_android,false,ko_KR; 표준 수면 물약; 모든 몹을 2분간 잠들게 함,true, 1990000,

예 3

invisibility_potion,published, managed_by_android,false,ko_KR; 투명인간 물약; 5분간 모든 적에게 보이지 않음,false, KR; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

CSV 파일의 데이터 값 

인앱 상품 CSV 파일의 각 행에 다음 값을 포함할 수 있습니다. 하지만 이 값 중 하나 이상은 각 행에 정의되어 있지 않습니다.  

상품 ID

CSV 파일에 이 값을 설정하면 인앱 상품을 새로 만들 때 상품 ID를 입력하는 것과 같이 됩니다.

상품 목록에 이미 있는 인앱 상품에 할당된 상품 ID를 지정하면 기존 인앱 상품의 데이터를 CSV 파일에 지정된 값으로 덮어씁니다.

게시 상태 이 값은 게시됨 또는 게시되지 않음으로 설정해야 합니다. 이는 인앱 상품을 활성 또는 비활성으로 설정하는 것과 같습니다.
구매 유형

이 값은 managed_by_android로 설정해야 합니다.

자동 번역

인앱 상품 세부정보에는 자동 번역이 지원되지 않으므로 이 값은 false로 설정해야 합니다.

인앱 상품의 제목과 설명의 번역을 제공하려면 언어 값 내에 명시적으로 번역을 지정해야 합니다.

언어, 제목, 설명

제품에 언어를 하나만 포함하는 경우, 다음과 같이 앱의 기본 언어 및 제품의 기본 제목과 설명을 지정해야 합니다.

기본_앱_언어; 상품_기본_제목; 상품_기본_설명;

언어 값을 설정할 때는 스토어 등록정보에 번역 추가 시 표시되는 언어 코드 중 어느 것이든 사용할 수 있습니다.

참고: 제목설명 값을 지정할 때는 백슬래시를 사용하여 세미콜론(\;)과 백슬래시(\\) 문자를 이스케이프 처리하세요.

상품 제목과 설명의 번역 버전을 포함하려면 기본 언어, 제목, 설명을 명시한 다음 번역된 언어, 제목, 설명을 번역 버전마다 나열해야 합니다. 다음 예에서 인앱 상품은 ko_KR(대한민국 한국어)을 기본 언어로 사용하며 es_ES(스페인 스페인어)를 번역으로 사용합니다.

ko_KR; 투명 망토; 투명인간으로 변신하는 망토; es_ES; Capote Invisible; Se vuelven invisible

참고: 앱에는 기본 언어가 1개 포함되지만, 각 인앱 상품에는 자체 번역 목록이 있습니다. 각 상품의 언어 값에서 첫 번째 언어는 CSV 파일 전체에서 동일해야 하지만, 다른 언어 값들은 상품별로 다르게 지정할 수 있습니다.

가격 자동 완성, 국가, 가격

가격 자동 완성은 true 또는 false로 설정할 수 있습니다. 인앱 상품이 가격 템플릿을 사용하는 경우 가격 자동 완성false로 설정해야 하며, 가격 값을 설정하면 안 됩니다.

참고: CSV 파일에서 상품 가격을 지정할 때는 마이크로 단위로 입력해야 합니다. 여기에서 1,000,000마이크로 단위는 실제 통화의 1단위에 해당합니다.

자동으로 입력되는 가격 사용

다음 섹션에서는 가격 자동 완성 값이 국가가격 값의 구문과 의미에 어떤 영향을 미치는지 설명합니다.

가격 자동 완성true로 설정하면 제품의 기본 가격만 지정하세요. 이 경우 국가 값을 포함하면 안 됩니다.

예를 들어 조건이 다음과 같은 경우,

  • 앱의 기본 언어가 ko_KR입니다.
  • 인앱 상품의 기본 세금 미포함 가격은 1.99달러입니다.
  • 다른 국가의 가격은 자동으로 입력되기를 원합니다.

CSV 파일의 행 끝에 가격 자동 완성가격 값을 true,1990000,으로 설정합니다.

국가별 가격 직접 설정  

가격 자동 완성false로 설정하면 앱의 기본 언어에 해당하는 국가를 비롯하여 앱을 배포하는 모든 국가에 일련의 국가가격 값을 지정할 수 있습니다. 각 국가 값은 앱이 배포되는 국가를 나타내는 2자리 대문자 ISO 국가 코드입니다.

참고: 앱이 타겟팅하는 각 국가의 국가 코드와 가격을 지정해야 합니다. 앱이 타겟팅하는 국가의 목록을 보고 수정하려면 프로덕션 페이지의 국가/지역 탭을 사용하세요.

가격 값은 상품의 가격을 해당 국가에서 사용하는 통화의 마이크로 단위로 나타낸 것입니다.

다른 국가에서 다음 가격(모든 세금 포함)으로 앱을 제공하는 경우의 예:

  • 브라질: 6.99헤알 
  • 러시아: 129루블
  • 인도: 130루피
  • 인도네시아: 27,000루피아
  • 멕시코: 37달러

CSV 파일의 행 끝에 가격 자동 완성, 국가, 가격 값을 다음과 같이 설정할 수 있습니다.

false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

가격 템플릿 ID

상품이 가격 템플릿에 연결되어 있다면 가격 자동 완성false로 설정해야 하며, 가격 열에 값을 설정하면 안 됩니다. 상품이 가격 템플릿에 연결되지 않은 경우에는 가격 템플릿 ID 값을 설정하면 안 됩니다. 대신 인앱 상품의 가격을 설정하려는 방식에 따라 가격 자동 완성, 국가, 가격을 설정해야 합니다.

CSV 파일을 가져오면 인앱 상품과 가격 템플릿 간의 연결을 업데이트할 수 있습니다. 상품을 특정 가격 템플릿에 연결하려면 가격 템플릿 ID 값을 연결할 가격 템플릿의 ID로 설정합니다. 모든 가격 템플릿에서 인앱 상품을 연결 해제하려면 가격 템플릿 ID 값을 설정하면 안 됩니다.

특정 가격 템플릿에 최대 1,000개의 앱 가격 또는 인앱 상품 가격을 연결할 수 있습니다. 그러므로 CSV 파일에서 1,000개가 넘는 행에 똑같은 가격 템플릿 ID 값을 지정해서는 안 됩니다.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?