Las skills cubren la integración del SDK, la creación de flows y paywalls, las auditorías previas a la publicación, la migración de placements y mucho más. Describe la tarea en lenguaje natural y tu agente elegirá la skill adecuada.
No necesitas mover tus compras a Adapty para usar sus flows. En el modo Observer, tu código sigue gestionando cada compra, mientras Adapty renderiza el paywall o el onboarding, decide quién lo ve, lo somete a pruebas A/B y registra los resultados.
Esta guía explica qué cambia, qué no cambia y qué requiere la configuración.
Tip
¿Nuevo en los flows? El Flow & Paywall Builder explica qué puedes crear antes de conectar todo esto.
Tu facturación no cambia en nada. Adapty renderiza el flow y pasa el toque de compra a tu código, que realiza el cargo.
Crea tus productos en Adapty
Omite esta sección si ninguna pantalla de tu flow muestra un precio o realiza una compra — un flow formado únicamente por pantallas de onboarding no necesita productos en Adapty.
En cuanto una pantalla presente productos, crea un producto en Adapty por cada suscripción o compra única que ofrezca. El flow lee el precio de la tarjeta a partir del producto, de modo que la tarjeta muestra el precio actual de la store, puedes hacer una prueba A/B con ese precio y Adapty agrupa los ingresos por producto en los análisis.
Un producto en Adapty apunta al producto del store que ya tienes a la venta, así que crearlo no activa ningún cobro: tu código sigue gestionando cada cargo. Cada producto tiene asociado un nivel de acceso y, en modo Observer, Adapty no lo concede — tu código sigue controlando el acceso — pero el producto necesita uno.
La CLI de Adapty crea productos sin abrir el dashboard. Instálala (Node.js 18 o posterior) e inicia sesión:
npm install -g adapty
adapty auth login
Obtén el ID de tu app y, a continuación, el nivel de acceso que quieres asociar — cada nueva app empieza con uno llamado premium:
adapty apps list
adapty access-levels list --app <app-id>
Luego crea un producto de Adapty por cada producto que vendas en el store, usando los IDs de producto de App Store Connect y Google Play Console:
Pasa --period lifetime para una compra única, y --stripe-product-id con --stripe-price-id (o el par de Paddle) para algo que vendas en la web. products create lista todos los flags. Los IDs de producto del store no se pueden cambiar tras la creación, así que si necesitas apuntar un producto a un store product diferente, tendrás que crear un producto nuevo.
Warning
Un elemento de producto sin nada asignado bloquea el guardado y la publicación, por lo que lo descubrirás en el constructor. Una acción de Purchase sin producto asignado se guarda correctamente pero falla en el dispositivo: el botón no hace nada. Asigna un producto a cada acción de Purchase.
O salta los productos y escribe los precios como texto estático
Un flow sin elemento de producto se guarda y publica correctamente, así que puedes escribir los precios en el texto y dejar que tu propio código decida qué compra un toque. Lo que te cuesta:
Mantienes el precio en dos sitios: el store y el texto del flow, y en cuanto cambias uno se desincroniza el otro.
Sin pruebas A/B de precio, que es precisamente para lo que sirve un flow.
Los gráficos e integraciones agrupan los ingresos con menos precisión, ya que Adapty solo conoce el producto a partir de la transacción que tú reportas.
Tu código mapea cada elemento pulsado a un producto en vez de recibirlo directamente del flow.
Muestra el flow y realiza la compra en tu propio código. Adapty delega el tap de compra a un handler que tú registras.
Registra la transacción con el ID de variante del paywall del producto comprado, para que la compra llegue a analíticas atribuida al paywall que la generó.
Los pasos 4 y 5 varían según la plataforma. En cada fragmento, flow es el AdaptyFlow que obtuviste para el placement, product es el AdaptyPaywallProduct que el usuario seleccionó, y myPurchaseApi o yourBillingClient representa el código de compra que ya tienes.
Pasa un AdaptyObserverModeResolver a getFlowConfiguration(forFlow:observerModeResolver:). Adapty llama al resolver cuando el usuario pulsa en una compra, en lugar de realizarla él mismo.
final class MyObserverModeResolver: AdaptyObserverModeResolver { func observerMode( didInitiatePurchase product: AdaptyPaywallProduct, onStartPurchase: @MainActor @Sendable @escaping () -> Void, onFinishPurchase: @MainActor @Sendable @escaping () -> Void ) { Task { @MainActor in onStartPurchase() // the flow shows its loading indicator do { // your own purchase code, returning StoreKit's VerificationResult<Transaction> let verificationResult = try await myPurchaseApi.purchase(product.vendorProductId) try await Adapty.reportTransaction(verificationResult, withVariationId: product.variationId) } catch { // handle the error } onFinishPurchase() // the flow hides the loading indicator } } func observerModeDidInitiateRestorePurchases( onStartRestore: @MainActor @Sendable @escaping () -> Void, onFinishRestore: @MainActor @Sendable @escaping () -> Void ) { Task { @MainActor in onStartRestore() try? await myPurchaseApi.restore() onFinishRestore() } }}
Then present the flow with the resolver attached:
do { let flowConfiguration = try await AdaptyUI.getFlowConfiguration( forFlow: flow, observerModeResolver: MyObserverModeResolver() ) let visualFlow = try AdaptyUI.flowController( with: flowConfiguration, delegate: self // an AdaptyFlowControllerDelegate ) present(visualFlow, animated: true)} catch { // handle the error}
Pasa un AdaptyUiObserverModeHandler al crear la vista del flow — el handler es un parámetro de AdaptyUI.getFlowView, AdaptyFlowScreen y AdaptyFlowView. Su onPurchaseInitiated recibe el toque de compra. getRestoreHandler es opcional — omítelo y la restauración permanece con el SDK.
Warning
Pasa siempre el handler. Sin él, el SDK completa la compra por sí mismo — el usuario es cobrado a través de Adapty, y solo un aviso en el log lo indica. En iOS, la misma omisión hace que la compra falle.
Pasa onObserverPurchaseInitiated y onObserverRestoreInitiated como props en AdaptyFlowView, o regístralos con view.setEventHandlers.
function MyFlow({ flow }) { const onObserverPurchaseInitiated = useCallback< FlowEventHandlers['onObserverPurchaseInitiated'] >((product, onStartPurchase, onFinishPurchase) => { onStartPurchase(); // the flow shows its loading indicator myPurchaseApi(product.vendorProductId) .then((transactionId) => adapty.reportTransaction(transactionId, product.variationId)) .finally(() => onFinishPurchase()); // the flow hides the loading indicator }, []); const onObserverRestoreInitiated = useCallback< FlowEventHandlers['onObserverRestoreInitiated'] >((onStartRestore, onFinishRestore) => { onStartRestore(); myRestoreApi().finally(() => onFinishRestore()); }, []); return ( <AdaptyFlowView flow={flow} onObserverPurchaseInitiated={onObserverPurchaseInitiated} onObserverRestoreInitiated={onObserverRestoreInitiated} // ... your other event handlers /> );}
En el componente embebido, el valor que devuelve un handler no cierra el flow — desmonta el componente tú mismo después de una compra o restauración exitosa.
Registra el resolver con AdaptyUI().setObserverModeResolver — en AdaptyUI(), no en Adapty. Implementa tanto observerModeDidInitiatePurchase como observerModeDidInitiateRestore; ambos son obligatorios, y cada uno recibe la vista del flow como primer argumento.
Registra el resolver con Adapty.SetObserverModeResolver — en Adapty, no en AdaptyUI. Implementa IAdaptyUIObserverModeResolver con FlowViewDidInitiatePurchase y FlowViewDidInitiateRestore; los nombres de los callbacks en Unity difieren de los de otras plataformas.
using System;using AdaptySDK;public class MyObserverModeResolver : IAdaptyUIObserverModeResolver{ public void FlowViewDidInitiatePurchase( AdaptyUIFlowView view, AdaptyPaywallProduct product, Action onStartPurchase, Action onFinishPurchase ) { onStartPurchase(); // the flow shows its loading indicator MyPurchaseApi.Purchase(product.VendorProductId, (transactionId, purchaseError) => { if (purchaseError != null) { onFinishPurchase(); return; } Adapty.ReportTransaction(transactionId, product.PaywallVariationId, (reportError) => { onFinishPurchase(); // the flow hides the loading indicator }); }); } public void FlowViewDidInitiateRestore( AdaptyUIFlowView view, Action onStartRestore, Action onFinishRestore ) { onStartRestore(); MyPurchaseApi.Restore((restoreError) => onFinishRestore()); }}
Registra el resolver una vez, antes de presentar cualquier flow:
Registra el resolver con AdaptyUI.setObserverModeResolver. Implementa tanto observerModeDidInitiatePurchase como observerModeDidInitiateRestore; ambos son obligatorios y cada uno recibe la vista del flow como primer argumento.
class MyObserverModeResolver( private val scope: CoroutineScope,) : AdaptyUIObserverModeResolver { override fun observerModeDidInitiatePurchase( view: AdaptyUIFlowView, product: AdaptyPaywallProduct, onStartPurchase: () -> Unit, onFinishPurchase: () -> Unit, ) { onStartPurchase() // the flow shows its loading indicator scope.launch { val transactionId = myPurchaseApi(product.vendorProductId) Adapty.reportTransaction( transactionId = transactionId, variationId = product.paywallVariationId, ).onError { error -> // handle the error } onFinishPurchase() // the flow hides the loading indicator } } override fun observerModeDidInitiateRestore( view: AdaptyUIFlowView, onStartRestore: () -> Unit, onFinishRestore: () -> Unit, ) { onStartRestore() scope.launch { myRestoreApi() onFinishRestore() } }}
Registra el resolver una vez, antes de presentar cualquier flow:
Establece onObserverPurchaseInitiated y onObserverRestoreInitiated con view.setEventHandlers en cada flow view que crees — Capacitor no tiene un objeto resolver separado, y los dos handlers forman parte de los event handlers habituales.
const view = await createFlowView(flow);const unsubscribe = await view.setEventHandlers({ onObserverPurchaseInitiated(product, onStartPurchase, onFinishPurchase) { onStartPurchase(); // the flow shows its loading indicator myPurchaseApi(product.vendorProductId) .then((transactionId) => adapty.reportTransaction({ transactionId, variationId: product.variationId }), ) .finally(() => onFinishPurchase()); // the flow hides the loading indicator return false; // keep the flow open; dismiss it yourself after success }, onObserverRestoreInitiated(onStartRestore, onFinishRestore) { onStartRestore(); myRestoreApi().finally(() => onFinishRestore()); return false; },});
Adapty no concede acceso: No responde a los eventos de compra otorgando ni restringiendo acceso de pago, y no gestiona renovaciones ni reintentos de facturación. Tu propio código es el responsable de los niveles de acceso.
Tu código finaliza sus propias transacciones: Adapty no cierra ni confirma las compras que realiza tu código, así que cerrar cada una sigue siendo tu responsabilidad.
Reportar no es opcional: El variationId que pasas con un reporte es el único vínculo entre una compra y el flow que la generó. Reporta cada transacción, o las métricas de tu flow y los resultados de las pruebas A/B serán incorrectos.
Si ya usas otro proveedor
El modo observador solo requiere que tu código realice la compra, no qué SDK usa ese código. Los flows funcionan igual sobre RevenueCat, Superwall o Qonversion que sobre tu propio código de StoreKit o Billing Library.
Tres decisiones que tomar antes de publicar:
Un sistema finaliza cada transacción: Dos SDKs finalizando la misma compra es el error más habitual aquí.
Un sistema gestiona el acceso: Adapty no otorga nada en el modo Observer, así que mantén los niveles de acceso donde están.
Registra cada compra una sola vez: Registrar la misma transacción desde dos lugares distorsiona tus analíticas.
El modo Observer es la forma más rápida de empezar. Si quieres conservar los análisis de RevenueCat pero evitar las limitaciones del modo Observer, invierte los roles: Adapty funciona en modo completo y gestiona cada compra, mientras RevenueCat opera en su propio modo observer y registra las compras que realiza Adapty.
Adapty sabe entonces qué flow, placement y variante de prueba A/B generó cada cobro, y se encarga de conceder niveles de acceso y gestionar renovaciones, reintentos de facturación y reembolsos.
En el lado de RevenueCat, establece purchasesAreCompletedBy en tu app al configurar su SDK — .myApp en iOS, MY_APP en Android. El artículo Using the SDK with your own IAP code de RevenueCat incluye la configuración para cada plataforma, la versión de StoreKit que requiere iOS y la llamada syncPurchases() que importa las compras que un cliente ya realizó. Asigna el mismo ID de usuario a ambos SDKs — el customer user ID de Adapty y el appUserID de RevenueCat — o los dos dashboards mostrarán datos de personas distintas.
Warning
Este cambio convierte los niveles de acceso de Adapty en tu fuente de verdad, en lugar de los entitlements de RevenueCat. RevenueCat sigue observando y su dashboard sigue generando informes, pero ahora se entera de cada compra de forma indirecta y dentro de los límites que su propia documentación indica. Todo lo que hoy lee los entitlements de RevenueCat — tu app, tu backend, una versión web o de escritorio — debe migrarse a Adapty o leer una copia. Resuélvelo antes de publicar. El resto no cambia: la cuenta de RevenueCat, su historial y sus integraciones se quedan donde están.