capacitor 앱에 대한 인앱 구매

__CAPGO_KEEP_0__ 앱에 대한 인앱 구매 플러그인이 RevenueCat 공식 저장소로 이전되었습니다. 더 많은 정보를 얻으려면 공식 문서를 참조하세요. RevenueCat 공식 문서 RevenueCat을 사용하지 않고 더 단순한 __CAPGO_KEEP_0__ 네이티브 앱을 선호하시면

RevenueCat을 사용하지 않고 더 단순한 API 네이티브 앱을 선호하시면 @capgo/native-purchases 스토어 키트와 구글 플레이 비リング과 직접적으로 구독 및 구매를 구현합니다.

Capacitor 구매는 Capacitor 프레임워크의 플러그인으로, iOS 및 Android에서 인앱 구매를 지원합니다. 여러 플랫폼에서 일관된 API를 제공하여, 개발자들이 모바일 앱에 구독 및 구매를 구현하는 것을 쉽게 해줍니다.

Capacitor 구매 플러그인의 주요 기능 중 하나는 RevenueCat과 통합하는 것입니다. RevenueCat은 구독 및 인앱 구매를 위한 도구를 제공하는 플랫폼입니다. RevenueCat은 구독 및 인앱 구매를 구현하는 과정을 단순화하고, 여러 플랫폼에서 일관된 API를 제공하며, 수신증명 검증 및 사용자 관리와 같은 작업을 자동화합니다.

RevenueCat을 사용하면 개발자들이 구독을 관리하고, 수입을 추적하고, 관련된 작업을 수행할 수 있습니다. RevenueCat이 제공하는 기능 중 일부는 다음과 같습니다.

• 자동 수신증명 검증
• 사용자 관리
• 커스텀 가격 모델 지원
• 세부적인 분석 -확장성

RevenueCat과 Capacitor 구매 플러그인을 사용하면 개발자들이 모바일 앱에 구독 및 인앱 구매를 구현하는 것을 시간과 노력을 절약할 수 있으며, 사용자 경험을 개선하고 수입을 증가시키기 위한 추가 기능을 제공할 수 있습니다.

Capacitor 구입 플러그인과 RevenueCat을 사용하여 개발자는 쉽게 앱 내 구독 및 구입을 관리하고 추적할 수 있으며, 수표를 검증하고 여러 플랫폼에서 사용자를 관리할 수 있습니다. 또한 사용자 지정 가격 모델을 만들고 성능과 수익을 개선하기 위한 세부 분석을 제공합니다.

설치

최신 버전의 Capacitor과 Capacitor 구입 플러그인을 사용하십시오. 최신 버전의 Capacitor과 Capacitor 구입 플러그인은 Capacitor 웹사이트에서 확인하실 수 있습니다.

Capacitor 구입 플러그인을 설치하려면 다음 명령어를 실행하십시오. npm i @capgo/capacitor-purchases code 앱 내에 플러그인을 추가하십시오. npx cap sync

Xcode에서 앱 내 구입 기능을 추가하십시오.

그 다음

1. RevenueCat 계정 만들기

이 안내서에서는 구독 및 RevenueCat의 SDK을 사용하기 위해 몇 줄의 code만으로 시작하는 방법을 안내합니다.

RevenueCat 계정에 가입하십시오. __CAPGO_KEEP_0__.

📘

💡 여기 팁이 있습니다!

앱 / 프로젝트당 별도의 RevenueCat 계정을 생성하는 것을 추천합니다. 특히 앱을 판매할 계획이 있다면, 계정 전송 프로세스를 빠르게 하기 위해 전체 계정을 전송할 수 있습니다. 개별 프로젝트를 기다리기보다.

기업 / 엔터프라이즈

회사 계정을 등록하고 앱을 프로젝트 내에 설정할 때 RevenueCat을 사용하는 것을 추천합니다. 팀원들을 프로젝트에 초대할 수 있지만, 프로젝트 소유자는만 계정 관리를 할 수 있습니다. 협력자 프로젝트에 초대할 수 있지만, 계정 관리는 프로젝트 소유자만 할 수 있습니다. 2. 프로젝트 및 앱 설정▶️ 프로젝트 만들기

RevenueCat 대시보드에 접속하여

프로젝트를 생성하고

