관리되는 제품 만들기

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

• 사용자에게 요금을 반복적으로 청구할 수 있는 구독을 생성할 수도 있습니다.

중요: 관리되는 제품과 구독을 비롯하여 모든 인앱 상품에는 Google Play 개발자 프로그램 정책 및 거래 수수료가 적용됩니다.

사용 조건

판매자 등록이 지원되는 지역에 거주한다면 Google Play 결제를 사용할 수 있습니다.

지원되는 지역에 거주하며 앱에 Google Play 결제 기능을 사용하고자 한다면 결제 프로필을 설정하고 Google Play Billing API 문서를 검토하세요.

관리되는 제품을 만들면 최신 Google Play 스토어 버전을 실행하는 사용자가 이용할 수 있게 됩니다.

필수 권한

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

관리되는 제품 만들기

관리되는 제품 1개 만들기

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

• 제품 ID는 소문자나 숫자로 시작해야 하며, 소문자(a~z), 숫자(0~9), 밑줄(_), 마침표(.)만으로 이루어져야 합니다.
• 참고: android.test라는 제품 ID는 사용할 수 없으며, android.test로 시작하는 모든 제품 ID도 마찬가지입니다.

관리되는 제품을 만들려면 다음 단계를 따르세요.

1. Play Console에 로그인합니다.
2. 앱을 선택합니다.
3. 왼쪽 메뉴에서 앱 정보 > 인앱 상품 > 관리되는 제품을 클릭합니다.
4. 관리되는 제품 만들기를 클릭합니다.
5. 제품 세부정보를 입력합니다.
   • 제목: 짧은 제품 이름입니다. 최대 길이는 55자(영문 기준)이지만, 모든 환경에서 제대로 표시되도록 25자 이내로 작성하는 것이 좋습니다(예: 수면 포션).
   • 설명: 긴 제품 설명이며, 최대 길이는 80자(영문 기준)입니다(예: '몹을 즉시 잠들게 함').
   • 가격: 현지 통화로 가격을 입력하거나 가격 템플릿을 선택합니다.
6. '상태' 옆의 활성 또는 비활성을 선택합니다.
   • 사용자에게 판매하려면 제품이 활성 상태여야 하며 제품이 속한 앱이 게시된 상태여야 합니다.
   • 테스트 계정을 사용 중인 경우 게시되지 않은 앱에서도 활성 제품을 구매할 수 있습니다. 자세한 내용은 Android 개발자 사이트를 참조하세요.
7. 저장을 클릭합니다.

언어 및 번역

관리되는 제품의 기본 언어는 제품이 속한 앱과 같습니다. 특정 언어의 번역을 추가하려면 관리되는 제품을 선택한 다음 번역 추가를 클릭합니다. 앱 번역 자세히 알아보기

관리되는 제품 여러 개의 배치 만들기

각 제품의 세부정보가 포함된 CSV 파일을 업로드하여 관리되는 제품 여러 개를 동시에 만들 수 있습니다.

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

관리되는 제품이 포함된 CSV 파일을 만들 때는 첫 번째 행에 CSV 구문을 지정하고 바로 다음 행에 제품 세부정보를 지정합니다.

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

관리되는 제품의 CSV 파일 업로드

1. Play Console에 로그인합니다.
2. 앱을 선택합니다.
3. 왼쪽 메뉴에서 앱 정보 > 인앱 상품 > 관리되는 제품을 클릭합니다.
4. 가져오기/내보내기 > 관리되는 제품을 CSV 파일에서 가져오기를 클릭합니다.
   • 제품 목록에 있는 기존의 관리되는 제품을 덮어쓰려면 기존 제품 덮어쓰기 체크박스를 선택합니다. 이 옵션을 선택하면 CSV 파일의 제품 ID 값이 제품 목록에 있는 기존 관리되는 제품의 제품 ID와 일치하는 경우에만 기존 제품을 덮어씁니다. 제품을 덮어써도 CSV에 포함되어 있지 않은 관리되는 제품은 삭제되지 않습니다.
5. 파일 찾아보기를 클릭한 다음 CSV 파일을 선택합니다.

기존 관리되는 제품의 CSV 파일 내보내기

Play Console에서 관리되는 제품을 한 번에 하나씩 만들었는데 이제부터 CSV 파일을 사용하여 만들고 싶다면 관리되는 제품을 CSV 파일로 내보내 보세요.

1. Play Console에 로그인합니다.
2. 앱을 선택합니다.
3. 왼쪽 메뉴에서 앱 정보 > 인앱 상품 > 관리되는 제품을 클릭합니다.
4. 가져오기/내보내기 > CSV 파일로 인앱 상품 내보내기를 클릭합니다.

CSV 파일의 예 보기

아래에서 사용할 수 있는 CSV 구문의 예와 관리되는 제품의 세 가지 예를 확인할 수 있습니다.

• 첫 번째 예에서는 두 가지 다른 언어(ko_KR, es_ES)로 제목과 설명을 정의합니다. 또한 가격 템플릿을 사용하여 제품 가격을 정의합니다.
• 두 번째 예에서는 가격 템플릿을 사용하지 않습니다. 대신 기본 국가(미국)에 적용할 가격을 지정합니다. 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, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

CSV 파일의 데이터 값 

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

제품 ID	CSV 파일에 이 값을 설정하면 관리되는 제품을 새로 만들 때 제품 ID를 입력하는 것과 같은 효과가 있습니다. 제품 목록에 이미 포함된 관리되는 제품에 할당된 제품 ID를 지정하고 '인앱 상품 가져오기' 대화상자에서 기존 제품 덮어쓰기 체크박스를 선택한 경우, 기존의 관리되는 제품 데이터를 CSV 파일에 지정된 값으로 덮어쓰게 됩니다.
게시 상태	이 값은 published 또는 unpublished로 설정해야 합니다. 이 설정은 관리되는 제품을 활성 또는 비활성으로 설정하는 것과 같습니다.
구매 유형	이 값은 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로 설정하면 제품의 기본 가격만 지정하세요. 이 경우 국가 값을 포함하면 안 됩니다. 예를 들어 조건이 다음과 같은 경우, 앱의 기본 언어는 en_US입니다. 관리되는 제품의 기본 세금 미포함 가격은 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 값을 지정해서는 안 됩니다.