Distribución de apps de “lectura” con un enlace a tu sitio web

Las apps de lectura ofrecen como principal funcionalidad uno o más de los siguientes tipos de contenido: revistas, periódicos, libros, audio, música o video. Con las apps de lectura, los usuarios pueden iniciar sesión en su cuenta creada fuera de la app para ver en su dispositivo Apple contenido al que se han suscrito o contenido multimedia adquirido previamente. Si quieres que tu app de lectura proporcione también un enlace a tu sitio web que permita a los usuarios crear y administrar su cuenta, obtén información sobre cómo solicitar el derecho a cuenta con enlace externo y lee las pautas de uso y otros datos sobre la implementación.

Solicitud de derecho a cuenta con enlace externo

Si tienes interés en ejercer este derecho, comienza por enviar un formulario de solicitud. Deberás ser el titular de la cuenta de Apple Developer Program, responder algunas preguntas sobre la app y aceptar los términos y condiciones relativos al derecho. Cada solicitud de derecho corresponde a un solo ID de paquete (el identificador único de la app) y los derechos concedidos solo pueden usarse con el binario asociado a dicho ID. Para obtener este derecho, la app debe cumplir los siguientes requisitos:

  • Ofrecer como principal funcionalidad uno o más de los siguientes tipos de contenido: revistas, periódicos, libros, audio, música o video.
  • Permitir a los usuarios iniciar sesión en una cuenta.
  • Una vez iniciada la sesión, permitir a los usuarios acceder a contenido o servicios previamente adquiridos fuera de la app; por ejemplo, en tu sitio web.
  • No ofrecer compras dentro de la app en iOS, iPadOS o tvOS mientras el usuario emplee el derecho a cuenta con enlace externo.
  • No facilitar servicios interpersonales en tiempo real (por ejemplo, clases particulares, consultas médicas, recorridos inmobiliarios o entrenamientos deportivos).

Nota: Las apps que permiten a los usuarios acceder a contenido digital, como música o video, pero no como principal funcionalidad, no se consideran apps de lectura y no cumplen los requisitos para adquirir el derecho a cuenta con enlace externo. Por ejemplo, una app de una red social que permite a los usuarios transmitir contenido audiovisual no cumple los requisitos.

Configuración y habilitación del derecho en Xcode

Una vez que recibas el correo electrónico que confirma la concesión del derecho a tu cuenta y que hayas configurado el ID de tu app en Certificates, Identifiers, and Profiles (Certificados, identificadores y perfiles) para hacer uso del derecho, deberás actualizar el proyecto de Xcode, el archivo .entitlements.plist y el archivo Info.plist para que incluyan el derecho y los metadatos.

Captura de pantalla de la habilitación del derecho en XcodeCaptura de pantalla de la la habilitación del derecho en Xcode

Para realizar estas actualizaciones:

  1. En Project navigator (Navegador de proyecto), selecciona el archivo .entitlements. En Xcode 13 o posterior, el nombre de archivo está precedido por un ícono de una marca de verificación amarilla.
  2. En el archivo .entitlements.plist, agrega un nuevo par de claves de derechos: sitúa el puntero sobre la fila de Entitlements File (archivo de derechos) y haz clic en el botón para agregar (+).
  3. Proporciona los siguientes valores para el derecho:
    1. Key (Clave): com.apple.developer.storekit.external-link.account
    2. Type (Tipo): Boolean (Booleano)
    3. Value (Valor): True (Verdadero)
  4. Proporciona los metadatos necesarios en el archivo Info.plist, como se describe a continuación, en “Actualización del archivo Info.plist”.

En la siguiente versión de tu dispositivo o solicitud de distribución en Xcode Organizer, Xcode detectará que el archivo .entitlements y el perfil de suministro almacenado en memoria no coinciden y solicitará un nuevo perfil de suministro según la configuración del ID de app más reciente para terminar el proceso de firma del código.

