Integración inicial con Google Play
Conecta tu cuenta de Google Play con Adapty para que nuestros servidores puedan leer los productos de Play Store, validar tus compras y recibir los eventos de suscripción de Android.
Cada store se conecta de forma independiente, y estas conexiones son independientes entre sí. Si tu app también está disponible en el App Store, configura la integración con App Store Connect.
La configuración tarda aproximadamente una hora. El onboarding integrado en el Adapty Dashboard cubre los mismos pasos si prefieres trabajar en una sola ventana.
Antes de empezar
A diferencia de Apple, Google divide su ecosistema de desarrolladores en dos productos separados: Google Play Console y Google Cloud Console, y esta configuración involucra a ambos.
Qué implica
- Cuenta de servicio: Una cuenta de Google para máquinas en lugar de personas. Necesitas crear una nueva cuenta de servicio para conceder a Adapty acceso a Google Cloud y a Google Play Console.
- Google Cloud Console: La plataforma de infraestructura de uso general de Google. La Play Store no tiene credenciales de API propias, por lo que se crean aquí. Usa la Cloud Console para habilitar las Developer APIs, crear la cuenta de servicio y concederle algunos de los permisos necesarios. Adapty los necesita para recibir renovaciones, cancelaciones y reembolsos. El archivo de clave de la cuenta de servicio, que permite a Adapty autenticarse con Google, se puede descargar desde aquí.
- Google Play Console: Donde publicas tu app y vendes suscripciones. Usa la Play Console para conceder a la cuenta de servicio el resto de los permisos necesarios. Adapty los necesita para leer tus productos y validar compras. Además, aquí es donde activas las notificaciones de desarrollador en tiempo real (RTDN) para establecer una línea de comunicación entre la Play Store y Adapty.
Privilegios de acceso requeridos
| Consola | Qué necesitas |
|---|---|
| Google Cloud Console | Project Creator (roles/resourcemanager.projectCreator) para crear un proyecto, si no tienes uno. Service Account Creator (roles/iam.serviceAccountCreator) para crear la cuenta de servicio, y Project IAM Admin (roles/resourcemanager.projectIamAdmin) para asignarle permisos de proyecto. Los Owners pueden hacer las tres cosas sin configuración adicional. |
| Google Play Console | Admin (all permissions), que incluye el derecho a invitar usuarios — necesitas este permiso para invitar a la cuenta de servicio. |
Google otorga Project Creator a todos los miembros de una organización nueva de forma predeterminada, así que probablemente ya lo tengas. Una organización corporativa con políticas restrictivas puede haberlo revocado.
Recursos necesarios
Un proyecto de Google Cloud. Créalo si aún no tienes uno, o reutiliza un proyecto que ya tengas en uso. Este proyecto te permite habilitar las APIs de desarrollador y crear la cuenta de servicio para Adapty.
Un proyecto es independiente de tu app en Play Console. Un único proyecto puede gestionar las comunicaciones de varias apps. Cada app tiene su propio topic —una cola de comunicación— dentro del proyecto.
Cuando conectes los servicios de Google a Adapty, debes usar el mismo proyecto de principio a fin. Elige un proyecto que sea de tu equipo en lugar de uno personal: la clave y el topic vivirán allí mientras exista la app.
Lista de verificación para la integración inicial
- Activa las APIs de desarrollador en Google Cloud Console.
- Crea una cuenta de servicio en Google Cloud Console.
- Otorga los permisos necesarios a la cuenta de servicio en Google Play Console.
- Genera el archivo de clave de la cuenta de servicio en Google Cloud Console.
- Sube el archivo de clave y el nombre del paquete a Adapty en el Adapty Dashboard. Una cuenta de servicio nueva tarda al menos 24 horas en activarse, y Adapty no puede leer tus productos hasta entonces — para saltarte esa espera, edita y guarda cualquier descripción de producto en Google Play Console.
- Activa las notificaciones de desarrollador en tiempo real (RTDN) en Google Play Console, usando el nombre de tema que genera Adapty.
- Instala el SDK de Adapty para cada framework que use tu app:
- Prueba tus compras in-app en un dispositivo real antes de publicar.
Próximos pasos
Una vez que la integración esté lista, puedes empezar a usar las funciones de Adapty.
Mostrar paywalls requiere código adicional en la app además de la integración: como mínimo muestra los paywalls y gestiona el proceso de compra si renderizas los paywalls tú mismo.
Antes de publicar tu app, revisa el checklist de lanzamiento.