Este plugin ahora se ha transferido a la repositorio oficial de RevenueCat. Por favor, consulte la documentación oficial para obtener más información.
Capacitor Purchases is a plugin for the Capacitor framework that allows in-app purchases on iOS and Android. It provides a simple and consistent API across multiple platforms, making it easy for developers to implement in-app subscriptions and purchases in their mobile apps.
One of the key features of the Capacitor Purchases plugin is that it integrates with RevenueCat, a platform that provides tools for in-app subscriptions and in-app purchases. RevenueCat simplifies the process of implementing in-app subscriptions and purchases by providing a simple and consistent API across multiple platforms, and automating tasks such as receipt validation and user management.
en múltiples plataformas, lo que facilita a los desarrolladores implementar suscripciones y compras en aplicaciones móviles.
- Una de las características clave del plugin de compras de __CAPGO_KEEP_0__ es que se integra con RevenueCat, una plataforma que proporciona herramientas para suscripciones y compras en la aplicación. RevenueCat simplifica el proceso de implementar suscripciones y compras en la aplicación proporcionando una interfaz de programación de aplicaciones sencilla y consistente
- across multiple platforms
- en múltiples plataformas, y automatizando tareas como la validación de recibos y el manejo de usuarios. Con RevenueCat, los desarrolladores pueden gestionar fácilmente suscripciones, rastrear ingresos y realizar otras tareas relacionadas. Algunas características ofrecidas por RevenueCat incluyen: Automatización de la validación de recibos Manejo de usuarios Soporte para modelos de precios personalizados
- Detalles de análisis -Escalabilidad
Al utilizar el plugin de compras Capacitor con RevenueCat, los desarrolladores pueden ahorrar tiempo y esfuerzo al implementar suscripciones y compras en aplicaciones móviles, y proporcionar características adicionales que pueden ayudar a mejorar la experiencia del usuario y aumentar los ingresos.
Usando el plugin de compras Capacitor y RevenueCat, los desarrolladores pueden gestionar y rastrear fácilmente suscripciones y compras en aplicaciones móviles, validar recibos y gestionar usuarios en múltiples plataformas. También permite crear modelos de precios personalizados y obtener detalles de análisis para mejorar el rendimiento y los ingresos.
Instalación
Asegúrese de utilizar la versión más reciente de Capacitor y el plugin de compras Capacitor. Puede verificar la versión más reciente de Capacitor y el plugin de compras Capacitor en el sitio web de Capacitor.
Para instalar el plugin de compras Capacitor, ejecute el siguiente comando:
npm i @capgo/capacitor-purchases
agregue el plugin nativo code a su aplicación
npx cap sync
agregue la capacidad de compras en aplicaciones móviles en Xcode:
luego
1. Cree una cuenta de RevenueCat
This guide will walk you through how to get up and running with subscriptions and RevenueCat’s SDK with only a few lines of code.
Regístrate para una nueva cuenta de RevenueCat aquí.
📘
💡 ¡Aquí tienes un consejo!
RevenueCat recomienda crear una cuenta de RevenueCat separada para cada aplicación / proyecto que tengas, especialmente si alguna vez planeas vender la aplicación. Esto acelerará el proceso de transferencia, ya que puedes transferir la cuenta completa en lugar de esperar a que el soporte de RevenueCat transfiera proyectos individuales.
Organizaciones / Empresa
Recomendamos utilizar una cuenta de la empresa al registrarse en RevenueCat y configurar la aplicación dentro de un proyecto. Puedes invitar al resto de tu equipo como colaboradores a tu proyecto, pero solamente el propietario del proyecto puede gestionar la facturación.Los colaboradores del proyecto no pueden gestionar los detalles de facturación.
2. Configuración del proyecto y la aplicación
▶️ Crear un Proyecto
Navegue hasta la consola de RevenueCat y agregue un nuevo proyecto desde el menú desplegable en la parte superior de la navegación llamado Proyectos.
El modal de diálogo para crear un nuevo Proyecto
▶️ Agregar una Aplicación / Plataforma
Desde Configuración de Proyecto > Aplicaciones en el menú izquierdo de la consola de proyecto, seleccione la plataforma para la aplicación que estará agregando.
Panel de proyecto para seleccionar la plataforma de la aplicación
__CAPGO_KEEP_0__ Nombre de la aplicación es necesario para agregar su aplicación a RevenueCat. Los demás campos de configuración pueden agregarse más tarde. Para realizar compras de prueba y producción, deben configurarse el ID de paquete (iOS) / Nombre de paquete (Android) así como la Clave compartida (iOS) / Credenciales de servicio (Android).
Página de configuración de la aplicación para una aplicación de App Store de Apple
📘
💡 ¡Aquí tienes un consejo!
Después de registrar su aplicación, RevenueCat recomienda configurar Notificaciones del servidor de plataforma. Estas notificaciones no son obligatorias, pero acelerarán webhooks y reducirán el tiempo de entrega de la integración y el tiempo de actualización de sus suscriptores.
📘
Aplicaciones de pruebas vs. de producción y usuarios
RevenueCat no tiene entornos separados para pruebas y producción. En su lugar, las transacciones subyacentes para los usuarios se diferencian por sandbox y producción.
Cualquier aplicación de RevenueCat puede realizar compras tanto de sandbox como de producción desde las tiendas. Si tienes aplicaciones separadas para pruebas y producción, puedes crear varios proyectos en RevenueCat para reflejar tu configuración.
Además, los usuarios no se separan por entorno, ya que el mismo usuario puede tener compras activas de sandbox y compras activas de producción al mismo tiempo.
▶️ Credenciales de Servicio
Las credenciales de servicio deben configurarse para que RevenueCat pueda comunicarse con las tiendas de aplicaciones en tu nombre. Consulta las guías de RevenueCat Secreta compartida de App Store Connect, Credenciales de Servicio de Playy Secreta compartida de Amazon Appstore para obtener más información.
Tenga en cuenta que las credenciales de servicio de Play pueden tardar hasta 36 horas en propagarse a través de los servidores de Google.
3. Configuración de Productos
▶️ Configuración de Tienda
Antes de que puedas empezar a utilizar RevenueCat para obtener productos, debes configurar tus productos en las tiendas respectivas. Consulta los siguientes guías para App Store Connect, Google Play Console, Amazon Appstore, y Stripe para obtener ayuda para navegar por este proceso.
Si estás vendiendo productos de iOS, asegúrate de firmar tu ‘Acuerdo de Aplicaciones Pagadas’ y rellena tu información bancaria y fiscal en App Store Connect > Acuerdos, Impuestos y Bancos. Esto debe completarse antes de que puedas probar cualquier compra.
📘
¿Quieres saltarte la configuración de la tienda mientras pruebas?
En iOS, puedes retrasar la configuración de los productos en App Store Connect probando con archivos de configuración de StoreKit en lugar de eso. Estos archivos de configuración requieren una configuración mínima y se pueden configurar directamente a través de Xcode.
Lee más sobre la configuración de archivos de configuración de StoreKit en RevenueCat Pruebas de Entorno de Desarrollo guía.
▶️ Configura productos y permisos en RevenueCat
Una vez que tus productos en la aplicación hayan sido configurados en App Store Connect, Google Play Console, Amazon Appstoreo StripeDeberás copiar esa configuración en la consola de RevenueCat. RevenueCat utiliza un sistema de Entidades para controlar el acceso a características premium y Ofertas para gestionar el conjunto de productos que ofreces a los clientes.
Las Entidades son el nivel de acceso que un cliente está "autorizado" a tener después de comprar un producto específico. Las Ofertas son una forma sencilla de organizar los productos en pago que deseas "ofrecer" en tu paywall y configurarlos remotamente. RevenueCat recomienda utilizar estas características para simplificar tu code y permitirte cambiar productos sin tener que actualizar la aplicación.
Ver Configuración de productos para configurar tus productos y luego organizarlos en Ofertas o Entidades.
4. Utilizando la función de compras de RevenueCat SDK
RevenueCat SDK implementa de manera transparente las compras y suscripciones en varias plataformas mientras sincroniza los tokens con el servidor de RevenueCat.
Si tienes problemas con el SDK, ve a Solucionar problemas de los SDKs para obtener orientación.
📘
Solo utilice su clave pública SDK para configurar Compras
Puede obtener su clave pública SDK desde la API claves pestaña bajo Configuración del proyecto en la consola.
Debería configurar solo la instancia compartida de Compras una vez, generalmente en el lanzamiento de la aplicación. Posteriormente, la misma instancia se comparte a lo largo de su aplicación accediendo a la .shared instancia en el SDK.
Consulte la guía de RevenueCat sobre Configurando SDK para obtener más información y mejores prácticas.
Asegúrese de configurar Compras con su clave pública SDK solo. Puede leer más sobre las diferentes claves API disponibles en RevenueCat Guía de autenticación.
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_******'})
}Cuando se encuentra en desarrollo, RevenueCat recomienda habilitar registros de depuración más verbosos. Para obtener más información sobre estos registros, consulte su Guía de depuración Si planea utilizar RevenueCat junto con su compra existente __CAPGO_KEEP_0__, consulte su guía sobre
If you’re planning to use RevenueCat alongside your existing purchase code, refer to their guide on Configurando Compras con IDs de usuario.
📘
__CAPGO_KEEP_0__
Si tienes un sistema de autenticación de usuarios en tu aplicación, puedes proporcionar un identificador de usuario en el momento de la configuración o en una fecha posterior con una llamada a
.logIn(). Para obtener más información, consulta la guía de RevenueCat sobre Identificar a los usuarios.
El SDK recuperará automáticamente los Configuraciones de Oferta y recuperará la información del producto de Apple, Google o Amazon. Por lo tanto, los productos disponibles ya estarán cargados cuando los clientes lancen tu pantalla de compra.
A continuación, se muestra un ejemplo de recuperación de Ofertas. Puedes utilizar Ofertas para organizar tu pantalla de pago. Consulta la guía de RevenueCat sobre Mostrar productos para obtener más información y mejores prácticas.
▶️ Recuperar y mostrar productos disponibles
📘
Configurando compras con identificadores de usuario
Si tienes un sistema de autenticación de usuarios en tu aplicación, puedes proporcionar un identificador de usuario en el momento de la configuración o en una fecha posterior con una llamada a
.logIn(). Para obtener más información, consulte la guía de RevenueCat sobre Identificar a los usuarios.
El SDK recuperará automáticamente los Ofertas configuradas y recuperará la información del producto de Apple, Google o Amazon. Por lo tanto, los productos disponibles ya estarán cargados cuando los clientes lancen su pantalla de compra.
A continuación, se muestra un ejemplo de recuperación de Ofertas. Puede utilizar Ofertas para organizar su pantalla de pago. Consulte la guía de RevenueCat sobre Mostrar productos para obtener más información y mejores prácticas.
const { offerings } = await CapacitorPurchases.getOfferings()
if (offerings.current !== null) {
// Display current offering with offerings.current
}Si está recuperando sus Ofertas, productos, o disponibles paquetes son vacíos, se debe a algún problema de configuración en la tienda correspondiente.
Las razones más comunes para esto en App Store Connect son un 'Acuerdo de Aplicaciones Pagadas' desactualizado o productos que no están al menos en el estado 'Listo para Entregar'. En Google Play, esto suele ocurrir cuando la aplicación no está publicada en un track cerrado y se ha agregado un usuario de prueba válido.
Puede encontrar más información sobre la solución de problemas de este problema en RevenueCat Centro de Ayuda.
▶️ Realizar una Compra
El SDK incluye un método simple para facilitar las compras. El purchase:package recibe un paquete desde la oferta recuperada y procesa la transacción con la tienda de aplicaciones correspondiente.
El code de muestra a continuación muestra el proceso de compra de un paquete y la confirmación de que desbloquea el contenido 'your_entitlement_id'. Más detalles sobre el purchase:package método se pueden encontrar en la guía de RevenueCat sobre Hacer Compras.
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
}▶️ Verificar el Estado de la Suscripción
Puede utilizar este método cada vez que necesite obtener el estado más reciente, y es seguro llamar a este método repetidamente a lo largo de la vida ciclo de su aplicación. Compras automáticamente almacena en caché el estado más reciente CustomerInfo cada vez que se actualiza — por lo tanto, en la mayoría de los casos, este método extrae de la caché y ejecuta muy rápido.
Es típico llamar a este método cuando se decide qué interfaz mostrar al usuario, y cada vez que el usuario realiza una acción que requiere un nivel de permiso determinado.
📘
💡 Aquí tienes un consejo!
Puede acceder a mucha más información sobre una suscripción que simplemente si está activa o no. Consulte la guía de RevenueCat sobre Estado de Suscripción para aprender si la suscripción está configurada para renovarse, si hay un problema detectado con la tarjeta de crédito del usuario y más.
RevenueCat permite a sus usuarios restaurar sus compras en la aplicación, reactivando cualquier contenido que hayan comprado anteriormente desde la misma cuenta de tienda (cuenta de Apple, Google o Amazon). Recomendamos que todas las aplicaciones tengan alguna forma para que los usuarios puedan desencadenar el método de restauración. Tenga en cuenta que Apple requiere un mecanismo de restauración en caso de que un usuario pierda acceso a sus compras (por ejemplo: desinstalando/reinstalando la aplicación, perdiendo la información de cuenta, etc).
const res = await CapacitorPurchases.restoreTransactions()
const purchaserInfo = res.purchaserInfo
const ids: string[] = [] // extract active subscriptions ids
purchaserInfo.activeSubscriptions.forEach((id) => {
ids.push(id)
})
Si dos identificadores de usuario de la aplicación son diferentes Identificadores de usuario de la aplicación restaurar transacciones desde la misma cuenta de almacenamiento subyacente (cuenta de Apple, Google o Amazon). RevenueCat puede intentar crear un alias entre los dos identificadores de usuario de la aplicación y contarlos como el mismo usuario a partir de ese momento. Consulte la guía de RevenueCat sobre Restaurar compras
Since the SDK works seamlessly on any platform, changes to a user’s purchase info may come from a variety of sources. You can respond to any changes in a customer’s CustomerInfo Dado que purchases:receivedUpdated:.
This method will fire whenever the SDK receives an updated CustomerInfo conformándose a un método de delegado opcional, getCustomerInfo(), purchase(package:), purchase(product:)Este método se disparará cada vez que restorePurchases().
reciba una actualización de un objeto las actualizaciones de información de cliente no pushed a la tu aplicación desde el backend de RevenueCat, las actualizaciones solo pueden ocurrir desde una solicitud de red saliente a RevenueCat, como se mencionó anteriormente.
Según tu aplicación, puede ser suficiente ignorar al delegado y manejar cambios a la información del cliente la próxima vez que tu aplicación se inicie o en los bloques de finalización de los métodos SDK.
CapacitorPurchases.addListener('purchasesUpdate', (data) => {
console.log('purchasesUpdate', data)
})👍
¡Lo hiciste!
Has implementado ahora un sistema de compra de suscripciones completo sin gastar un mes escribiendo servidores code. ¡Felicidades!
Aplicaciones de muestra
Para descargar ejemplos más completos de la integración de SDK, dirígete a los recursos de aplicaciones de muestra de RevenueCat.
Pronto publicaré una aplicación de muestra utilizando Capacitor y Vue.js.
Si necesitas mover un uso profundo de la Capacitor SDK revisa la documentación aquí.
Pasos siguientes
\
- Si no lo has hecho ya, asegúrate de que tus productos estén configurados correctamente revisando RevenueCat guía sobre derechos de autor.
- Si desea utilizar sus propios identificadores de usuario, lea sobre configuración de IDs de usuario de la aplicación .
- Si está cambiando a RevenueCat desde otro sistema, consulte la guía de RevenueCat sobre migrar sus suscripciones existentes.
- Una vez que esté listo para probar su integración, puede seguir las guías de RevenueCat sobre pruebas y depuración.
- Si califica para el Programa de Pequeñas Empresas de la Tienda de Mac, consulte la guía de RevenueCat sobre cómo solicitar y informar a RevenueCat
Si necesita actualizaciones en vivo en su aplicación
Únete aquí 👇
