Acerca de los vínculos de apps

Los Android App Links son una capacidad especial de vinculación directa en Android 6 y versiones posteriores que permite que las URLs verificadas de tu sitio web abran inmediatamente el contenido correspondiente en tu app para Android, sin requerir que el usuario seleccione tu app en un diálogo de desambiguación. Para que esto sea posible, Android usa instrucciones de Vínculos de recursos digitales alojadas en tu sitio web para establecer una asociación segura y verificada entre tu sitio web y tu app. Después de verificar la asociación, Android puede enrutar automáticamente tus vínculos directos a tu sitio web directamente a tu app para que los controle.

A partir de Android 15, los App Links son aún más potentes con la introducción de los App Links dinámicos. Con las nuevas capacidades dinámicas, puedes definir mejor los comportamientos de los vínculos directos de tu app sobre la marcha, con más control y sin necesidad de lanzar una nueva versión de la app.

Motivos para usar vínculos de aplicación:

  • Experiencia del usuario fluida: Lleva a los usuarios directamente al contenido específico de tu app desde los resultados de la búsqueda, los sitios web, la mensajería y otras apps. Dado que los vínculos de aplicaciones usan una sola URL para el mismo contenido en tu sitio web y en tu app, los usuarios que no tienen la app instalada van a tu sitio web en lugar de la app, sin páginas 404 ni errores.
  • Seguridad mejorada: Los App Links requieren la verificación de la propiedad del dominio, lo que impide que otras apps intercepten tus vínculos.
  • Configuración dinámica (Android 15 y versiones posteriores): Actualiza el comportamiento de los vínculos directos de tu app sobre la marcha, lo que permite una mayor flexibilidad y actualizaciones más rápidas para elementos como URLs personalizadas, campañas de temporada o vínculos específicos para el usuario.
  • Participación: Puedes interactuar con los usuarios a través de vínculos en los resultados de la búsqueda, anuncios, páginas web, mensajes y mucho más.

Cómo admitir vínculos de aplicación

  1. Crea vínculos directos a contenido específico en tu app: En el manifiesto de tu app, crea filtros de intents para los URIs de tu sitio web y configura tu app para usar datos de los intents y enviar a los usuarios al contenido correcto en tu app. Obtén más información aquí.
  2. Agrega la verificación para tus vínculos directos: Configura tu app para solicitar la verificación de los vínculos de aplicaciones. Luego, publica un archivo JSON de Vínculos de recursos digitales en tus sitios web para verificar la propiedad.

Como alternativa, puedes usar el Asistente de Android App Links en Android Studio para que te guíe por cada uno de los pasos necesarios para crear y verificar Android App Links. Para obtener más información, consulta Herramientas para desarrolladores de vínculos de apps.

  • Vínculos dinámicos a la app: Android 15 (nivel de API 35) o versiones posteriores, en dispositivos con servicios de Google instalados.
  • Vínculos de aplicación: Android 6 (nivel de API 23) y versiones posteriores, en dispositivos con los servicios de Google instalados
  • Vinculación directa normal (administrada por el usuario): Todas las versiones de Android, en todos los dispositivos.

Cómo funcionan los vínculos en la aplicación

Los App Links son una forma especial de vinculación directa que te brinda control total sobre el manejo de los vínculos a tu propio sitio web. Se basa en el mismo sistema basado en la intención que usan otros tipos de vínculos directos, pero agrega un paso de verificación para tus vínculos con un archivo de Vínculos de recursos digitales en tu sitio web.

Los vínculos de apps crean una asociación segura y confiable entre tu app y tu sitio web con datos de la app y un archivo assetlinks.json especial que alojas en tu sitio web o dominio. El archivo assetlinks.json declara instrucciones de Vínculos de recursos digitales para verificar la asociación de la app.

Este es el flujo conceptual:

  1. El manifiesto de tu app declara URLs en un filtro de intents con android:autoVerify="true" y apunta al host de tu sitio web.
  2. Cuando se instala la app, el sistema Android recupera el archivo assetlinks.json de una ubicación conocida en tu servidor web.
  3. El sistema verifica que el archivo assetlinks.json sea válido y que el sha256_cert_fingerprints coincida con el certificado de firma de tu app.
  4. Cuando el usuario hace clic en un vínculo coincidente, el sistema lo redirecciona directamente a tu app, sin mostrar un diálogo de desambiguación.

