SDK para Android
Reseñas in-app en Android con la API In-App Review de Google Play
PromptSurge para Android es una biblioteca Kotlin que muestra un pre-prompt breve y con tu marca y luego lanza el flujo In-App Review de Google Play cuando el usuario confirma. Dos llamadas en tu código; el texto, el tema, la imagen de encabezado y los idiomas vienen del servidor.
Plan gratuito · minSdk 24 · JitPack
1 · Tu pre-prompt
Un pequeño favor
Hemos trabajado mucho en la sincronización sin conexión. Una reseña breve ayuda a otras personas a descubrir la app.
2 · La hoja de valoración nativa
App Store o Google Play
La propia hoja de Apple o de Google, sin cambios
Lo que el SDK de Android hace por ti
La propia tarjeta de reseña de Play
Al confirmar, el SDK ejecuta requestReviewFlow() y launchReviewFlow() de ReviewManager. La tarjeta es de Google y se muestra tal cual; el pre-prompt ya se ha cerrado, y la propia cuota de Play decide si aparece la tarjeta.
Encaja con cualquier tema de app
El diálogo es Material 3. Con un tema Material hereda tu estilo; con AppCompat, temas de plataforma o temas de juego personalizados, recurre a su propio tema incluido en lugar de provocar un cierre inesperado. Los colores del panel se aplican encima.
Seguro en apps en producción
minSdk 24, sin permisos en tiempo de ejecución, nada añadido a tu manifiesto, reglas de R8 incluidas en el AAR. requestReview() no hace nada si la actividad se está cerrando, su estado ya se ha guardado o el diálogo ya está abierto.
Todas las comprobaciones de elegibilidad incluidas
El opt-out, un periodo de espera de 90 días por dispositivo, el grupo de control del 10 %, la fase de calentamiento de 50 dispositivos y el límite mensual de tu plan se comprueban primero. Cuando el pre-prompt se retiene por la fase de calentamiento, el grupo de control o un límite agotado, el flujo de reseña de Play se lanza igualmente, así que el momento no se pierde.
Respuestas de Data Safety incluidas
El único identificador es el SHA-256 de ANDROID_ID más el nombre de tu paquete, nunca el ID sin procesar, y no se usa ningún ID de publicidad. El README indica exactamente qué declarar en el formulario de Data Safety de Play.
La integración
Añade JitPack y una dependencia de Gradle (las coordenadas y la versión actual están en la documentación), inicializa en tu Application y luego llama a requestReview() en tu momento.
Application.onCreate()
import com.promptsurge.sdk.PromptSurge
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
PromptSurge.initialize(this, "ps_live_your_key_here")
}
}En tu momento
// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)
// Or from a Fragment
PromptSurge.requestReview(requireActivity())Durante la integración, PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO) imprime una línea por cada decisión. La tarjeta de Play está limitada por cuota y a menudo no muestra nada en una compilación de depuración, así que es normal que ahí no se vea.
Lo que ve tu usuario, en tres pasos
Los mismos usuarios, el mismo momento. La diferencia es que primero se les pide, con palabras sobre tu app.
Viaje guardado
Disponible sin conexión
requestReview()
Paso 1
Tu código elige el momento
Llama a requestReview() justo después de algo que salió bien, como un viaje guardado o un nivel terminado.
Un pequeño favor
Trabajamos mucho en los mapas sin conexión. Una reseña corta ayuda a otros viajeros a encontrar esta app.
Ahora noClaroPaso 2
El pre-prompt pide con tus palabras
Un mensaje corto que nombra lo que hace tu app. Ahora no lo cierra y no pasa nada más.
Valorar esta app
Toca una estrella para valorar
Una reseña que nombra la función
Los mapas sin conexión salvaron mi viaje. Funciona sin señal.
Paso 3
La hoja de valoración de la tienda
Un sí abre la hoja de la tienda, sin cambios. El mensaje que acaban de leer les da algo concreto sobre lo que escribir.
Para qué está hecho
Más reseñas de los mismos usuarios
Se les pide en un momento que tú elegiste, con una razón para responder.
Más reseñas escritas
Un mensaje sobre una función invita a escribir, no solo a poner estrellas.
Tus palabras clave en sus palabras
Las reseñas que nombran lo que hace tu app le dicen al siguiente visitante para quién es.
Una señal que leen las tiendas
Apple y Google dicen que las valoraciones y reseñas influyen en cómo se posicionan las apps en la búsqueda.
Tu panel muestra qué cambió para tu app: reseñas escritas por día, estrellas y menciones de palabras clave, antes del pre-prompt y con él.
Fuentes: Apple: búsqueda en el App Store · Google Play: descubrimiento y posicionamiento de apps
Cómo funciona
Añade el SDK
Instala el paquete de iOS, Android o Unity y llama a initialize() una vez al arrancar. Después llama a requestReview() en el momento que elijas, como un nivel superado, un proyecto guardado o un pedido completado.
Haz tuyo el pre-prompt
En el panel, escribe el título, el mensaje y las etiquetas de los dos botones, o deja que la IA integrada los redacte a partir de tus propias reseñas. Elige un tema, añade una imagen de encabezado desde Startup y acepta: el texto se traduce a 10 idiomas y llega a los dispositivos sin actualizar la app.
Compara con el grupo de control
El 10 % de los dispositivos nunca ve el pre-prompt y recibe la hoja nativa directamente en los mismos momentos. El panel pone ambos grupos uno junto al otro y registra cada día tu valoración y tu número de valoraciones en la tienda.
Medido frente a un grupo de control, no supuesto
Cada app tiene un grupo de control. El 10 % de los dispositivos se asigna a él de por vida y nunca ve el pre-prompt: cuando llegan al momento que elegiste, la hoja nativa se lanza directamente, como ocurriría sin PromptSurge. Una app nueva también empieza con una fase de calentamiento de 50 dispositivos que solo ven la hoja nativa, para que exista una línea base antes de mostrar el primer pre-prompt.
El panel compara los dos grupos sobre todos los dispositivos que llegaron a tu momento de reseña: cuántos vieron el pre-prompt, cuántos tocaron para continuar, cuántas hojas nativas se solicitaron. No da un veredicto hasta que cada lado tiene al menos 50 dispositivos.
Un límite honesto: Apple y Google nunca le dicen a una app si un usuario valoró ni qué escribió. Por eso, junto al embudo, PromptSurge registra una vez al día tu valoración y tu número de valoraciones en la tienda y muestra el cambio. Es un total de la tienda, no atribuido a ningún prompt concreto, y el panel lo indica.
Grupo de control del 10 %
Asignado por dispositivo, de por vida. La hoja nativa se lanza directamente en los mismos momentos.
Calentamiento de 50 dispositivos
Una app nueva empieza solo con la hoja nativa, así que primero se obtiene la línea base.
Instantánea diaria de la tienda
Tu valoración media y tu número de valoraciones en cada tienda, una vez al día, para las apps con enlace a la tienda.
Preguntas frecuentes
¿Qué versiones de Android son compatibles?
minSdk 24 (Android 7.0) y posteriores, Kotlin 1.9 o posterior, distribuido a través de JitPack. El diálogo necesita androidx.fragment, que appcompat ya incluye.
¿Qué relación tiene el pre-prompt con las directrices de Google Play sobre reseñas in-app?
Google pide a las apps que muestren su tarjeta de reseña sin modificarla, sin nada encima, y que no hagan ninguna pregunta al usuario antes de presentarla ni mientras la presentan, y cita las preguntas de opinión («¿Te gusta la app?») y las predictivas («¿Valorarías esta app con 5 estrellas?»). PromptSurge nunca altera ni cubre la tarjeta de Play, su diálogo ya se ha cerrado antes de que se abra la tarjeta, y su texto predeterminado y generado son afirmaciones que piden una reseña, nunca una pregunta. La guía de Google también dice que las apps no deberían ofrecer un botón de llamada a la acción que active el flujo de reseña, porque su cuota puede impedir que aparezca la tarjeta; el botón de confirmar de un pre-prompt es un botón así, así que sopesa esa indicación para tu app. En las versiones actuales del SDK, PromptSurge omite su pre-prompt en un dispositivo durante los 30 días siguientes a su última solicitud de la tarjeta de Play, lo que reduce ese riesgo pero no puede eliminarlo, porque Google no publica su cuota. Si escribes tu propio texto, formula el título como una afirmación, como el ejemplo de esta página; el panel te avisa de cualquier pregunta.
Lo que dicen las tiendas y una nota para App Review (documentación en inglés) →¿Tocar «Ahora no» gasta la cuota de Play?
No. «Ahora no» no lanza ningún flujo de reseña. Solo una confirmación, o las rutas solo nativas para la fase de calentamiento, el grupo de control y un límite del plan agotado, llaman a la API In-App Review.
¿Por qué no aparece nada en mi dispositivo de prueba?
Normalmente es la fase de calentamiento: una app nueva se queda solo con la tarjeta de Play hasta que 50 dispositivos distintos han llegado al momento de reseña. Desactívala para la app en el panel mientras pruebas. La propia tarjeta de Play también está limitada por cuota y a menudo no aparece en compilaciones de depuración.
¿Qué declaro en Data Safety?
Device or other IDs, y App activity > App interactions: recopilados, no compartidos, para analítica, no vinculados al usuario, además de lo que recopile el resto de tu app. El README explica cada respuesta.
Relacionado
Empieza gratis
El plan Indie es gratis para siempre: una app, 500 impresiones de pre-prompt al mes, sin tarjeta de crédito. Las imágenes de encabezado personalizadas empiezan con Startup, a 39 € por app y mes. Precios en EUR, IVA incluido.
Dos llamadas en tu app Android, el resto en el panel
Plan gratuito, sin tarjeta de crédito. Crea una app, copia su clave API y publica.
Crear tu cuenta gratuita →¿Ya tienes una cuenta? Iniciar sesión