계정 관리를 하세요. 새로운 프로젝트를 추가하세요 상단 네비게이션 메뉴의 드롭다운 목록에서 Projects.

새로운 프로젝트를 만들기 위한 팝업 모달

▶️ 앱/플랫폼 추가

From 프로젝트 설정 > 앱 프로젝트 대시보드의 왼쪽 메뉴에서 앱을 추가할 플랫폼을 선택하세요.

앱 플랫폼을 선택하는 프로젝트 대시보드

필드 앱 이름 RevenueCat에 앱을 추가하려면 앱 이름이 필요합니다. 나머지 구성 필드는 나중에 추가할 수 있습니다. 테스트 및 생산 구매를 위해 Bundle ID (iOS) / Package Name (Android) 및 Shared Secret (iOS) / Service Credentials (Android)가 구성되어야 합니다.

Apple App Store 앱의 앱 구성 페이지

📘

💡 여기 팁이 있습니다!

앱을 등록한 후 RevenueCat은 Platform Server Notifications이 알림은 필요하지 않지만 웹 훅 및 통합 배달 시간을 가속하고

📘

구독자 업데이트 시간을 줄이는 데 도움이 됩니다.

테스트 및 생산 앱 및 사용자

어떤 RevenueCat 앱도 스토어에서 샌드박스 및 프로덕션 구매를 모두 만들 수 있습니다. 만약 스테이징 및 프로덕션에 대한 별도의 앱이 있다면, RevenueCat에 여러 프로젝트를 만들 수 있습니다. 이는 여러분의 설정을 반영합니다.

또한 환경에 따라 사용자를 구분하지 않습니다. 동일한 사용자는 동시에 샌드박스 구매와 프로덕션 구매를 활성화할 수 있습니다.

▶️ 서비스 인증서

RevenueCat는 여러분의 behalf로 앱 스토어와 통신하기 위해 RevenueCat 서비스 인증서를 설정해야 합니다. RevenueCat 가이드를 참조하세요. 애플 스토어 커넥트 공유 비밀, Play 서비스 인증서, 아마존 앱 스토어 공유 비밀 자세한 정보를 위해

참고로 Play 서비스 인증서가 Google 서버에 전파되는데 36시간이 걸릴 수 있습니다.

3. 제품 설정

▶️ 스토어 설정

RevenueCat을 사용하여 제품을 가져올 수 있도록 시작하기 전에, 제품을 각각의 스토어에서 구성해야 합니다. 다음 안내서를 참조하세요. App Store Connect, Google Play Console, Amazon Appstore, 그리고 Stripe 이 과정을 이해하는 데 도움이 필요하신가요.

iOS 제품을 판매하고 계신다면, 'Paid Applications Agreement'에 서명하고 App Store Connect > Agreements, Tax, and Banking에서 은행 및 세금 정보를 입력해야 합니다. 이 과정이 완료되지 않은 경우, 구매 테스트를 시작할 수 없습니다.. 스토어 설정을 테스트하는 동안 건너 뛰고 싶으신가요?.

📘

iOS에서, App Store Connect에서 제품을 구성하는 것을 미루고 StoreKit Configuration 파일을 사용하여 테스트할 수 있습니다. 이 config 파일은 최소한의 설정만 필요하고 Xcode를 통해 직접 조정할 수 있습니다.

Want to skip the store setup while testing?

Read more about setting up StoreKit Configuration files in RevenueCat 테스트 환경에서 테스트 guide.

▶️ RevenueCat에서 제품 및 권한을 구성하세요

이미 앱 내 제품을 App Store Connect, Google Play Console, Amazon Appstore, 또는 Stripe에서 구성한 경우, RevenueCat 대시보드에 해당 구성 정보를 복사해야 합니다. RevenueCat은 Entitlements 시스템을 사용하여 프리미엄 기능에 대한 접근을 제어하고, Offerings를 사용하여 고객에게 제공할 제품의 세트를 관리합니다., 권한은 고객이 특정 제품을 구매한 후 , 권한은 고객이 특정 제품을 구매한 후 RevenueCat은 Entitlements 시스템을 사용하여 프리미엄 기능에 대한 접근을 제어하고, Offerings를 사용하여 고객에게 제공할 제품의 세트를 관리합니다. 권한은 고객이 특정 제품을 구매한 후 권한은 고객이 특정 제품을 구매한 후

