PromptSurge

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

Tu imagen de encabezado

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.

Ahora noDejar una reseña

2 · La hoja de valoración nativa

App Store o Google Play

La propia hoja de Apple o de Google, sin cambios

«Ahora no» cierra el diálogo y no muestra nada más.

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.

Ver documentación de integración →

En el teléfono

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.

  1. 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.

  2. 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 noClaro

    Paso 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.

  3. 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

  1. Más reseñas de los mismos usuarios

    Se les pide en un momento que tú elegiste, con una razón para responder.

  2. Más reseñas escritas

    Un mensaje sobre una función invita a escribir, no solo a poner estrellas.

  3. 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.

  4. 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

  1. 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.

  2. 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.

  3. 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.

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