Android Auto-Renewable Subscription 만들기

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

자동 갱신 가능한 구독은 앱에서 계속해서 액세스할 수 있는 콘텐츠, 서비스 또는 프리미엄 기능에 대한 액세스를 제공합니다. 이 가이드는 Google Play Console에서 구독을 만들고 구성하는 방법을 도와줍니다.

개요

자동 결제가 각 계정 결제 기간의 끝에 자동으로 갱신됩니다. 사용자가 취소하지 않는 한.

다음과 같은 경우에 적합합니다:
프리미엄 콘텐츠 접근
광고 없는 경험
클라우드 스토리지

지속적인 서비스

구독 만들기

구독으로 이동 Google Play Console에서 앱을 선택하고 Monetize > 구독

왼쪽 메뉴에서 선택하세요. 구독 만들기 시작하기 버튼을 클릭하세요.
기본 정보 입력

구독 이름과 제품 ID를 입력하세요. 제품 ID는 앱에서 구성하기 위해 필수이며 나중에 변경할 수 없습니다.
기본 플랜 만들기

구독을 만들기 위해 Google Play는 정확히 하나의 기본 플랜이 필요합니다. native-purchases 플러그인은 iOS와 호환성을 유지하기 위해 하나의 기본 플랜만 지원합니다.

클릭 기본 플랜 추가 계속하기 위해 클릭하세요.
기본 계획 세부 정보 구성

입력:
- 기본 계획 ID: 이 계획의 고유 식별자
- 청구 기간: 사용자가 청구되는 빈도 (주간, 월간, 연간 등)
- 유예 기간: Google이 결제를 다시 시도하는 동안 구독을 유지하는 시간 창
가격 설정

가격 정보 섹션에 접근하고 가격을 설정할 국가/지역을 모두 선택하세요.
Configure Price

__CAPGO_KEEP_0__을 설정하여 기본 가격을 주력 통화로 설정하세요. Google Play는 이 가격을 지역 통화로 자동 변환합니다.
__CAPGO_KEEP_1__ 지역 가격을 검토하세요. 필요 시 개별 가격을 조정할 수 있습니다.

Review pricing
Save pricing

__CAPGO_KEEP_3__ 구독 활성화
__CAPGO_KEEP_4__을 클릭하여 구독을 활성화하세요.

Activate __CAPGO_KEEP_5__ __CAPGO_KEEP_0__ 버튼을 클릭하여 구독 제품을 활성화하고 구매 가능하게 만듭니다.

중요한 고려 사항

기본 계획 제한

native-purchases 플러그인은 iOS 구독 처리와 일관성을 유지하기 위해 구독당 정확히 하나의 기본 계획이 필요합니다. 여러 개의 기본 계획은 지원되지 않습니다.

유예 기간

유예 기간은 Google Play가 실패한 결제를 다시 시도하면서 사용자의 구독 접근을 유지할 수 있도록 합니다. 일반적인 유예 기간은 다음과 같습니다.

월간 구독의 경우 3일
긴 구독의 경우 7일

구독 상태

구독을 생성한 후 구독 상태는 '초안' 상태로 유지될 것입니다. 초안 구독을 테스트하려면 샌드박스 모드에서 테스트할 수 있습니다.

앱에서 사용

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

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

// Load subscription info
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.premium.monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

const product = products[0];
console.log(`${product.title} — ${product.priceString}`);

// Purchase (planIdentifier = Base Plan ID from Google Play Console)
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan', // REQUIRED on Android, ignored on iOS
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Transaction ID', transaction.transactionId);

// Later, check purchase state
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const subscription = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.example.premium.monthly',
);

if (subscription && subscription.purchaseState === 'PURCHASED' && subscription.isAcknowledged) {
  console.log('Subscription active locally');
  // For expiration/cancellation, validate purchaseToken through your backend
}

다음 단계

새로운 구독자를 유치하기 위한 소개 제안 샌드박스 테스트 환경 구성
새로운 구독자를 유치하기 위한 소개 제안 구독을 테스트하기 위해
보안을 위해 백엔드 수신 확인을 설정하세요

문제 해결

앱에 표시되지 않는 구독:

제품 ID가 정확히 일치하는지 확인하세요
구독이 활성화되었는지 확인하세요
앱이 올바른 패키지 이름을 가지고 있는지 확인하세요
활성화 후 2-3시간 동안 변경이 확산되는 것을 기다려보세요

기본 계획 오류:

기본 계획이 정확히 하나 있는지 확인하세요
필요한 모든 필드가 채워져 있는지 확인하세요
결제 기간이 유효한지 확인하세요

가격 문제:

최소 하나의 국가가 선택되었는지 확인하세요
기본 가격이 허용된 최소 가격보다 큰지 확인하세요
환율 변환률이 적절한지 확인하세요

Create Android Auto-Renewable Subscription에서 계속 진행하세요

Capacitor를 사용하는 경우 Capacitor를 사용하여 스토어 승인 및 배포를 계획하고자 하는 경우 Capacitor를 사용하여 native capability를 사용하는 경우 Using @capgo/native-purchases for the native capability in Using @capgo/native-purchases, @capgo/capacitor-in-app-review for the implementation detail in @capgo/capacitor-in-app-review, Using @capgo/capacitor-in-app-review for the native capability in Using @capgo/capacitor-in-app-review, @capgo/capacitor-native-market for the implementation detail in @capgo/capacitor-native-market, and Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.