Configurar la integración con App Store

Esta sección explica cómo establecer la conexión entre App Store y Adapty para tu app de iOS. Es necesaria para que podamos mostrar analíticas de suscripciones y validar compras. Puedes completar la integración durante el onboarding inicial o más tarde en App Settings dentro del Adapty Dashboard.

Aunque puede que hayas configurado inicialmente la integración de tu app móvil con Adapty durante el onboarding, puedes modificar estos ajustes más adelante en App settings.

Los cambios de configuración se pueden realizar de forma segura durante la fase Sandbox, hasta que tu aplicación móvil esté publicada con el SDK de Adapty instalado. Los cambios realizados después del lanzamiento pueden romper el flujo de compra en tu app.

Paso 1. Proporciona el Bundle ID y el Apple app ID

El Bundle ID es el identificador único de tu app en el App Store. Es necesario para el funcionamiento básico de Adapty, como el procesamiento de suscripciones.

  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.

  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.
  1. Vuelve a la página App information en App Store Connect y copia el Apple ID desde allí.
  2. En la página App settings -> iOS SDK del Adapty Dashboard, pega el ID en el campo Apple app ID.

Paso 2. Proporciona el Issuer ID y el Key ID

El In-app purchase Issuer ID, denominado Issuer ID en App Store Connect, es un ID especial que identifica al emisor que creó el token de autenticación. El In-App Purchase Key ID, denominado Key ID en App Store Connect, es un identificador único asociado a una clave criptográfica que generaste en la sección Generar la clave de compra in-app en App Store Connect.

  1. Abre App Store Connect. Ve a la sección Users and Access → Integrations → In-App Purchase.
  2. En la lista Active, busca la clave que creaste en la sección Generar la clave de compra in-app en App Store Connect.
19a2868-issuer_apple.webp
  1. Copia el Issuer ID y pégalo en el campo In-app purchase Issuer ID del Adapty Dashboard.
c2b42e7-issuer_id.webp
  1. Copia el Key ID y pégalo en el campo In-app purchase Key ID del Adapty Dashboard.

Paso 3. Sube el archivo de clave de compra in-app

Sube el archivo de In-App Purchase Key que descargaste en la sección Generar la clave de compra in-app en App Store Connect

88cdfff-download_inapp_file.webp

en el campo Private key (.p8 file) del Adapty Dashboard.

253b840-in-app_file_upload.webp

Paso 4. Para pruebas y ofertas especiales: configura las ofertas promocionales

Este paso es obligatorio si tu app tiene pruebas u otras ofertas promocionales.

  1. Copia el mismo ID de clave que usaste en el Paso 2 en el campo Subscription key ID de la sección App Store promotional offers.
  2. Sube el mismo archivo In-App Purchase Key que usaste en el Paso 3 al área Subscription key (.p8 file) de la sección App Store promotional offers.
promo-key.webp

Paso 5. Introduce el App Store shared secret

El App Store shared secret, también conocido como App Store Connect Shared Secret, es una cadena hexadecimal de 32 caracteres que se utiliza para la validación de recibos de compras in-app y suscripciones.

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

  2. Desplázate hasta la subsección App-Specific Shared Secret.

2bd112a-shared_secret_apple.webp

Si la subsección App-Specific Shared Secret no aparece, asegúrate de tener el rol de Account Holder o Admin. Si tienes el rol de Admin y aun así no ves la subsección App-Specific Shared Secret, pide al Account Holder de la app (la persona que creó la aplicación en App Store Connect) que genere el shared secret de la app. Después de eso, la subsección también será visible para los Admins.

  1. Haz clic en el botón Manage.
2d8b4c0-shared_secret_apple_copy.webp
  1. En la ventana App-Specific Shared Secret que se abre, copia el Shared Secret. Si no ves ningún shared secret, haz clic primero en el botón Manage o Generate (el que esté disponible) y luego copia el Shared Secret.
  2. Pega el Shared Secret copiado en el campo App Store shared secret del Adapty Dashboard.
4f9624d-shared_secret.webp
  1. Haz clic en el botón Save del Adapty Dashboard para confirmar los cambios.

Paso 6. Añade la clave de API de App Store Connect

Genera una clave de API de App Store Connect y añádela a Adapty para poder gestionar tus productos en el App Store desde el Adapty Dashboard:

  1. En App Store Connect, ve a Users and Access > Integrations > Team keys y haz clic en +.
app-store-connect-api.webp
  1. En la ventana Generate API key window, introduce un nombre para la clave y otórgale acceso Admin.
generate-api-key.webp
  1. Haz clic en Download junto a tu clave. Ten en cuenta que solo puedes descargarla una vez.
download-api-key.webp
  1. En el Adapty Dashboard, ve a App settings > iOS SDK y haz clic en Connect API key.
connect-api-key.webp
  1. Rellena los campos en la ventana:
issuer-id.webp
key-id.webp
  • API key: Sube el archivo de clave API que has descargado desde App Store Connect.
app-store-connect-key.webp
  1. Haz clic en Connect.

Qué hacer a continuación