SDK para iOS
Diálogo de reseña para iOS con SKStoreReviewController y requestReview
PromptSurge para iOS es un paquete Swift que muestra un pre-prompt breve y con tu marca y luego llama a la propia solicitud de reseña de StoreKit 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 · iOS 14+ · Swift Package Manager
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 iOS hace por ti
La propia hoja de valoración de StoreKit
Al confirmar, el SDK pide a StoreKit su hoja de reseñas con tu window scene: las versiones actuales del SDK llaman a AppStore.requestReview(in:) en iOS 16 y posteriores, y a SKStoreReviewController.requestReview(in:) en versiones anteriores. iOS decide si aparece la hoja, hasta tres veces al año por dispositivo; el SDK nunca dibuja estrellas ni recoge una valoración por su cuenta.
UIKit y SwiftUI
Pasa cualquier view controller desde el que presentar; desde SwiftUI, pásale tu root view controller. El diálogo es una tarjeta UIKit creada por código que respeta el área segura y permite desplazar los textos largos.
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 antes de que aparezca nada. Cuando el pre-prompt se retiene por la fase de calentamiento, el grupo de control o un límite agotado, la solicitud nativa se lanza igualmente, así que el momento no se pierde.
Sin solicitud de ATT, manifiesto de privacidad incluido
El único identificador es un hash SHA-256 con sal de identifierForVendor y tu bundle ID; no hay IDFA ni solicitud de App Tracking Transparency. PrivacyInfo.xcprivacy viene en el paquete, y el README te da las respuestas para App Privacy.
Se muestra sin esperas
Llama a prefetch() al arrancar y el texto queda en caché en el dispositivo, así que requestReview(in:) puede mostrar el diálogo sin esperar a la red.
La integración
Añade el paquete en Xcode (File > Add Package Dependencies, pega la URL de abajo y elige el producto PromptSurge). Inicializa una vez y luego llama a requestReview(in:) en tu momento. Los pasos completos, incluido Package.swift, están en la documentación.
URL del paquete
https://github.com/PromptSurge-SDK/sdk-iosPunto de entrada de la app (SwiftUI)
import SwiftUI
import PromptSurge
@main
struct YourApp: App {
init() {
PromptSurge.initialize(apiKey: "ps_live_your_key_here")
PromptSurge.prefetch() // warms the cache in the background
}
var body: some Scene {
WindowGroup { ContentView() }
}
}En tu momento (UIKit)
import PromptSurge
class CheckoutViewController: UIViewController {
private func onPurchaseSuccess() {
PromptSurge.requestReview(in: self)
}
}Durante la integración, PromptSurge.setLogLevel(.info) imprime una línea por cada decisión, incluida la fase de calentamiento que mantiene una app nueva solo con la hoja nativa durante sus primeros 50 dispositivos.
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 iOS son compatibles?
iOS 14 y posteriores, compilado con Xcode 14 o posterior, instalado con Swift Package Manager.
¿Se permite un pre-prompt según la directriz 5.6.1 de App Store?
La directriz 5.6.1 dice que hay que usar la API de Apple para pedir reseñas y que Apple no permitirá diálogos de reseña personalizados. PromptSurge nunca recoge una valoración por su cuenta: las estrellas y el texto de la reseña siempre ocurren en la propia hoja de Apple, solicitada a través de StoreKit. El diálogo previo es una petición breve que nunca pregunta al usuario cómo se siente. La documentación de StoreKit de Apple también dice que no se llame a requestReview en respuesta a la pulsación de un botón, porque el sistema puede no mostrar la hoja; con un pre-prompt, es el toque del usuario en el botón de confirmar lo que la solicita. En las versiones actuales del SDK, PromptSurge deja de mostrar su pre-prompt en un dispositivo cuando ya ha solicitado allí la hoja de Apple tres veces en 365 días, el límite de la propia Apple, así que es menos probable que un sí se quede sin respuesta. Cómo revisa Apple una app concreta es decisión de Apple, así que haz que cualquier texto que escribas tú mismo sea una simple afirmación y plantéate describir el pre-prompt en tus notas para App Review; el panel te avisa cuando un texto hace una pregunta.
Lo que dicen las tiendas y una nota para App Review (documentación en inglés) →¿Aparecerá siempre la hoja nativa después de confirmar?
No, lo decide iOS. StoreKit muestra la solicitud como máximo tres veces en 365 días por dispositivo y, a quien ya ha valorado, solo para una versión nueva y pasado un año. En las versiones actuales del SDK, el pre-prompt deja de mostrarse en un dispositivo cuando el SDK ya ha solicitado allí la hoja tres veces en 365 días. Ni el SDK ni ningún otro código puede saber si apareció ni si el usuario valoró.
¿Por qué no aparece nada en mi dispositivo de prueba?
Casi siempre es la fase de calentamiento: una app nueva se queda solo con la hoja nativa hasta que 50 dispositivos distintos han llegado al momento de reseña. Desactiva la fase de calentamiento para la app en el panel mientras pruebas, y activa setLogLevel(.info) para ver cada decisión.
¿Qué declaro en App Privacy?
Identifiers > Device ID y Usage Data > Product Interaction, ambos para analítica, no vinculados a la identidad y no usados para rastreo, además de lo que recopile el resto de tu app. El README tiene la tabla.
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 iOS, 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