Appy

Deep linking

¿Qué es el archivo apple-app-site-association (AASA)?

En pocas palabras

El apple-app-site-association (AASA) es el archivo JSON que publicas en tu dominio para que funcionen los Universal Links. Vive en https://tudominio.com/.well-known/apple-app-site-association y dice qué app (Team ID más bundle ID) abre qué rutas. El iPhone lo consulta para decidir si un enlace se abre en la app o en Safari; si falta o tiene errores, se abre la web.

Las reglas del archivo

Tiene que servirse por HTTPS y sin redirecciones, y su nombre no lleva la extensión .json. Dentro aparece el identificador de tu app, es decir, el Team ID unido al bundle ID (por ejemplo ABCDE12345.com.example.app), junto con las rutas o reglas de rutas (components) que la app debe abrir.

También se pueden excluir rutas. Por ejemplo, las direcciones que empiezan por /product pueden abrir la app mientras /blog se queda en el sitio web.

Por qué los cambios tardan

El iPhone no descarga el archivo de tu servidor cada vez que alguien toca un enlace. Apple lo recoge a través de su CDN cuando la app se instala o se actualiza, y el dispositivo usa esa copia. Si ya corregiste el archivo y el enlace sigue abriéndose en Safari, puede que la copia de la CDN aún no se haya renovado.

Redirigir el archivo a otra dirección, por ejemplo a la versión con www o a una página de inicio de sesión, también rompe los Universal Links. El generador de AASA y assetlinks.json gratuito de Appy prepara el archivo con el formato correcto.

EjemploDirección del archivo
https://example.com/.well-known/apple-app-site-association
Para saber másGenerador de AASA y assetlinks.jsonEscribe tu Team ID, tu bundle ID y tus rutas, y copia el archivo listo para subir a tu servidor.
  • Universal Links

    Los Universal Links (enlaces universales) son el sistema de Apple, disponible desde iOS 9, que permite que una dirección https normal abra tu app en el iPhone. Si la app está instalada, el enlace la abre en la pantalla correspondiente; si no, muestra tu sitio web en Safari. Requieren el entitlement Associated Domains y un archivo apple-app-site-association en el dominio.

  • assetlinks.json

    assetlinks.json es el archivo de Digital Asset Links con el que Android verifica la relación entre tu dominio y tu app. Se publica en https://tudominio.com/.well-known/assetlinks.json e incluye el nombre de paquete y las huellas SHA-256 del certificado de firma. Si falta o los datos no coinciden, los App Links no se verifican y los enlaces se abren en el navegador.

Todos los términos

Crea un enlace que lleve cada teléfono a su sitio

Un enlace y un código QR: el iPhone va al App Store, el Android a su tienda y el escritorio a tu sitio web. El plan gratuito incluye 4 enlaces y no tiene anuncios.