iOS 자동 갱신 구독 만들기
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
자동 갱신 구독은 iOS 앱에서 콘텐츠, 서비스 또는 프리미엄 기능에 대한 반복 액세스를 제공합니다. 이 가이드에서는 App Store Connect에서 구독을 만드는 방법을 안내합니다.
개요
“개요” 섹션자동 갱신 구독은 사용자가 취소할 때까지 매 결제 주기마다 자동으로 갱신됩니다. 다음과 같은 경우에 적합합니다:
- 프리미엄 콘텐츠 및 기능
- 광고 없는 환경
- 클라우드 저장소 및 동기화
- 스트리밍 서비스
- 전문가용 도구 및 유틸리티
사전 요구사항
“사전 준비 사항” 섹션구독을 만들기 전에 다음을 완료해야 합니다:
- 구독 그룹 생성 구독을 정리하기 위해
- 유효한 Apple Developer Program 멤버십 보유
- App Store Connect에서 은행 및 세금 정보 입력 완료
구독 생성하기
“구독 생성” 섹션-
Subscriptions로 이동
App Store Connect에서 앱을 선택하고 다음으로 이동하세요: 수익화 > 구독.
구독 그룹을 선택하거나 필요 시 새 그룹을 생성하세요.

-
새 구독 만들기
Members 섹션에서 + 구독 그룹 옆 아이콘을 눌러 새 구독을 추가하세요.
-
기본 정보 입력
참조 이름: 내부용 설명 이름 (고객에게는 표시되지 않음)
- 예시: “Premium Monthly”, “Ultimate Annual”, “Basic Plan”
제품 ID: 이 구독의 고유 식별자 (나중에 변경할 수 없음)
- 형식:
com.yourcompany.yourapp.premium_monthly - 의미를 알 수 있는 소문자 이름에 언더스코어(_)를 사용하세요
- native-purchases 플러그인 구성에 필요합니다

-
기간 설정
사용 가능한 옵션에서 구독 기간을 선택하세요:
- 1주일
- 1개월
- 2개월
- 3개월
- 6개월
- 1년
설정한 기간에 따라 사용자 결제 주기가 결정됩니다.
-
가격 설정
클릭 구독 가격 추가 가격을 설정하려면:
기본 지역: 주요 시장을 선택하세요 (보통 본인 국가)
가격: 구독 가격을 설정하세요
- Apple이 다른 통화로 자동 변환합니다
- Apple의 가격 티어 중에서 선택하세요
- 체감 가치와 시장 가격을 고려하세요

-
가족 공유 (선택 사항)
최대 6명의 가족 구성원이 구독을 이용할 수 있는 가족 공유 활성화 여부를 결정하세요.
다음의 경우 활성화하세요:
- 콘텐츠가 가족용으로 적합한 경우
- 가치 제안을 높이고 싶은 경우
- 비즈니스 모델이 이를 지원하는 경우
다음의 경우 활성화하지 마세요:
- 구독이 개인 사용 전용인 경우
- 콘텐츠가 사용자 맞춤형인 경우
- 사용자당 수익을 극대화하려는 경우
-
현지화 추가
앱이 지원하는 모든 언어로 구독 표시 정보를 추가하세요:
구독 표시 이름: 고객에게 표시되는 이름 (예: “Premium Monthly”)
설명: 구독에 포함된 내용에 대한 간단한 설명
- 간결하게, 혜택 중심으로 작성
- 주요 기능 언급
- 가치 제안 강조

