Migración desde RevenueCat

Tu plan de migración tiene 5 pasos lógicos y dura una media de 2 horas. El 90 % de todas las migraciones se completan en menos de un día laborable.

Aprende las diferencias clave y crea y prepara una cuenta de Adapty (5 minutos);
Instala el SDK de Adapty para tu plataforma (iOS, Android, React Native, Flutter, Kotlin Multiplatform, Unity) en lugar del SDK de RevenueCat (1 hora);
Configura las notificaciones de servidor de Apple App Store para Adapty y (opcionalmente) el reenvío de eventos sin procesar (5 minutos);
Prueba y publica la actualización de tu app (30 minutos);
(Opcional) Solicita al soporte de RevenueCat los datos históricos en formato CSV (5 minutos);
(Opcional) Importa los datos históricos a través del soporte de Adapty (30 minutos).

Tus suscriptores migrarán automáticamente

Todos los usuarios que alguna vez hayan activado una suscripción pasarán a Adapty automáticamente en cuanto abran la nueva versión de tu app con el SDK de Adapty. La validación del estado de la suscripción y el acceso premium se restaurarán de forma automática.

Antes de publicar una nueva versión de tu app con el SDK de Adapty, asegúrate de revisar nuestra lista de verificación para el lanzamiento.

Aprende las diferencias clave y crea y prepara una cuenta de Adapty

Los SDKs de Adapty y RevenueCat tienen un diseño similar. La mayor diferencia está en el uso de red y la velocidad: el SDK de Adapty está diseñado para proporcionarte información lo más rápido posible cuando la solicitas. Por ejemplo, al pedir un paywall, primero recibes el Remote Config para precomponer tu onboarding o paywall, y luego solicitas los productos en una petición separada.

Los nombres son ligeramente distintos:

RevenueCat	Adapty
Package	Product
Offering	Paywall
Paywall	Paywall Builder
Entitlement	Access level

Adapty tiene el concepto de placement. Es un lugar lógico dentro de tu app donde el usuario puede realizar una compra. En la mayoría de los casos, tendrás uno o dos placements:

Onboarding (ya que el 80 % de todas las compras se realizan ahí);
General (se muestra en los ajustes o dentro de la app después del onboarding).

Instala el SDK de Adapty y reemplaza el SDK de RevenueCat

Instala el SDK de Adapty para tu plataforma (iOS, Android, React Native, Flutter, Kotlin Multiplatform, Unity) en tu app.

Necesitas reemplazar algunos métodos del SDK en el lado de la app. Veamos las funciones más comunes y cómo sustituirlas por las del SDK de Adapty.

Activación del SDK

Reemplaza Purchases.configure con Adapty.activate.

Obtener paywalls (offerings)

Reemplaza Purchases.shared.getOfferings con Adapty.getPaywall.

En Adapty, siempre solicitas el paywall mediante el placement id. En la práctica, solo obtienes 1 o 2 paywalls como máximo, así que lo hemos diseñado así a propósito para acelerar el SDK y reducir el uso de red.

Obtener un usuario (perfil del cliente)

Reemplaza Purchases.shared.getCustomerInfo con Adapty.getProfile.

Obtener productos

En RevenueCat, usas la siguiente estructura: Purchases.shared.getOfferings y luego self.offering?.availablePackages.

En Adapty, primero solicitas un paywall (ver arriba) para acceder de inmediato al Remote Config de Adapty, y luego obtienes los productos con Adapty.getPaywallProducts.

Realizar una compra

Reemplaza Purchases.shared.purchase con Adapty.makePurchase.

Verificar el nivel de acceso (entitlement)

Obtén el perfil del cliente (lee el apartado anterior primero) y luego reemplaza

customerInfo?.entitlements["premium"]?.isActive == true

con

profile.accessLevels["premium"]?.isActive == true.

Restaurar una compra

Reemplaza Purchases.shared.restorePurchases con Adapty.restorePurchases.

Comprobar si el usuario ha iniciado sesión

Reemplaza Purchases.shared.isAnonymous con if profile.customerUserId == nil.

Iniciar sesión con un usuario

Reemplaza Purchases.shared.logIn con Adapty.identify.

Cerrar sesión de un usuario

Reemplaza Purchases.shared.logOut con Adapty.logout.

Cambia las notificaciones del servidor de App Store a Adapty

Lee cómo hacerlo aquí.

Prueba y publica una nueva versión de tu app

Si estás leyendo esto, ya has:

Configurado el Adapty Dashboard
Instalado el SDK de Adapty
Reemplazado la lógica del SDK con las funciones de Adapty
Cambiado las notificaciones del servidor de App Store a Adapty y, opcionalmente, activado el reenvío de eventos sin procesar a RevenueCat
Realizado una compra en sandbox
Publicado una nueva versión de la app