RevenueCat은 Entitlements 시스템을 사용하여 프리미엄 기능에 대한 접근을 제어하고, Offerings를 사용하여 고객에게 제공할 제품의 세트를 관리합니다. 이용을 추천합니다. code을 단순화하고 앱 업데이트 없이 제품을 변경할 수 있도록하는 기능을 사용하세요.

See Configuring Products 제품을 설정하고 Offerings 또는 Entitlements로 그룹화하세요.

4. RevenueCat의 Purchases SDK

RevenueCat은 SDK을 사용하여 구매와 구독을 플랫폼 간에 무결성 있게 구현하고 RevenueCat 서버와 토큰을 동기화합니다.

If you run into issues with the SDK, see Troubleshooting the SDKs 참고하세요.

📘

Only use your public SDK key to configure Purchases

공개 SDK 키를 얻으려면 API 키 프로젝트 설정 설정 앱 런칭 시에만 공유 인스턴스를 구성해야 합니다. 앱 내에서 __CAPGO_KEEP_0__ 인스턴스를 접근하여 동일한 인스턴스를 공유합니다.

Purchases RevenueCat의 Configuring __CAPGO_KEEP_0__ .shared instance in the SDK.

설정 Configuring SDK 설정

구성을 확인하세요. 구매 공개 SDK 키만 사용하세요. RevenueCat의 다양한 API 키에 대한 정보는 RevenueCat의 인증 안내.

import { CapacitorPurchases } from '@capgo/capacitor-purchases'
import { isPlatform } from '@ionic/vue' // use the right one for your framework

CapacitorPurchases.setDebugLogsEnabled({ enabled: import.meta.env.DEV }) // Enable to get debug logs in dev mode
if (isPlatform('ios')) {
    CapacitorPurchases.setup({ apiKey:'appl_******'})
} else if (isPlatform('android')) {
    CapacitorPurchases.setup({ apiKey:'goog_******'})
}

개발 중인 경우, RevenueCat은 더 자세한 디버그 로그를 활성화하는 것을 권장합니다. 이러한 로그에 대한 자세한 정보는 RevenueCat의 디버깅 안내서를 참조하세요.

RevenueCat과 함께 기존 구매 code를 사용하려는 경우, RevenueCat의 관찰 모드.

📘

구매자 ID와 함께 구성을 구성하는 방법

앱에 사용자 인증 시스템이 있다면, 구성 시 또는 나중에 사용자 식별자 호출을 통해 사용자 식별자를 제공할 수 있습니다. 자세한 내용은 RevenueCat의 .logIn()안내서를 참조하세요. 사용자 식별.

SDK은 자동으로 Apple, Google, 또는 Amazon에서 구성된 Offerings를 가져와 제품 정보를 가져옵니다. 따라서 고객이 구매 화면을 시작할 때 이미 사용 가능한 제품이 로드되어 있습니다. 구성된 Offerings Apple, Google, 또는 Amazon에서 제품 정보를 가져오기 위해 Offerings를 사용할 수 있습니다.

▶️ 사용 가능한 제품을 가져와 표시 사용자 ID와 함께 구매 구성 사용자 인증 시스템이 있는 앱이 있다면, 구성 시 또는 나중에 호출하는

사용자 식별에 대한 자세한 내용은 RevenueCat의

📘

사용자 식별

Displaying Products .logIn()for more information and best practices. ▶️ Fetch and Display Available Products.

SDK는 자동으로 Apple, Google, 또는 Amazon에서 구성된 Offerings를 가져와 제품 정보를 가져옵니다. 따라서 고객이 구매 화면을 시작할 때 이미 사용 가능한 제품이 로드되어 있습니다. 구성된 Offerings 와 Apple, Google, 또는 Amazon에서 제품 정보를 가져옵니다. 따라서 고객이 구매 화면을 시작할 때 이미 사용 가능한 제품이 로드되어 있습니다.

Offerings를 가져오는 예제입니다. Offerings를 사용하여 결제 벽면 화면을 조직할 수 있습니다. RevenueCat의 Displaying Products에 대한 안내서를 참조하십시오. __CAPGO_KEEP_0__를 가져온 경우 Offerings

const { offerings } = await CapacitorPurchases.getOfferings()
if (offerings.current !== null) {  
    // Display current offering with offerings.current
}

