Configurar la integración con App Store

Para conectar tu app iOS a Adapty, introduce sus credenciales de App Store en App settings > iOS SDK. Adapty entonces:

  • Valida las compras.
  • Recibe eventos de suscripción.
  • Mantiene tus productos sincronizados con App Store Connect.

Si las compras o los eventos de suscripción dejan de llegar a Adapty, comprueba cada credencial.

Antes de empezar:

  • Necesitas acceso a la aplicación de destino en App Store Connect. Si la app aún no está, configura App Store Connect. Si no tienes acceso a la plataforma, solicítalo.
  • Tu equipo necesita acceso a la API de App Store Connect — es necesaria para generar la clave de acceso requerida. Si tu equipo aún no lo tiene, pide al Account Holder que lo solicite. Apple revisa cada solicitud.
  • Abre dos pestañas del navegador: tu app en App Store Connect en una, y App settings > iOS SDK en Adapty en otra. A lo largo de esta guía copiarás valores entre las dos pestañas.

Descripción general

Todas las credenciales de esta guía son obligatorias. Adapty utiliza cada una de ellas para una parte diferente del intercambio de datos con App Store. Para completar la configuración, sigue estos siete pasos:

  1. Introduce el Bundle ID y el Apple App ID
  2. Introduce el secreto compartido específico de la app
  3. Activa las notificaciones del servidor de App Store con la URL de Adapty
  4. Añade la clave de compras in-app
  5. Añade la clave de API de App Store Connect
  6. Instala el SDK de Adapty y realiza una compra en sandbox
  7. Verifica todas las credenciales

Introduce el Bundle ID y el Apple App ID

Dos valores identifican tu app en App Store Connect: el Bundle ID y el Apple ID, que en Adapty se llama Apple App ID. Adapty necesita el Bundle ID para procesar las compras. Con el Apple ID, Adapty:

  • Encuentra tus productos en App Store Connect y crea nuevos allí.
  • Muestra el estado y los precios de tus productos en el App Store.
  • Envía mensajes en tiempo real para la Mensajería de Retención.
  • Identifica tu app ante integraciones de atribución como AppsFlyer.

Apple asigna el Apple ID cuando añades la app a App Store Connect, así que introdúcelo aunque tu app todavía no esté en el App Store.

  1. Abre App Store Connect. Selecciona tu app y ve a la sección General > App Information.

  2. Copia el Bundle ID en la subsección General Information.

    Copia solo el identificador — en formato DNS inverso sin espacios, por ejemplo, com.company.app. App Store Connect muestra el nombre de la app junto a él en otras vistas, como la lista de apps; si pegas eso en lugar del identificador, la conexión entre Adapty y el App Store no podrá validarse.

asc-app-information-bundle-id.webp
  1. Abre la pestaña App settings > iOS SDK desde el menú superior de Adapty y pega el valor copiado en el campo Bundle ID.
app-settings-bundle-id.webp
  1. Vuelve a la página App information en App Store Connect y copia el Apple ID desde allí.
asc-app-information-apple-id.webp
  1. En la página App settings > iOS SDK del Adapty Dashboard, pega el ID en el campo Apple App ID.
app-settings-apple-app-id.webp

Introduce el secreto compartido específico de la app

Adapty necesita el secreto compartido específico de la app para validar los recibos de compra y para crear productos en App Store Connect.

  1. En App Store Connect, abre la página App Information de tu app. En la sección App-Specific Shared Secret, haz clic en Manage.

    Sección App-Specific Shared Secret en la página App Information de App Store Connect
  2. Copia el secreto. Si la app aún no tiene uno, haz clic primero en Generate. Para generarlo, necesitas el rol de Account Holder o Admin en App Store Connect. Si no tienes ninguno de estos roles, pide a alguien que lo tenga que genere el secreto y te lo envíe.

    A menos que hayas recibido la app mediante una transferencia de app, no hagas clic en Regenerate: el secreto actual dejará de funcionar en todos los lugares donde esté en uso.

    Ventana App-Specific Shared Secret con el secreto
  3. En Adapty, pega el secreto en el campo App Store Connect shared secret.

    App Store Connect shared secret field in Adapty
  4. Haz clic en Save.

Habilitar las notificaciones de servidor de App Store con la URL de Adapty

Apple envía notificaciones de servidor a Adapty sobre renovaciones, reembolsos y otros eventos de suscripción en tiempo real. Adapty registra estos eventos aunque tu app no notifique ninguna transacción.

Si Apple ya envía estas notificaciones a un servidor, configura el reenvío a ese servidor antes de reemplazar su URL en App Store Connect. En Adapty, introduce la URL de ese servidor en el campo URL for forwarding raw Apple events y haz clic en Save. Adapty entonces reenvía las notificaciones que recibe de Apple a ese servidor.

Si tu backend debe mantener su URL en App Store Connect, pasa las notificaciones a Adapty desde tu backend en su lugar.

  1. En Adapty, abre la app que estás conectando: cada app de Adapty tiene su propia URL de notificaciones. Ve a App settings > iOS SDK. En la sección App Store server notifications, copia la URL del campo URL for App Store server notifications.

    URL for App Store server notifications en la sección App Store server notifications en Adapty
  2. En App Store Connect, abre la página App Information de tu app.

  3. En la sección App Store Server Notifications, busca Production Server URL. Si ya hay una URL, haz clic en Edit. Si no, haz clic en Set Up URL.

    Sección App Store Server Notifications en la página App Information en App Store Connect
  4. Pega la URL de Adapty y haz clic en Save.

    Diálogo Production Server URL en App Store Connect con la URL de Adapty
  5. Para que las notificaciones de tus pruebas sandbox lleguen a Adapty, repite los pasos 3 y 4 para Sandbox Server URL.