Debido a que los vínculos de aplicaciones usan URLs HTTP y la asociación con un sitio web, los usuarios que no tienen tu app instalada se dirigen de manera directa al contenido de tu sitio. De esta manera, los vínculos de aplicaciones ofrecen una experiencia confiable y fluida para los usuarios que presionan vínculos directos a tus propiedades web.

A partir de Android 15, los App Links son aún más potentes con la introducción de los App Links dinámicos. Con los vínculos de aplicaciones dinámicos, tienes la opción de actualizar tus reglas de vinculación directa en el servidor, en tu archivo assetlinks.json, sin necesidad de publicar una nueva versión de tu app. Los vínculos de aplicaciones dinámicos admiten campos de vínculos de recursos digitales para definir mejor tus reglas de vinculación directa. Los dispositivos Android con los servicios de Google instalados actualizarán tu archivo periódicamente y aplicarán tus nuevas reglas de vinculación directa de forma dinámica. No es necesario actualizar la app.

Anteriormente, este archivo se usaba principalmente para la verificación básica. Ahora es una potente herramienta de configuración que te permite especificar rutas, parámetros de consulta, fragmentos y exclusiones, lo que proporciona una solución de vinculación directa dinámica y sólida:

  • Compatibilidad con exclusiones: Puedes especificar ciertas rutas o secciones de una URL que no deberían abrir tu app, incluso si coinciden con la configuración de tu vínculo de aplicación.
  • Compatibilidad con parámetros de consulta: Con la nueva función de parámetros de consulta, puedes definir parámetros específicos que, si están presentes en una URL, impedirán que se abra tu app. Esto abre posibilidades interesantes para las exclusiones dinámicas, las pruebas A/B y la habilitación gradual de la vinculación de aplicaciones para ciertos segmentos de usuarios.
  • Actualizaciones dinámicas: Realiza actualizaciones en la configuración de tus App Links sin necesidad de actualizar tu app. Para ello, especifica las rutas de URL que tu app controla directamente dentro del archivo assetlinks.json alojado en tu servidor.

Los vínculos dinámicos también te brindan un control detallado sobre las URLs con las que deseas abrir tu app, incluida la coincidencia de rutas de URL, fragmentos y parámetros de consulta. También puedes excluir cualquiera de las coincidencias para que no se les permita abrir tu app. Para obtener más información, consulta Cómo configurar reglas dinámicas.

A continuación, se muestra el flujo conceptual de los App Links dinámicos:

  1. El manifiesto de tu app declara URLs en un filtro de intents con android:autoVerify="true" y apunta al host de tu sitio web.
  2. Cuando se instala la app, el sistema Android recupera el archivo assetlinks.json de una ubicación conocida en tu servidor web.
  3. El sistema verifica que el archivo sea válido y que el sha256_cert_fingerprints coincida con el certificado de firma de tu app.
  4. El sistema analiza cualquier regla de vinculación directa que hayas definido en el campo dynamic_app_deep_link_components de la declaración de Digital Asset Links y las combina con las reglas declaradas en el manifiesto.
    1. Cuando el usuario hace clic en un vínculo coincidente, el sistema lo dirige directamente a tu app, sin mostrar un diálogo de desambiguación.
  5. El sistema vuelve a recuperar periódicamente el archivo assetlinks.json para obtener las reglas más recientes, lo que te permite actualizar tus vínculos sin necesidad de actualizar la app. La recuperación periódica se admite en dispositivos con Android 15 (nivel de API 35) o versiones posteriores que tengan instalados los servicios de Google.

Ejemplos de casos de uso

  • Campañas de marketing estacionales: Una app de comercio minorista podría agregar una regla para "/promo/summer-sale" al archivo assetlinks.json para dirigir a los usuarios a una pantalla de ofertas específica. Una vez que finalice la oferta, se puede quitar la regla sin que los usuarios deban actualizar la app.
  • URLs personalizadas para socios: Si tienes una asociación con un influencer, puedes crear una URL personalizada, como "/partner/nombre-del-influencer", y agregar una regla para ella. Luego, puedes hacer un seguimiento de esta URL, actualizarla o quitarla de forma dinámica a medida que cambian las asociaciones.
  • Rutas de acceso de URL para pruebas A/B: Un desarrollador podría publicar una nueva función en una ruta de acceso de URL específica y agregar una regla para ella en el archivo assetlinks.json. Esto les permite probar la función con un subconjunto de usuarios y, luego, modificar el enrutamiento sin implementar la app por completo.
  • Eventos de corta duración: Una app de venta de entradas o de eventos podría agregar reglas de URL para eventos específicos. Una vez que haya pasado el evento, puedes borrar estas reglas del servidor.