제품 , 또는 사용 가능한, package이 빈칸인 경우, 이는 Apple, Google, 또는 Amazon의 respective store에서 구성 문제로 인한 것입니다. Offerings 를 가져오는 예제입니다. Offerings를 사용하여 결제 벽면 화면을 조직할 수 있습니다. RevenueCat의 Displaying Products에 대한 안내서를 참조하십시오.

App Store Connect에서 가장 일반적인 이유는 '결제 애플리케이션 계약'이 최신 버전이 아니거나 제품이 '제출 준비' 상태 이상이 아닐 때입니다. Google Play에서는 일반적으로 앱이 폐쇄된 트랙에 게시되지 않았거나 유효한 테스트 사용자가 추가되지 않았을 때 발생합니다.

RevenueCat에서 이 문제를 해결하는 방법에 대한 더 많은 정보를 찾을 수 있습니다. 도움말 센터.

▶️ 구매하기

SDK은 구매를 facilite하는 간단한 방법을 포함합니다. SDK은 fetched Offering에서 패키지를 가져와 각각의 앱 스토어에서 거래를 처리합니다. purchase:package __CAPGO_KEEP_0__ 샘플은 'your_entitlement_id' 콘텐츠가 'your_entitlement_id' 콘텐츠를 해제하는지 확인하는 과정의 프로세스를 보여줍니다. 더 자세한 정보는 RevenueCat의 '구매하기'에 대한 설명서를 참조하세요.

The code sample below shows the process of purchasing a package and confirming it unlocks the “your_entitlement_id” content. More details about the purchase:package 이 메서드를 사용하면 앱의 라이프 사이클 동안 반복적으로 호출할 수 있는 최신 상태를 얻을 수 있습니다. 구매하기.

const purchase = async (p: Package): Promise<PurchaserInfo | null> => {
  try {
    // console.log('purchase', p)
    const data = await CapacitorPurchases.purchasePackage({
      identifier: p.identifier,
      offeringIdentifier: p.offeringIdentifier,
    })
    const purchaserInfo = data.purchaserInfo
    // console.log('listenBuy', purchaserInfo)
    if (purchaserInfo.activeSubscriptions.includes(p.identifier)) {
      // set the user as paid
    }
    return purchaserInfo
  }
  catch (e) {
    console.error('listenBuy error', e)
  }
  return null
}

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ 구매하기 자동으로 최신을 캐시합니다. CustomerInfo 업데이트가 될 때마다 — 대부분의 경우 이 메서드는 캐시에서 pulls하고 매우 빠르게 실행됩니다.

일반적으로 사용자에게 보여줄 UI를 결정할 때 또는 사용자가 특정 권한 수준이 필요한 작업을 수행할 때 이 메서드를 호출합니다.

📘

💡 여기 팁입니다!

구독 상태에 대한 정보를 더 많이 액세스할 수 있습니다. 구독 상태에 대한 RevenueCat의 안내서를 참조하세요. 구독 상태 구독이 갱신되도록 설정되었는지, 사용자의 신용카드에 문제가 있는지 등 더 많은 정보를 확인할 수 있습니다.

RevenueCat는 사용자가 이전에 구매한 콘텐츠를 재활용할 수 있도록 사용자의 인앱 구매를 복원할 수 있도록 해줍니다. (Apple, Google, 또는 Amazon 계정). 앱 개발자는 사용자가 복원 메서드를 트리거할 수 있는 방법을 제공하는 것을 권장합니다. Apple은 사용자가 구매에 접근할 수 없게 되면 (예: 앱을 삭제/설치, 계정 정보를 잃어버리면 등) 복원 메커니즘을 요구합니다. 두 개의

  const res = await CapacitorPurchases.restoreTransactions()
  const purchaserInfo = res.purchaserInfo
  const ids: string[] = [] // extract active subscriptions ids
  purchaserInfo.activeSubscriptions.forEach((id) => {
    ids.push(id)
  })

App User ID를 사용할 때 발생하는 문제를 해결하기 위해 사용할 수 있습니다. 이 메서드는 RevenueCat의 구독 상태에 대한 정보를 제공합니다. __CAPGO_KEEP_0__의 구매 정보를 Apple, Google, 또는 Amazon 계정과 같은 underlying store 계정에서 복원할 수 있습니다. RevenueCat은 두 개의 App User ID 사이에 alias를 생성하고 앞으로 그들을 동일한 사용자로 간주할 수 있습니다. RevenueCat의 구매를 복원하는 방법 에 대한 자세한 정보를 참조하십시오.