Si has marcado los puntos anteriores, haz una compra de prueba en el Sandbox y luego publica la app.

Repasa la lista de verificación para el lanzamiento.

Haz la revisión final con nuestra lista para validar la integración existente o añadir funciones adicionales como integraciones de atribución o análisis.

(Opcional) Exporta tus datos históricos de RevenueCat en formato CSV

No te precipites con la importación de datos históricos

Deberías esperar al menos una semana después de publicar la versión con el SDK antes de importar los datos históricos. Durante ese tiempo recopilaremos toda la información sobre los precios de compra desde el SDK, por lo que los datos que importes serán más relevantes.

Exporta tus datos históricos de RevenueCat en formato CSV siguiendo las instrucciones de la documentación oficial de RevenueCat.

(Opcional) Solicita al soporte de RevenueCat los tokens de compra de Google

Si necesitas importar transacciones de Google Play, contacta con el soporte de RevenueCat para obtener un archivo CSV con los Google Purchase Tokens a través de su página de soporte. El Google Purchase Token es un identificador único que proporciona Google Play para cada transacción, imprescindible para rastrear y verificar las compras con precisión en Adapty. Esta información no se incluye en el archivo de exportación estándar. El archivo contiene las siguientes tres columnas:

user_id
google_purchase_token
google_product_id

Escríbenos para importar tus datos históricos

Contáctanos a través del chat del sitio web o envíanos un correo a [email protected] con tus archivos CSV.

Envía el archivo CSV que exportaste de RevenueCat directamente a nuestro equipo de soporte.
Si vas a importar transacciones de Google Play, incluye el archivo CSV con los Google Purchase Tokens que recibiste del soporte de RevenueCat.
Indícanos qué ID de usuario debe usarse como Customer User ID (el identificador principal de usuario en Adapty): rc_original_app_user_id o rc_last_seen_app_user_id_alias.

Nuestro equipo de soporte importará tus transacciones a Adapty. Se importarán los siguientes datos para cada transacción:

Parámetro	Descripción
user_id	Customer User ID, el identificador principal de tu usuario en Adapty y en tu sistema.
apple_original_transaction_id	Para cadenas de suscripciones, esta es la fecha de compra de la transacción original, vinculada por `store_original_transaction_id`.
google_product_id	El ID del producto en Google Play Store.
google_purchase_token	Un identificador único proporcionado por Google Play para cada transacción, necesario para la validación.
country	El país del usuario.
created_at	La fecha y hora de creación del usuario.
subscription_expiration_date	La fecha y hora en que expira la suscripción.
email	El correo electrónico del usuario final.
phone_number	El número de teléfono del usuario final.
idfa	El Identificador para Anunciantes (IDFA), asignado por Apple al dispositivo de un usuario.
idfv	El Identificador para Proveedores (IDFV), un código asignado a todas las apps de un mismo desarrollador y compartido entre esas apps en un dispositivo.
advertising_id	Un identificador único proporcionado por el sistema operativo Android que los anunciantes pueden usar para el seguimiento.
attribution_channel	El nombre del canal de marketing.
attribution_campaign	El nombre de la campaña de marketing.
attribution_ad_group	El grupo de anuncios de atribución.
attribution_ad_set	El conjunto de anuncios de atribución.
attribution_creative	La palabra clave creativa de atribución.

Además, se importarán los identificadores de integración para las siguientes integraciones: Amplitude, Mixpanel, AppsFlyer, Adjust y FacebookAds.

Preguntas frecuentes

Instalé el SDK de Adapty correctamente y publiqué una nueva versión de la app. ¿Qué pasará con mis suscriptores existentes que no actualicen a la versión con el SDK de Adapty?

La mayoría de los usuarios cargan sus teléfonos por la noche, que es cuando App Store suele actualizar automáticamente todas sus apps, por lo que no debería ser un problema. Puede que quede un pequeño número de suscriptores de pago que no hayan actualizado, pero seguirán teniendo acceso al contenido premium. No tienes que preocuparte por ello ni forzarlos a actualizar.

¿Necesito exportar mis datos históricos de RevenueCat lo antes posible o los perderé?

No hace falta hacerlo con prisa; primero publica la versión con el SDK de Adapty y luego compártenos tus datos históricos. Restauraremos el historial de pagos de tus usuarios y completaremos los perfiles y los gráficos.

Uso MMP (AppsFlyer, Adjust, etc.) y herramientas de análisis (Mixpanel, Amplitude, etc.). ¿Cómo me aseguro de que todo funcionará correctamente?

Primero tienes que pasarnos los IDs de esos servicios de terceros a través de nuestro SDK para que podamos enviarles datos. Lee la guía de integración de atribución y de integración de análisis. Para los datos históricos y los usuarios existentes, asegúrate de pasarnos esos IDs a partir de los datos que exportaste de RevenueCat.