-
App Store 프로모션 이미지 (선택)
이 구독용 프로모션 이미지 업로드 (312x390 픽셀):
- App Store 구독 페이지에 표시됩니다
- 앱 디자인과 일치해야 합니다
- 명확성을 위해 구독 이름을 포함하세요
-
저장 및 제출
클릭 저장 구독을 생성하려면
첫 번째 구독의 경우:
- 새 앱 버전과 함께 제출해야 합니다
- 다음 App Store 제출에 포함
- 단독으로 제출할 수 없음
추가 구독 시:
- Subscriptions 페이지에서 바로 제출 가능
- 새로운 앱 버전이 필요 없음
- 첫 번째 구독 승인 후 사용 가능
구독 상태는 다음 중 하나입니다:
| 상태 | 설명 | 테스트 가능 여부 |
|---|---|---|
| 메타데이터 누락 | 설정 미완료 | 예 (sandbox) |
| 제출 준비 완료 | 완료, 미제출 | 예 (sandbox) |
| 심사 대기 중 | Apple에 제출됨 | 예 (sandbox) |
| 심사 중 | Apple에서 심사 중 | 예 (sandbox) |
| 승인됨 | 구매 가능 | 지원 |
| 거부됨 | 수정 필요 | 예 (sandbox) |
앱에서 사용하기
“앱에서 사용하기” 섹션생성 후에는 product ID를 사용해 앱에서 구독을 참조하세요:
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Fetch subscription products direct from StoreKitconst { products } = await NativePurchases.getProducts({ productIdentifiers: [ 'com.yourcompany.yourapp.premium_monthly', 'com.yourcompany.yourapp.premium_annual', ], productType: PURCHASE_TYPE.SUBS,});
products.forEach((product) => { console.log(`${product.title}: ${product.priceString}`); console.log(`Duration: ${product.subscriptionPeriod?.unitString ?? 'unknown'}`); console.log(`Description: ${product.description}`);});
// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)try { const transaction = await NativePurchases.purchaseProduct({ productIdentifier: 'com.yourcompany.yourapp.premium_monthly', productType: PURCHASE_TYPE.SUBS, });
console.log('Transaction ID:', transaction.transactionId);
// StoreKit receipts are included on iOS for server-side validation await sendReceiptToBackend(transaction.receipt);} catch (error) { console.error('Purchase failed:', error);}
// Check subscription status using the store's dataconst { purchases } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.SUBS,});
const premium = purchases.find( (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',);
if (premium?.isActive) { console.log('Expires:', premium.expirationDate); console.log('Will renew:', premium.willCancel === false); console.log('Store state:', premium.subscriptionState); unlockPremiumFeatures();} else { showPaywall();}12개월 약정 월간 결제 플랜
“12개월 약정 월간 플랜” 섹션App Store Connect 구독이 월간 결제 플랜 및 12개월 약정으로 설정된 경우, StoreKit은 해당 제품의 추가 가격 조건을 반환할 수 있습니다. 이 조건을 사용해 구매 전에 월간 요금, 총 약정 금액, 전체 약정 기간을 보여주세요.
const yearlyProduct = products.find( (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',);
const monthlyCommitment = yearlyProduct?.pricingTerms?.find( (term) => term.billingPlanType === 'monthly',);
if (yearlyProduct && monthlyCommitment) { console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice); console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);
await NativePurchases.purchaseProduct({ productIdentifier: yearlyProduct.identifier, productType: PURCHASE_TYPE.SUBS, billingPlanType: 'monthly', });}전체 페이월 및 entitlement 흐름은 다음을 참조하세요: iOS 월간 약정 결제 플랜.
모범 사례
“권장 사항” 섹션가격 전략
“가격 전략” 섹션- 월간 플랜: 진입 장벽이 낮고 습관 형성에 유리함
- 연간 플랜: 더 나은 가치, 더 높은 LTV, 더 낮은 이탈률
- 다양한 티어: 사용자 세그먼트별 Basic, Premium, Ultimate
- 경쟁 분석: 유사 앱의 가격 조사
Product ID
“Product IDs” 섹션- 일관된 네이밍 사용:
company.app.tier_duration - ID에 티어와 기간 포함:
premium_monthly,ultimate_annual - Product ID는 변경하지 마세요 (영구적입니다)
- 팀을 위해 모든 제품 ID를 문서화하세요
가족 공유
“Family Sharing” 섹션- 가족 대상 앱(게임, 교육, 엔터테인먼트)에 활성화
- 수익에 미치는 영향 고려
- 공유 동작을 철저히 테스트
- 마케팅에서 공유 기능을 안내
- 구독 이름과 설명 전체 번역
- 지역별 가격 차이 고려
- 지원 언어별 표시 테스트
- 문화에 맞는 마케팅 문구 사용
프로모션 이미지
“프로모션 이미지” 섹션- 일관된 비주얼 스타일 유지
- 구독 이름과 핵심 혜택 포함
- 시즌별 프로모션에 맞게 업데이트
- 앱 전체 디자인 언어와 일치
자주 쓰는 구독 패턴
“일반적인 구독 패턴” 섹션단일 티어 (Freemium)
“단일 티어(부분 유료화)” 섹션Free App + Premium Subscription- Basic: Free (limited features)- Premium Monthly: $4.99- Premium Annual: $39.99 (save 33%)멀티 티어 (Good, Better, Best)
“멀티 티어 (Good, Better, Best)” 섹션- Basic Monthly: $4.99- Premium Monthly: $9.99- Ultimate Monthly: $19.99
- Basic Annual: $49.99- Premium Annual: $99.99- Ultimate Annual: $199.99소모품 + 구독 하이브리드
“소모품 + 구독 하이브리드” 섹션- Credit packs (consumable)- Monthly subscription (unlimited credits)- Annual subscription (unlimited + bonus features)문제 해결
“문제 해결” 섹션앱에서 구독이 로드되지 않는 경우:
- Product ID가 정확히 일치하는지 확인 (대소문자 구분)
- 구독이 구독 그룹에 포함되어 있는지 확인
- Bundle identifier가 App Store Connect와 일치하는지 확인
- 상품 생성 후 2~3시간 대기
구독을 제출할 수 없는 경우:
- 필수 필드 모두 입력 (이름, 설명, 가격)
- 현지화를 하나 이상 추가
- 은행/세금 정보 승인 여부 확인
- 첫 구독인지 확인 (앱 버전 필요)
Family Sharing 토글 비활성화됨:
- 이미 활성화됨 (비활성화 불가)
- 구독 상세 정보에서 확인
- 문제가 지속되면 Apple 지원팀에 문의
가격 티어를 사용할 수 없음:
- 일부 지역에서는 제한될 수 있음
- 다른 티어 선택
- 가격 관련 문의는 Apple에 연락하세요
“Invalid Product ID” 오류:
- 리버스 도메인 형식이어야 합니다
- 공백이나 특수 문자를 포함할 수 없습니다
- 오타를 확인하세요
- 모든 제품에서 고유한지 확인하세요
다음 단계
“다음 단계” 섹션- 소개 오퍼 만들기 신규 구독자 유치
- 월간 약정 결제 플랜을 판매하세요 지원되는 연간 구독 오퍼에 대해
- 샌드박스 테스트 설정 구독을 테스트하려면
- 리텐션 및 재유입을 위한 프로모션 오퍼 설정
- 구독 분석 트래킹 구현
추가 리소스
“추가 리소스” 섹션자세한 내용은 자동 갱신 구독에 대한 Apple 공식 문서.
iOS 자동 갱신 구독 생성부터 계속하기
“iOS 자동 갱신 구독 만들기”에서 계속하기사용 중이라면 iOS 자동 갱신 구독 만들기 스토어 승인 및 배포를 계획하려면, 다음 항목과 연결하세요 @capgo/native-purchases 사용하기 @capgo/native-purchases 사용 시 네이티브 기능을 위해, @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review의 구현 세부 사항에 대해서는, @capgo/capacitor-in-app-review 사용하기 @capgo/capacitor-in-app-review 사용하기에서 네이티브 기능은, @capgo/capacitor-native-market @capgo/capacitor-native-market의 구현 세부 사항에 대해서는, 그리고 @capgo/capacitor-native-market 사용하기 @capgo/capacitor-native-market. 사용하기에서 네이티브 기능은