iOS Auto-Renewable 구독 만들기

GitHub

복사할 수 있는 지시를 사용하여 플러그인 설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

iOS 앱에서 콘텐츠, 서비스 또는 프리미엄 기능에 대한 반복적인 접근을 제공하는 자동 갱신 구독입니다. 이 가이드는 App Store Connect에서 구독을 만들기 위해 안내합니다.

개요

자동 갱신 구독은 사용자가 취소하지 않는 한 각 billing 기간의 끝에서 자동으로 갱신됩니다. 그들은 다음과 같은 것에 이상적입니다:

프리미엄 콘텐츠 및 기능
광고가 없는 경험
클라우드 스토리지 및 동기화
스트리밍 서비스
전문가 도구 및 유틸리티

필수 조건

구독을 만들기 전에 다음을 수행해야 합니다:

구독 그룹을 생성합니다. 구독을 분류하기 위해 구독 그룹을 만듭니다.
활성 Apple Developer Program 회원이여야 합니다.
App Store Connect에서 은행 및 세금 정보를 완료해야 합니다.

구독 만들기

App Store Connect로 이동합니다.

App Store Connect에서 앱을 선택하고 ‘Monetize > Subscriptions’으로 이동하세요. 구독 그룹을 선택하거나 필요할 경우 새로운 그룹을 생성하세요..

구독 그룹을 선택하거나 필요할 경우 새로운 그룹을 생성하세요.
새 구독 만들기

클릭하여 + 구독 그룹 옆의 아이콘을 클릭하여 새로운 구독을 추가하세요.
기본 정보 입력

참조 이름: 고객에게 표시되지 않는 내부 용도로 사용하는 구독의 설명 이름
- 예시: "월간 프리미엄", "년간 최고", "기본 플랜"
상품 ID: 이 구독에 대한 고유 식별자 (이후 변경할 수 없습니다)
- 형식: com.yourcompany.yourapp.premium_monthly
- 형식에 맞추어 설명적인, 소문자 이름을 사용하세요
- native-purchases 플러그인을 구성하기 위해 필수
구독 기간을 설정하세요

구독 기간을 선택하세요:
- 1 주
- 1 달
- 2 달
- 3 달
- 6 달
- 1 년
구독 기간은 사용자가 청구되는 빈도에 영향을 미칩니다.
가격 설정

클릭 구독 가격 추가 가격 구성하기:

기본 영역: 본국을 선택하세요 (일반적으로 국가)

가격: 구독 가격 설정
- 애플은 다른 통화로 자동 변환
- 애플의 가격 계층 중에서 선택
- 가치 인식과 시장 가격을 고려
가족 공유 (선택 사항)

가족 공유를 사용할지 결정하세요. 가족 공유를 사용하면 최대 6명의 가족 구성원이 구독에 접근할 수 있습니다.

가족 공유를 활성화한 후에는 이 제품에 대해 가족 공유를 끌 수 없습니다.

활성화할 경우:
- 가족이 사용할 수 있는 콘텐츠입니다.
- 가족이 사용할 수 있는 가치를 높이고 싶습니다.
- 사업 모델이 가족 공유를 지원합니다.
활성화하지 않을 경우:
- 개인 사용자만을 위한 구독입니다.
- 콘텐츠가 사용자에게 맞춰져 있습니다.
- 사용자당 최대 수익을 원합니다.
국제화 추가

앱이 지원하는 모든 언어에서 구독 표시 정보를 추가하세요:

구독 표시 이름: 고객이 보는 이름 (예: "월간 프리미엄")

설명: 구독이 포함하는 내용의 짧은 설명
- 간결하고 이점을 강조하세요
- 중요한 기능을 언급하세요
- 가치 제안을 강조하세요
앱 스토어 홍보 이미지 (선택사항)

312x390 픽셀 크기의 홍보 이미지를 업로드하세요:
- App Store 구독 페이지에 표시
- 앱의 디자인과 일치해야 합니다.
- 구독 이름을 명확하게 포함
이미지는 초기 제출에 필수는 아니지만, App Store에서 홍보적으로 표시하기 위해서는 필수입니다. 나중에 추가할 수 있습니다.
저장하고 제출

클릭 저장 구독을 생성하세요.

첫 번째 구독:
- 새로운 앱 버전과 함께 제출해야 합니다.
- 다음 앱 스토어 제출에 포함하세요
- 독립적으로 제출할 수 없습니다
후속 구독에 대해:
- 구독 페이지에서 직접 제출할 수 있습니다
- 새로운 앱 버전이 필요하지 않습니다
- 첫 번째 구독이 승인된 후 사용할 수 있습니다