Añade la clave de compra in-app

Adapty usa la clave de compra in-app para validar compras y firmar ofertas promocionales. Si todavía no tienes el archivo de clave, primero genera la clave en App Store Connect. Para añadir la clave a Adapty:

  1. Para encontrar el Issuer ID y el Key ID de tu clave, en App Store Connect, ve a Users and Access > Integrations > In-App Purchase. Si otra persona generó la clave y te envió su Issuer ID, Key ID y el archivo, omite este paso.

    Issuer ID y Key ID de una clave de compra in-app en App Store Connect
  2. En Adapty, ve a App settings > iOS SDK. En la sección In-app purchase API (StoreKit 2), rellena los campos:

    • Issuer ID: Cópialo desde la página In-App Purchase en App Store Connect.
    • Key ID: Cópialo desde la lista Active en la página In-App Purchase, junto a la clave que descargaste.
    • Private key (.p8 file): Sube el archivo que descargaste.
    Campos Issuer ID, Key ID y Private key (.p8 file) en la sección In-app purchase API (StoreKit 2) en Adapty
  3. Adapty firma las ofertas promocionales con la clave de compra in-app. En la sección App Store promotional offers, introduce la clave de nuevo:

    • Subscription key ID: El Key ID del paso 2.
    • Subscription key (.p8 file): El archivo del paso 2.
    Campos Subscription key ID y Subscription key (.p8 file) en la sección App Store promotional offers

    Si usas una clave distinta, se guardará sin error, pero los usuarios no podrán recibir ofertas promocionales.

  4. Haz clic en Save. Adapty verifica la clave de la sección In-app purchase API (StoreKit 2) con Apple antes de guardar la página. Si Apple rechaza la clave, la página mostrará “The provided field values are incorrect”: revisa los valores.

Añade la clave de API de App Store Connect

Adapty usa la clave de API de App Store Connect para crear productos en App Store Connect y mantener su estado y precios sincronizados. Es una clave distinta a la clave de compras in-app, aunque ambas comparten los nombres de campo Issuer ID y Key ID.

Adapty necesita una clave de equipo con acceso Admin. Si aún no tienes una, genérala en App Store Connect primero. Para conectar la clave en Adapty:

  1. Para encontrar el Issuer ID y el Key ID de tu clave de equipo, en App Store Connect, ve a Users and Access > Integrations > App Store Connect API y abre la pestaña Team Keys. Si otra persona generó la clave y te envió su Issuer ID, Key ID y archivo, omite este paso.

    Issuer ID y el Key ID de una clave de equipo en la pestaña Team Keys en App Store Connect
  2. En Adapty, ve a App settings > iOS SDK. En la sección App Store Connect API key, haz clic en Connect API Key.

    Sección App Store Connect API key en Adapty, con el botón Connect API Key
  3. Rellena los campos:

    • Issuer ID: Cópialo desde la pestaña Team Keys en App Store Connect.
    • Key ID: Cópialo de la lista Active en la pestaña Team Keys, junto a la clave que descargaste.
    • Private key (.p8 file): Sube el archivo que descargaste para la clave de equipo.
    Campos Issuer ID, Key ID y Private key (.p8 file) en la ventana de la App Store Connect API key
  4. Puedes reemplazar una clave conectada más adelante, pero no puedes eliminarla. Asegúrate de que la clave pertenece al equipo de App Store Connect propietario de esta app y haz clic en Connect. A partir de entonces, seleccionarás cada App Store Product ID de tus productos en App Store Connect en lugar de escribirlo manualmente.

    Adapty no verifica la clave con Apple en el momento de conectarla. Una clave incorrecta falla sin ningún mensaje relacionado con la clave: los productos no muestran ningún estado de App Store y el desplegable App Store Product ID permanece vacío. Para corregir una clave incorrecta, reemplázala.

Comprueba que cada credencial funcione

Para confirmar que Adapty valida las compras, instala el SDK en tu app y realiza una compra en sandbox.

La compra en sandbox solo utiliza algunas de las credenciales. Verifica cada una después de la compra, y de nuevo siempre que las compras o los eventos de suscripción dejen de llegar a Adapty:

  • Bundle ID, Apple App ID y App Store Connect shared secret: Compara los tres valores con el Bundle ID, el Apple ID y el secreto en App-Specific Shared Secret en la página App Information de App Store Connect.
  • App Store server notifications: El estado en esta sección indica Active una vez que llega a Adapty una notificación sobre una compra o renovación. Si indica cualquier otra cosa, verifica las URLs del servidor.
  • In-app purchase API (StoreKit 2): Adapty verifica la clave con Apple cuando la guardas. Si las compras en tu app no desbloquean ningún acceso más adelante, es posible que la clave haya dejado de funcionar: reemplaza la clave.
  • App Store promotional offers: Asegúrate de que el Subscription key ID coincida con el Key ID en la sección In-app purchase API (StoreKit 2). Si son distintos, introduce la misma clave en ambas secciones.
  • App Store Connect API key: Cada producto de App Store muestra un estado en la columna App Store status de la página Products. Si un producto muestra un guion o Not Connected, verifica la clave y el Apple App ID.

Justo después de la configuración, Analytics puede mostrar más pruebas y compras que instalaciones, y más de lo que muestra el Event Feed. La diferencia son las transacciones sin perfiles: compras de usuarios que aún no han abierto una versión de tu app con el SDK de Adapty.

Otras diferencias entre Adapty y los informes del store se deben a cómo cuenta las compras cada uno, no a las credenciales.

Próximos pasos

Para preparar tu app para el lanzamiento, revisa la lista de verificación de lanzamiento.

Si tu app también está en Google Play, conecta esa store.