Actualización del archivo Info.plist

Cada derecho requiere el ingreso de datos distintos en el archivo Info.plist de la app.

Para actualizar los datos de este archivo:

  1. Selecciona el archivo Info.plist en Project Navigator (Navegador de proyecto).
  2. Proporciona los siguientes valores para este derecho:
    1. Key (Clave): SKExternalLinkAccount
    2. Type (Tipo): Dictionary with string values (Diccionario con valores de cadena)
      1. Key (Clave): Códigos de región como claves y una URL como valor. Debe contener una clave con la cadena * que dirija a una URL predeterminada.
      2. Value (Valor): Una URL de destino (el enlace a tu sitio web)

Nota: Las URL que proporciones en el archivo Info.plist de Xcode siempre deben coincidir con el valor del binario de la app enviada a App Review. Asegúrate de que cada valor sea una cadena con las siguientes características:

  • usa el esquema https;
  • forma una URL válida y absoluta;
  • no contiene parámetros de consulta; y
  • contiene 1,000 caracteres ASCII o menos.

Cómo administrar el archivo Info.plist de tu app

Requisitos para la app y el enlace

Además de habilitar un derecho para la app e implementar las API de cuenta con enlace externo necesarias, debes seguir los requisitos de uso estipulados para proteger la privacidad y la seguridad, impedir estafas y fraudes, y mantener la calidad general de la experiencia. Todo enlace proporcionado en una app de lectura debe tener las siguientes características:

  • dirigir a un sitio web que sea de tu propiedad o responsabilidad;
  • abrir una nueva ventana en el navegador predeterminado del dispositivo (no dentro de la app);
  • no especificar otros parámetros en la URL (para proteger al usuario en áreas como su privacidad);
  • enviarse con la app de lectura a App Store y volver a enviarse en caso de que la URL cambie;
  • no incluir texto que haga referencia al precio de artículos disponibles en el sitio web, ni usarse con texto de ese tipo (un ejemplo aceptable podría ser “ve a ejemplo.com para crear o administrar tu cuenta”);
  • tener el formato de un enlace HTML estándar (es decir, texto azul subrayado) y contener el nombre de dominio del sitio web;
  • aparecer solo una vez por página de la app y mostrar el mismo mensaje en cada instancia;
  • estar definido estáticamente en el valor clave external-link.account del archivo Info.plist de la app antes del envío a App Store;
  • llevar directamente al sitio web sin ningún enlace intermedio o de redireccionamiento ni página de aterrizaje.

Requisitos del sistema

El derecho a cuenta con enlace externo puede ser utilizado por apps de lectura aprobadas distribuidas en cualquier país o región donde App Store esté disponible, y es compatible con dispositivos con iOS, iPadOS o tvOS 16.4 o posterior.

Implementación de la hoja modal dentro de la app

Uso de las API de StoreKit. Cada vez que alguien toque un enlace a tu sitio web para crear una cuenta nueva o administrar una ya existente, la app debe intercalar una hoja modal antes de dirigir al usuario al destino del enlace. La app debe llamar a canMakePayments y confirmar que el usuario tiene permiso para realizar pagos antes de mostrar esta hoja.

Sigue los detalles de la hoja modal. En iOS 16 y iPadOS 16 o posterior, y en tvOS 16.4 o posterior, esto se implementa mediante el uso de la API de cuenta con enlace externo. En el caso de los dispositivos con versiones anteriores de iOS y iPadOS, deberás implementar la hoja modal siguiendo exactamente el diseño y el texto de la hoja modal que se muestran a continuación.

Compatibilidad con varios idiomas. Si quieres agregar direcciones URL para versiones de idiomas específicos de tu sitio web, deberás incluirlas en el archivo Info.Plist que la app usa como diccionario, con una clave para cada región y un valor de cadena de URL asociado. Además, usa las cadenas de texto de configuración regional proporcionadas por Apple en tu implementación de la hoja modal.