구독 상태

구독 상태는 다음과 같습니다:

상태	설명	테스트할 수 있나요?
Metadata 누락	설정 미완료	Yes (테스트 환경)
제출 준비	제출되지 않은 완료	Yes (테스트 환경)
검토 대기	애플에 제출	Yes (테스트 환경)
애플 검토 중	애플에서 검토 중	Yes (테스트 환경)
승인됨	구매 가능	네
거부됨	수정 필요	네 (샌드박스)

앱에서 사용하기

구독을 생성한 후 앱에서 구독을 참조하려면 다음 product ID를 사용하세요:

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Fetch subscription products direct from StoreKit
const { 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}`);
  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 data
const { 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개월 계약으로 구성되어 있다면, 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',
  });
}

전체 결제 벽과 권한 흐름을 보려면 iOS 월별 계약 청구 플랜.

최선의 방법

가격 전략

월 플랜: 입문 장벽을 낮추고 습관을 형성합니다.
년간 계획: 더 좋은 가치, 높은 LTV, 낮은 churn
다중 티어: 기본, 프리미엄, 최고급 사용자 세그먼트에 대해 다릅니다.
경쟁 분석: 유사한 앱의 가격을 조사합니다.

상품 ID

일관된 이름을 사용하십시오: company.app.tier_duration
티어와 기간을 포함하십시오: premium_monthly, ultimate_annual
상품 ID를 변경하지 마십시오 (영구적입니다).
팀원에게 모든 제품 ID를 문서화하세요

가족 중심 앱(게임, 교육, 엔터테인먼트)용으로 활성화
수입에 미치는 영향 고려
공유 동작을 철저히 테스트
마케팅에서 공유 가능성을 전달

국제화

지역별 가격 차이 고려
지원하는 모든 언어에서 표시 테스트
__CAPGO_KEEP_0__
문화적 적합성에 맞는 마케팅 언어를 사용하세요

홍보 이미지

일관된 시각적 스타일을 유지하세요
구독 이름과 주요 이점을 포함하세요
계절별 프로모션을 위한 업데이트
앱의 전체 디자인 언어와 일치하세요

공통 구독 패턴

단일 티어 (프리미엄)

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

Multi-Tier (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)

문제 해결

제품 ID가 정확히 일치하는지 확인하십시오 (대소문자 구별)

구독이 구독 그룹에 포함되어 있는지 확인하십시오
앱 스토어 연결의 번들 식별자가 정확한지 확인하십시오
확인
2-3 시간 후에 제품을 생성한 후 기다려 주세요.

구독 제출이 불가능합니다:

이름, 설명, 가격 등 모든 필수 항목을 완료하세요.
적어도 한 개의 지역화를 추가하세요.
은행/세금 정보가 승인되었는지 확인하세요.
첫 번째 구독이 (앱 버전이 필요합니다.) 확인하세요.

가족 공유 설정이 비활성화되었습니다:

이미 활성화되어 (비활성화할 수 없습니다.)
구독 세부 사항을 확인하세요.
문제가 발생한 경우 애플 지원팀에 문의하세요.

가격 계층이 사용할 수 없습니다:

일부 지역에서 제한될 수 있습니다.
대체 등급을 선택하세요
애플 가격에 대한 질문에 대해 연락하세요

컨텍스트: 통합 마케팅 섹션. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: 페이지 통합.astro. 메시지 키 `integrations_partners_freelance_contact` (통합 파트너 프리랜서 연락처).

유효하지 않은 제품 ID 오류:
역방식 도메인 형식이어야 합니다
공간 또는 특수 문자를 포함할 수 없습니다
타자 오류를 확인하세요

모든 제품에 대해 고유성을 확인하세요

컨텍스트: Capgo 빌더 / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `native_build_builder_credit_next` (네이티브 빌드 빌더 크레딧 다음). 다음 단계 섹션
새로운 구독자들을 유도하기 위한 소개 요금제를 생성하세요 지원하는 연간 구독 제안에 대해
테스트 환경 설정 구독을 테스트하려면
회원 탈퇴와 유지에 대한 프로모션 제안을 설정
구독 분석 추적을 구현

추가 자료

자세한 내용은 공식 Apple 문서의 자동 갱신 가능 구독에 대해.

Create iOS Auto-Renewable Subscription에서 계속

Capacitor를 사용 중이라면 iOS 자동 갱신 구독 만들기 스토어 승인 및 배포를 계획하고, Using @capgo/native-purchases Using @capgo/native-purchases Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review Using @capgo/capacitor-native-market Using @capgo/capacitor-native-market Using @capgo/capacitor-native-market Using @capgo/capacitor-native-market