자동 갱신 구독 만들기

GitHub

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

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

개요

구독은 각 청구 기간의 끝에서 자동으로 갱신됩니다. 사용자가 취소하지 않는 한, 구독은 다음과 같은 경우에 적합합니다:

프리미엄 콘텐츠 접근
광고가 없는 경험
Cloud storage
정기 서비스

구독 생성

구독으로 이동

Google Play 콘솔에서 앱을 선택하고 왼쪽 메뉴에서 수익화 > 구독 선택합니다.

구독 생성 버튼을 클릭하여 시작합니다. 구독으로 이동 __CAPGO_KEEP_0__
기본 정보 입력

구독 이름과 제품 ID를 입력하세요. 제품 ID는 앱에서 설정할 때 필수이며 나중에 변경할 수 없습니다.
기본 계획 만들기

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

클릭 기본 계획 추가 계속하기
기본 계획 세부 정보 구성

입력하세요:
- 기본 계획 ID: 이 계획의 고유 식별자입니다.
- billing period: 사용자가 청구되는 빈도 (주간, 월간, 연간 등)
- grace period: Google이 결제를 다시 시도하는 동안 구독을 유지하는 시간 창
set up pricing

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

: 기본 가격을 기본 통화로 설정하세요. Google Play는 이 가격을 지역 통화로 자동으로 변환합니다.
국가별 가격 검토

각 국가별로 자동으로 변환된 가격을 검토하세요. 필요 시 개별 가격을 조정할 수 있습니다.
설정 저장

가격 설정을 저장하세요.
구독 활성화

버튼을 클릭하여 구독 상품을 판매 가능 상태로 활성화하세요. 구독 활성화 중요한 고려 사항

__CAPGO_KEEP_1__

기본 계획 제한

Capgo 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를 사용 중이라면 Create Android Auto-Renewable Subscription @__CAPGO_KEEP_0__/native-purchases를 사용하여 @capgo/native-purchases의 네이티브 기능을 사용하여 @capgo/__CAPGO_KEEP_1__-in-app-review를 사용하여 @capgo/capacitor-in-app-review의 구현 세부 정보를 사용하여 @capgo/capacitor-in-app-review를 사용하여 Capacitor를 사용 중이라면 @capgo/capacitor-in-app-review Capgo Native 구매 기능을 위해 @capgo/capacitor-in-app-review를 사용합니다. Capgo Native 마켓 @capgo/capacitor-native-market Capgo Native 마켓 구현 세부사항에 대해 @capgo/capacitor-native-market를 사용하고, Capgo Native 마켓 @capgo/capacitor-native-market를 사용합니다. Capgo Native 구매 기능을 위해 @capgo/capacitor-native-market를 사용합니다.