PromptSurge

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

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 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-ios

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

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

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