인앱 상품 만들기

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

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

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

사용 가능 여부

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

판매자 등록이 지원되는 지역에 거주 중이며 앱에서 Google Play 결제 시스템 기능을 사용하려고 한다면 결제 프로필을 설정하고 Android 개발자 사이트에서 Google Play 결제 시스템 설정 방법을 알아보세요.

사용자에게 판매하려면 인앱 상품이 활성 상태여야 하며 상품이 속한 앱이 사용자의 국가/지역을 대상으로 해야 합니다. 인앱 상품은 앱이 게시 취소된 경우에도 활성 상태인 동안에는 구매할 수 있습니다. 인앱 상품을 사용할 수 없게 하려면 인앱 상품을 비활성화해야 합니다.

테스트 계정을 사용 중인 경우 Android 개발자 사이트에서 Google Play 결제 라이브러리 통합 테스트에 관해 자세히 알아보세요.

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

언어 및 번역

인앱 상품은 앱과 동일한 언어를 기본값으로 사용합니다. 특정 언어 번역을 추가하려면 인앱 상품을 선택한 다음 번역 관리를 클릭하고 원하는 언어를 적용하세요. 사용자에게 현지화된 환경을 제공하는 방법을 자세히 알아보려면 앱 번역 및 현지화를 참고하세요.

여러 인앱 상품 일괄 만들기

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

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

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

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

인앱 상품 CSV 파일 업로드

CSV 파일을 업로드하려면 다음 단계를 따르세요.

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