사용자의 구매 정보가 SDK에서 무방비하게 작동되기 때문에, 사용자의 구매 정보가 변경될 수 있는 다양한 원천에서 변경될 수 있습니다. 고객의 구매 정보가 변경된 경우에 응답하려면 CustomerInfo delegate 메서드를 구현하는 것을 선택적으로 따르십시오. purchases:receivedUpdated:.

이 메서드는 SDK가 RevenueCat API, Google Play, 또는 App Store의 CustomerInfo CustomerInfo getCustomerInfo(), purchase(package:), purchase(product:)객체를 업데이트할 때마다 호출됩니다. restorePurchases().

RevenueCat 백엔드에서 고객 정보를 푸시하지 않기 때문에, 고객 정보를 업데이트하려면 RevenueCat으로의 네트워크 요청을 보내야 합니다. 위의 설명을 참조하십시오. 앱의 경우, delegate를 무시하고 앱이 다시 시작될 때 또는 __CAPGO_KEEP_0__ 메서드의 완료 블록에서 고객 정보가 변경된 경우에만 처리할 수 있습니다. __CAPGO_KEEP_0__의 구매 정보를 Apple, Google, 또는 Amazon 계정과 같은 underlying store 계정에서 복원할 수 있습니다. RevenueCat은 두 개의 App User ID 사이에 alias를 생성하고 앞으로 그들을 동일한 사용자로 간주할 수 있습니다. RevenueCat의

Depending on your app, it may be sufficient to ignore the delegate and simply handle changes to customer information the next time your app is launched or in the completion blocks of the SDK methods.

CapacitorPurchases.addListener('purchasesUpdate', (data) => {
  console.log('purchasesUpdate', data)
})

👍

당신은 성공했습니다!

code 없이 한 달 동안 서버를 작성하지 않고도 완전한 기능의 구독 구매 시스템을 implement했습니다. 축하합니다!

샘플 앱

SDK을 통합하는 더 완전한 예제를 다운로드하려면 RevenueCat 샘플 앱 리소스에 가주세요.

샘플 보기

Capacitor와 Vue.js를 사용하는 샘플 앱을 곧 공개할 예정입니다.

If you need to move deep usage of the Capacitor SDK check the documentation 여기.

다음 단계

\

• RevenueCat의 권한에 대한 안내서를 확인하세요. 자신의 제품이 올바르게 구성되어 있는지 확인하려면 RevenueCat의 권한 안내서를 확인하세요..
• __CAPGO_KEEP_1__ 사용자 식별자를 사용하려면 읽어보세요. 사용자 ID 설정 앱 .
• 다른 시스템에서 RevenueCat으로 이동하는 경우 RevenueCat의 구독이 이미 있는 것을 마이그레이션하는 방법에 대한 안내서를 참조하십시오. 설치가 준비되면 RevenueCat의 통합 테스트 및 디버깅에 대한 안내서를 참조하십시오..
• App Store Small Business Program에 자격이 있는 경우 RevenueCat의 Small Business Program에 대한 안내서를 참조하십시오. RevenueCat에 알리기 위해 RevenueCat의 Small Business Program에 대한 안내서를 참조하십시오..
• 실시간 업데이트 기능이 필요합니다. 👇 여기에서 사용해 보세요.

계정 등록을 위해 여기를 클릭하십시오.

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__에 대한 앱 내 구매 기능을 계속 진행하십시오.

Capgo

capacitor

만약 __CAPGO_KEEP_0__을 사용 중이라면 capacitor 내 앱 구매를 위해 __CAPGO_KEEP_0__에서 지불과 구매를 계획하려면 Capgo 가격 정책과 연결하세요 Capgo 가격 정책에서 제품 워크플로우를 위해 결제 시스템 결제 시스템의 구현 세부 정보를 위해 @capgo/native-purchases @capgo/native-purchases의 구현 세부 정보를 위해 Getting Started Getting Started의 구현 세부 정보를 위해 Revenue Playbook for the implementation detail in Revenue Playbook.