Pruebas en sandbox
Una vez que hayas configurado todo en el Adapty Dashboard y en tu aplicación móvil, es hora de realizar pruebas de compras in-app.
Nota: ninguna de las herramientas de prueba cobra a los usuarios cuando prueban la compra de un producto. App Store no envía correos electrónicos por compras o reembolsos realizados en entornos de prueba.
Las transacciones en sandbox se excluyen de todos los gráficos de análisis. Siguen apareciendo en las páginas de perfil individuales y en el feed de eventos.
Para proceder con las pruebas de compras in-app, asegúrate de:
- Haber completado las guías de inicio rápido sobre integración con el store, añadir productos e integración del SDK de Adapty.
- Que tu producto esté marcado como Ready to submit en App Store Connect.
Pruebas en sandbox
Recomendamos probar las compras in-app con un dispositivo real. Aunque las compras en sandbox pueden ejecutarse en simuladores, los dispositivos reales son necesarios para probar todos los flujos en su totalidad, incluidos los diálogos de pago y las solicitudes biométricas.
Tienes dos formas principales de probar las compras in-app:
- Compilar en Xcode y ejecutar en un dispositivo de prueba: conveniente para desarrolladores y QA engineers.
- Usar una cuenta de prueba sandbox con TestFlight: adecuado para cualquier otra persona.
Ambas opciones se explican en la guía a continuación.
Paso 1. Crear una cuenta de prueba Sandbox en App Store Connect
Crea una nueva cuenta de prueba Sandbox para asegurarte de que tu historial de compras esté limpio. Si reutilizas una cuenta existente, los productos comprados anteriormente seguirán disponibles y no podrás probar comprarlos de nuevo.
Puedes crear una nueva cuenta de prueba Sandbox en pocos clics:
- Ve a Users and Access > Sandbox > Test Accounts en App Store Connect y haz clic en +.
- Introduce los datos del usuario de prueba. Asegúrate de definir el Country or Region que planeas probar, ya que afecta la disponibilidad del producto para la región y la moneda de compra.
- Si usas Gmail o iCloud, puedes reutilizar tu dirección de correo existente con el subdireccionamiento con signo más.
- Puedes usar una dirección de correo aleatoria que ni siquiera exista, pero asegúrate de rechazar la autenticación de dos factores (2FA) cuando inicies sesión en un dispositivo de prueba más adelante.
- Haz clic en Create.
Paso 2. Activar el modo Desarrollador
Omite este paso si el modo Desarrollador ya está activado en tu dispositivo de prueba o si no tienes un dispositivo Mac.
Necesitarás un Mac con Xcode instalado y el cable de tu dispositivo de prueba:
- Abre Xcode en tu Mac. Si vas a probar las compras in-app con TestFlight, solo necesitas tener XCode instalado; no es necesario tener una app ahí.
- Conecta tu dispositivo de prueba al Mac mediante el cable.
- Ve a Settings > Privacy & Security > Developer Mode en tu dispositivo de prueba y activa el Developer Mode.
Paso 3. Descargar la app desde TestFlight
Este paso solo aplica si estás probando con TestFlight. Si estás compilando la app en Xcode, omite este paso.
Para más detalles sobre cómo enviar tu app a TestFlight, consulta la documentación de Apple.
Antes de descargar la app de TestFlight, en tu dispositivo de prueba, asegúrate de haber iniciado sesión con tu Apple Account de producción. Luego descarga la app que vayas a probar desde TestFlight.
No abras la app una vez descargada. Continúa directamente con los siguientes pasos. Si la abres accidentalmente, elimínala de tu dispositivo de prueba y descárgala de nuevo. De lo contrario, tu historial de compras puede no estar limpio y las pruebas de compras in-app generarán errores.
Paso 4. Cambiar a la cuenta de prueba Sandbox
¿No usas Mac? Aquí tienes una alternativa
Si no trabajas en macOS, no puedes cambiar a una cuenta sandbox desde Xcode. Sin embargo, puedes hacerlo directamente en tu dispositivo de prueba:
- Ve a Settings > Your Apple Account > Media & Purchases en tu dispositivo de prueba.
- Selecciona Sign Out en el menú emergente.
- Abre la app descargada desde TestFlight e intenta comprar un producto.
- Cuando se te pida iniciar sesión, introduce las credenciales de tu cuenta sandbox para cambiar al entorno sandbox.
Para cambiar a tu cuenta sandbox:
- Ve a Settings > Your Apple Account > Media & Purchases en tu dispositivo de prueba.
- Selecciona Sign Out en el menú emergente.
- Ve a Settings > Developer. Si la opción Developer no está disponible, asegúrate de haberla activado en el paso 2.
- Desplázate hacia abajo hasta la sección Sandbox Apple Account y toca Sign In.
- Inicia sesión con las credenciales de tu Sandbox Apple Account.
Paso 5. Borrar el historial de compras
Si acabas de crear una nueva cuenta de prueba Sandbox y has cambiado a ella, puedes omitir este paso, ya que solo aplica cuando repites pruebas con la misma cuenta de prueba Sandbox.
- Ve a Settings > Developer > Sandbox Apple Account en tu dispositivo de prueba.
- Selecciona Manage en el menú emergente.
- Ve a Account Settings y toca Clear Purchase History.
Este paso es necesario cada vez que repitas las pruebas con la misma cuenta de prueba Sandbox. En ese caso, también deberás cerrar sesión de tu cuenta de prueba Sandbox y volver a iniciarla para limpiar la caché del historial de compras en el dispositivo de prueba.
Paso 6. Compilar en Xcode y ejecutar
Este paso solo aplica si estás probando con una compilación de Xcode. Si usas TestFlight, omite este paso.
- Conecta tu dispositivo de prueba al Mac.
- Abre Xcode.
- Haz clic en Run en la barra de herramientas o elige Product > Run para compilar y ejecutar la app en el dispositivo conectado.
Si la compilación es exitosa, Xcode lanzará la app en tu dispositivo y abrirá una sesión de depuración en el área de debug.
Tu app ya está lista para pruebas en el dispositivo.
Paso 7. Realizar una compra de prueba
Abre la app y realiza tu compra de prueba a través de un paywall.
Una vez hecho, ve al artículo sobre validar compras de prueba para revisar los resultados.
Paso 8. Seguir probando
Ahora tu entorno de pruebas está listo. Si quieres volver a probar, borra el historial de compras de la cuenta sandbox.
Problemas de prueba
A continuación se describen los problemas más comunes que puedes encontrar al probar una app.
Problemas con TestFlight
No puedes borrar tu historial de compras si usas TestFlight sin la cuenta de prueba Sandbox, lo que genera varios problemas y resultados de prueba incorrectos.
Si olvidaste accidentalmente cambiar a la cuenta de prueba Sandbox y abriste la app aunque sea una vez, TestFlight asocia tu historial de compras a tu Apple Account de producción, lo que genera problemas inesperados.
Para solucionarlo, sigue estos pasos:
- Elimina la app del dispositivo de prueba.
- Sigue los pasos para las pruebas en sandbox.
Es importante no solo reinstalar la app, sino también cambiar a la cuenta de prueba Sandbox, borrar el historial de compras y lanzarla con la cuenta de prueba Sandbox.
Problemas con niveles de acceso compartidos
Si repites las pruebas con la misma cuenta de prueba Sandbox, puedes encontrar comportamiento inesperado con los niveles de acceso compartidos para el usuario de prueba.
Para verificar si el usuario tiene un nivel de acceso heredado, ve a Profiles & Segments desde el Adapty Dashboard y abre el perfil del usuario.
Si el usuario tiene un nivel de acceso heredado, sigue estos pasos para obtener resultados de prueba precisos:
- Elimina el perfil principal.
- Elimina la app del dispositivo de prueba.
- Descarga la app desde TestFlight.
- Cambia a la cuenta de prueba Sandbox.
- Borra el historial de compras.
- Abre la app y realiza tu compra de prueba.
Actualización de la app en TestFlight
Si la app de TestFlight ha sido actualizada:
- Elimina la app del dispositivo de prueba.
- Descarga la app desde TestFlight.
- Cambia a la cuenta de prueba Sandbox.
- Borra el historial de compras.
- Abre la app y realiza tu compra de prueba.
Autorización durante el proceso de compra
Si has descargado la app de TestFlight y no has iniciado sesión en la cuenta sandbox desde la configuración del dispositivo, intentar hacerlo durante el proceso de compra no funcionará. Para que la compra sea exitosa, debes iniciar sesión en tu cuenta sandbox desde la configuración del dispositivo antes de intentar realizar una compra.
Suscripciones de prueba
Al probar la app con la cuenta de prueba Sandbox, puedes configurar la tasa de renovación de la suscripción para cada tester en sandbox. Consulta más información sobre la edición de las tasas de renovación de suscripciones en la documentación oficial de Apple.
De forma predeterminada, las suscripciones se renuevan hasta 12 veces antes de detenerse, según el siguiente calendario:
| Duración de la suscripción | 1 semana | 1 mes | 2 meses | 3 meses | 6 meses | 1 año |
|---|---|---|---|---|---|---|
| Velocidad de renovación | 3 minutos | 5 minutos | 10 minutos | 15 minutos | 30 minutos | 1 hora |
| Duración del reintento de cobro | 10 minutos | 10 minutos | 10 minutos | 10 minutos | 10 minutos | 10 minutos |
| Duración del período de gracia | 3 minutos | 5 minutos | 5 minutos | 5 minutos | 5 minutos | 5 minutos |
Ten en cuenta que las transacciones de prueba pueden tardar hasta 10 minutos en aparecer en el Event feed.
Ofertas de prueba
Para probar ofertas es necesario que todos los recibos del usuario estén eliminados para que la elegibilidad funcione correctamente.
La forma más fiable de probar ofertas es usar una cuenta de prueba Sandbox completamente nueva. Repetir las pruebas con la misma cuenta de prueba Sandbox puede causar comportamiento inesperado.
Si repites las pruebas con la misma cuenta de prueba Sandbox, asegúrate de borrar el historial de compras para evitar problemas relacionados con la elegibilidad.