Compatibilidad con implementaciones de vínculos de apps

Las extensiones de vínculos dinámicos a la app en Android 15 están diseñadas para ser totalmente compatibles con las implementaciones existentes de vínculos a la app en dispositivos que ejecutan versiones anteriores de Android. Las versiones anteriores de la app no pueden usar la configuración dinámica ni las funciones de configuración, sino que recurrirán a las reglas declaradas en el manifiesto. Tu App Link aún puede abrir correctamente tu app o recurrir a la Web de forma correcta para los usuarios de versiones anteriores de Android. En la mayoría de los casos, puedes implementar reglas dinámicas de forma segura sin afectar la experiencia del resto de tu base de usuarios.

Consideraciones para configurar reglas de filtrado de App Links dinámicos

Si configuras filtros de intents para usarlos con App Links dinámicos en Android 15 y versiones posteriores, ten en cuenta que las reglas de enrutamiento a nivel de la ruta definidas en tu archivo assetlinks.json del servidor no pueden expandir el alcance que estableciste de forma estática en las reglas del filtro de intents de tu archivo de manifiesto.

Por este motivo, te recomendamos que configures el alcance más amplio posible en los filtros de intents del manifiesto y, luego, utilices las reglas de assetlinks.json del servidor para realizar ajustes adicionales. Con esta configuración ideal, podrás agregar vínculos de aplicación nuevos de forma dinámica que se ajusten al amplio alcance establecido en el manifiesto.

Planifica la implementación de tus App Links

Para admitir App Links, se requiere una implementación en tu app, así como trabajo del servidor para configurar tu archivo assetlinks.json. Aquí se enumeran las tareas generales de preparación e implementación, con vínculos a otros recursos para obtener más detalles.

  • Planifica tus vínculos directos: Comienza con una evaluación de los vínculos directos que necesitas, los patrones de URL que usarán, cómo y cuándo los actualizarás, y la actividad o acción a la que deseas que se resuelva cada URL en tu app.
  • Admite vínculos dinámicos a la app: Brinda a los usuarios de los dispositivos Android más recientes la mejor experiencia posible. Aprovecha los vínculos dinámicos de la app para los usuarios de Android 15 o versiones posteriores.
  • Planifica tus reglas de filtro dinámico: Si usas Dynamic App Links, planifica cómo funcionarán tus reglas del servidor con las reglas definidas de forma estática en el manifiesto de tu app. Ten en cuenta que las reglas de filtro en tu archivo assetlinks.json no pueden expandir el alcance de los filtros del manifiesto de tu app. Debes planificar que tus filtros de manifiesto declaren el alcance más amplio posible y, luego, tus reglas del servidor pueden definir mejor esas reglas según sea necesario. Para obtener más información, consulta Cómo configurar reglas dinámicas.
  • Crea y prueba filtros de intents para tus vínculos: Declara tus vínculos directos en filtros de intents y prueba la coincidencia de patrones de URL y el control de intents entrantes. Para admitir los App Links dinámicos, ten en cuenta que es posible que debas mover algunas rutas de acceso detalladas a tu archivo JSON del servidor.
  • Lee datos de intents de App Links entrantes: Controla correctamente los intents de vínculos directos entrantes y resuélvelos en la actividad adecuada. La implementación de vínculos a la aplicación es la misma que la de los vínculos directos normales, que se explica en Cómo leer datos de intents entrantes.
  • Configura asociaciones de sitios web y reglas dinámicas: Para admitir App Links, debes configurar un archivo del servidor que se aloje en tu sitio web o dominio. Los dispositivos Android recuperarán este archivo para validar la implementación de los vínculos de apps con tu aplicación. Obtén más información aquí.
  • Prueba la verificación de vínculos de apps: Comprueba que el sistema Android pueda verificar automáticamente tus vínculos directos de forma correcta. Usa la depuración y las pruebas de extremo a extremo para verificar que tu configuración sea segura y funcione correctamente en todas las rutas de App Link verificadas.
  • Obtén información sobre las herramientas que puedes usar para configurar vínculos de la app, como Android Studio y Play Console. Más información aquí.