기존 인앱 상품의 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를 입력하는 것과 같이 됩니다. 상품 목록에 이미 있는 인앱 상품에 할당된 Product ID를 지정하면 기존 인앱 상품의 데이터를 CSV 파일에 지정된 값으로 덮어씁니다.
게시 상태	이 값은 게시됨 또는 게시되지 않음으로 설정해야 합니다. 이는 인앱 상품을 활성 또는 비활성으로 설정하는 것과 같습니다.
구매 유형	이 값은 managed_by_android로 설정해야 합니다.
자동 번역	인앱 상품 세부정보에는 자동 번역이 지원되지 않으므로 이 값은 false로 설정해야 합니다. 인앱 상품의 제목과 설명의 번역을 제공하려면 Locale 값 내에 명시적으로 번역을 지정해야 합니다.
Locale, Title, Description	상품에 언어를 하나만 포함하는 경우, 다음과 같이 앱의 기본 언어 및 상품의 기본 제목과 설명을 지정해야 합니다. 기본_앱_언어; 상품_기본_제목; 상품_기본_설명; 언어 값을 설정할 때는 스토어 등록정보에 번역 추가 시 표시되는 언어 코드 중 어느 것이든 사용할 수 있습니다. 참고: 제목 및 설명 값을 지정할 때는 백슬래시를 사용하여 세미콜론(\;)과 백슬래시(\\) 문자를 이스케이프 처리하세요. 상품 제목과 설명의 번역 버전을 포함하려면 기본 언어, 제목, 설명을 명시한 다음 번역된 언어, 제목, 설명을 번역 버전마다 나열해야 합니다. 다음 예에서 인앱 상품은 ko_KR(대한민국 한국어)을 기본 언어로 사용하며 es_ES(스페인 스페인어)를 번역으로 사용합니다. ko_KR; 투명 망토; 투명인간으로 변신하는 망토; es_ES; Capote Invisible; Se vuelven invisible 참고: 앱에는 기본 언어가 1개 포함되지만, 각 인앱 상품에는 자체 번역 목록이 있습니다. 각 상품의 Locale 값에서 첫 번째 언어는 CSV 파일 전체에서 동일해야 하지만, 다른 언어 값은 상품별로 다르게 지정할 수 있습니다.
Auto-Fill Prices, Country, Price	Auto-fill prices는 true 또는 false로 설정할 수 있습니다. 인앱 상품이 pricing template을 사용하는 경우 Auto-fill prices를 false로 설정해야 하며, Price 값을 설정하면 안 됩니다. 참고: CSV 파일에서 상품 가격을 지정할 때는 마이크로 단위로 입력해야 합니다. 여기에서 1백만 마이크로 단위는 실제 통화의 1단위에 해당합니다. 자동으로 입력되는 가격 사용 다음 섹션에서는 Auto-fill prices 값이 Country와 Price 값의 구문과 의미에 어떤 영향을 미치는지 설명합니다. Auto-fill prices를 true로 설정하면 상품의 기본 가격만 지정하세요. 이 경우 Country 값을 포함하면 안 됩니다. 예를 들어 조건이 다음과 같은 경우, 앱의 기본 언어가 ko_KR입니다. 인앱 상품의 기본 세금 미포함 가격은 1.99달러입니다. 다른 국가의 가격은 자동으로 입력되기를 원합니다. CSV 파일의 행 끝에 Auto-fill prices 및 Price 값을 true,1990000,으로 설정합니다. 국가별 가격 직접 설정 Auto-Fill Prices를 false로 설정하면 앱의 기본 언어에 해당하는 국가를 비롯하여 앱을 배포하는 모든 국가에 일련의 country 및 price 값을 지정할 수 있습니다. 각 country 값은 앱이 배포되는 국가를 나타내는 2자리 대문자 ISO 국가 코드입니다. 참고: 앱이 타겟팅하는 각 국가의 국가 코드와 가격을 지정해야 합니다. 앱이 타겟팅하는 국가의 목록을 보고 수정하려면 프로덕션 페이지의 국가/지역 탭을 사용하세요. 각 price 값은 상품의 가격을 해당 국가에서 사용하는 통화의 마이크로 단위로 나타낸 것입니다. 다른 국가에서 다음 가격(모든 세금 포함)으로 앱을 제공하는 경우의 예: 브라질: 6.99헤알 러시아: 129루블 인도: 130루피 인도네시아: 27,000루피아 멕시코: 37달러 CSV 파일의 행 끝에 Auto-Fill Prices, Country, Price 값을 다음과 같이 설정할 수 있습니다. false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
가격 템플릿 ID	상품이 가격 템플릿에 연결되어 있다면 Auto-Fill prices를 false로 설정해야 하며, price 열에 값을 설정하면 안 됩니다. 상품이 가격 템플릿에 연결되지 않은 경우에는 Pricing template ID 값을 설정하면 안 됩니다. 대신 인앱 상품의 가격을 설정하려는 방식에 따라 Auto-Fill prices, Country, Price을 설정해야 합니다. CSV 파일을 가져오면 인앱 상품과 가격 템플릿 간의 연결을 업데이트할 수 있습니다. 상품을 특정 가격 템플릿에 연결하려면 Pricing Template ID 값을 연결할 가격 템플릿의 ID로 설정합니다. 모든 가격 템플릿에서 인앱 상품을 연결 해제하려면 Pricing template ID 값을 설정하면 안 됩니다. 특정 가격 템플릿에 최대 1,000개의 앱 가격 또는 인앱 상품 가격을 연결할 수 있습니다. 그러므로 CSV 파일에서 1,000개가 넘는 행에 똑같은 Pricing template ID 값을 지정해서는 안 됩니다.
EEA 철회권 유형	유럽 경제 지역(EEA)의 사용자에게 배포하는 경우 여기에서 DIGITAL_CONTENT 또는 SERVICE의 값을 설정해야 합니다.
VAT 감면 세율	다양한 국가/지역에서 디지털 뉴스, 잡지, 신문, 도서, 동영상, 음악, 오디오 또는 오디오북을 판매하는 경우 VAT 감면 세율 대상일 수 있습니다. 감면 세율에 대해서는 이 필드의 값이 다음 형식을 따릅니다. CountryCode; VATRate; 새 국가/세율 쌍을 추가하기 전에 각 국가/세율 쌍에 세미콜론을 붙여야 합니다. 예: CA;BOOKS_1: 캐나다의 도서 등급 1 감면 세율을 설정합니다. FR; NEWS_1; GR; NEWS_2: 프랑스의 뉴스 등급 1 감면 세율과 그리스의 뉴스 등급 2 감면 세율을 설정합니다. 등급은 BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1(대문자 또는 소문자)로 설정할 수 있습니다.
통신세 및 유흥세	관련 주 통신세 및 유흥세를 징수하려면 앱 또는 상품을 스트리밍 상품으로 지정한 다음 이 필드를 ELIGIBLE로 설정하고, 그러지 않으면 필드를 비워 두어야 합니다. 현재 이 유형의 세금은 미국에서만 허용됩니다. 이 필드의 값은 항상 다음과 같이 설정됩니다. CountryCode;Eligibility;Rate 예: US;ELIGIBLE;VIDEO_RENTAL 해당하는 경우 다음 카테고리에 따라 필드를 설정할 수 있습니다. VIDEO_RENTAL: 동영상 스트리밍 - 구독/대여/조회당지불 VIDEO_SALES: 동영상 스트리밍 - 판매 VIDEO_MULTI_CHANNEL: 동영상 스트리밍 - 다중 채널 AUDIO_RENTAL: 오디오 스트리밍 - 구독 또는 대여 AUDIO_SALES: 오디오 스트리밍 - 판매 AUDIO_MULTI_CHANNEL: 오디오 스트리밍 - 다중 채널