Descargar especificaciones de diseño (5 MB)

App

Hoja modal

Sitio web

Envío de la app a revisión en App Store Connect

Al enviar el binario de la app a revisión en App Store Connect, asegúrate de aceptar los términos y condiciones del derecho, los Lineamientos de revisión de apps y el Acuerdo de licencia de Apple Developer Program.

Además, deberás confirmar lo siguiente:

  • Que la hoja modal dentro de la app está correctamente implementada y probada.
  • Que el sitio web al que dirige la app está en pleno funcionamiento.
  • Que el envío incluye capturas de pantalla de la interfaz de usuario de la app donde se divulga la información necesaria para los usuarios.

Si el envío está incompleto, es posible que se demore la revisión o que se rechace la app. Una vez revisada la app, su estado se actualizará en App Store Connect y recibirás una notificación al respecto.

Preguntas frecuentes

Tengo una app de lectura que ya está publicada en App Store. ¿Tengo la obligación de hacer uso de un derecho?

No. El derecho a cuenta con enlace externo es opcional y solo se requiere para apps de lectura que vayan a ofrecer un enlace a un sitio web donde se permitirá crear o administrar cuentas. Las apps de lectura pueden seguir ofreciendo la creación de cuentas para versiones gratuitas y la funcionalidad de administración de cuentas para los clientes existentes dentro de la app, tal como se estipula en la pauta 3.1.3(a).

¿Puedo incluir en los metadatos de mi app un enlace a mi sitio web para la creación y administración de cuentas?

No. Las apps de lectura pueden incluir un enlace a un sitio web externo para la creación y administración de cuentas solo mediante el uso del derecho a cuenta con enlace externo. Esto ofrece una experiencia más segura y transparente al usuario que abandona el ecosistema de Apple.

Distribuyo varias apps de lectura en App Store. ¿Puedo usar el mismo derecho en más de una app?

No. Cada derecho a cuenta con enlace externo se concede a un solo ID de paquete (el identificador único de la app); el derecho concedido solo puede usarse con un único binario asociado al ID de paquete. Si tienes varias apps de lectura, deberás presentar una solicitud de derecho diferente para cada una de ellas.

¿Puedo usar el derecho en una app que ofrece compras dentro de la app a fin de incluir un enlace para la creación y administración de cuentas en la Web?

Las apps que ofrecen compras dentro de la app en iOS, iPadOS o tvOS no pueden hacer uso del derecho.

Si mi app ya está en App Store, ¿puedo transformarla en una app de lectura?

Depende. El modelo de negocio de una app puede cambiar con el tiempo, a medida que los desarrolladores agregan nuevo contenido y funcionalidades. Sin embargo, no es conveniente enviar una actualización que implique un cambio demasiado importante en la funcionalidad principal de la app, ya que afectaría negativamente la experiencia de los usuarios actuales. Si tienes un nuevo concepto de app que quieres distribuir en App Store, recomendamos que crees un registro y binario de app nuevos para enviar a revisión.

Me han concedido el derecho a cuenta con enlace externo, pero al enviar mi app a revisión me dijeron que no cumple los requisitos para ser una app de lectura. ¿Cómo resuelvo este problema?

Todos los envíos a App Store están sujetos a la aprobación de App Review. Si durante el proceso de envío de la app se determina que esta no cumple los requisitos para ser una app de lectura, no se aprobará mientras incluya el derecho a cuenta con enlace externo. Consulta el mensaje que aparece en App Store Connect para obtener más información.

¿Debe mi app usar la API de cuenta con enlace externo?

Las apps de lectura que incluyan el derecho a cuenta con enlace externo y cuenten con, como mínimo, iOS 16, iPadOS 16 o tvOS 16.4 deben usar la API de cuenta con enlace externo. Si tu app está en App Store, debes implementar la API en ella y enviar una actualización a partir del 12 de octubre de 2022.

Recursos