Skip to content

Guía de vinculación en profundidad para iOS

Esta guía te ayuda a elegir la estrategia de vinculación en profundidad adecuada para tu aplicación iOS, en función del canal de mensajería que utilices y de si utilizas un proveedor de vínculos externo como Branch.

Para obtener más información sobre la implementación, consulta Vinculación en profundidad. Para solucionar problemas, consulta Solución de problemas de vinculación en profundidad.

Hay tres formas de gestionar los enlaces de los mensajes de Braze en tu aplicación para iOS. Cada una funciona de manera diferente y es adecuada para distintos canales y casos de uso.

Los vínculos profundos con esquema personalizado (por ejemplo, myapp://products/123) abren tu aplicación directamente en una pantalla específica. Son la opción más sencilla para canales en los que los enlaces no son modificados por terceros.

Utiliza vínculos profundos con esquema personalizado cuando:

  • Envías notificaciones push, mensajes dentro de la aplicación o Content Cards.
  • No necesitas que el enlace funcione si la aplicación no está instalada.
  • No necesitas seguimiento de clics (envoltura de enlaces del ESP de correo electrónico).

No utilices vínculos profundos con esquema personalizado cuando:

  • Envías correos electrónicos: los ESP envuelven los enlaces para el seguimiento de clics, lo que rompe los esquemas personalizados.
  • Necesitas que el enlace vuelva a una página web si la aplicación no está instalada.

Los enlaces universales (por ejemplo, https://myapp.com/products/123) son direcciones URL HTTPS estándar que iOS puede redirigir a tu aplicación en lugar de abrirlas en un navegador. Requieren una configuración del lado del servidor (un archivo AASA) y una configuración del lado de la aplicación (derecho de dominios asociados).

Utiliza enlaces universales cuando:

  • Envías correos electrónicos. Tu ESP envuelve los enlaces para el seguimiento de clics, por lo que los enlaces deben ser HTTPS.
  • Envías SMS u otros canales en los que los enlaces se envuelven o acortan.
  • Necesitas que el enlace vuelva a una página web cuando la aplicación no está instalada.
  • Utilizas un proveedor de vínculos externo como Branch o AppsFlyer.

No utilices enlaces universales cuando:

  • Solo necesitas vínculos profundos desde notificaciones push, mensajes dentro de la aplicación o Content Cards. Los esquemas personalizados son más sencillos.

“Abrir URL web dentro de la aplicación”

Esta opción abre una página web dentro de una WebView modal en tu aplicación. El SDK de Braze se encarga de todo mediante Braze.WebViewController, por lo que no es necesario escribir ningún código para gestionar las URL.

Utiliza “Abrir URL web dentro de la aplicación” cuando:

  • Quieres mostrar una página web (como una promoción o un artículo) sin salir de tu aplicación.
  • La URL es una página web HTTPS estándar, no un vínculo profundo a una pantalla específica de la aplicación.

No utilices “Abrir URL web dentro de la aplicación” cuando:

  • Necesitas navegar hasta una vista específica en tu aplicación. En su lugar, utiliza un esquema personalizado o un enlace universal.
  • La página web requiere autenticación o tiene encabezados de política de seguridad de contenido que bloquean la incrustación.

“Abrir URL web dentro de la aplicación”

Cuándo necesitas un archivo AASA

Solo se requiere un archivo Apple App Site Association (AASA) cuando utilizas enlaces universales. Le indica a iOS qué URL puede gestionar tu aplicación.

Necesitas un archivo AASA cuando:

  • Envías vínculos profundos en campañas de correo electrónico (porque los ESP envuelven los vínculos en URL de seguimiento de clics HTTPS).
  • Envías vínculos profundos en campañas de SMS (porque los vínculos pueden acortarse a direcciones URL HTTPS).
  • Utilizas Branch, AppsFlyer u otro proveedor de vínculos (porque utilizan sus propios dominios HTTPS).
  • Utilizas enlaces universales desde notificaciones push, mensajes dentro de la aplicación o Content Cards (menos habitual, pero posible con forwardUniversalLinks = true).

No necesitas un archivo AASA cuando:

  • Solo utilizas vínculos profundos con esquema personalizado (por ejemplo, myapp://) desde notificaciones push, mensajes dentro de la aplicación o Content Cards.
  • Utilizas la opción Abrir URL web dentro de la aplicación.

Para obtener instrucciones sobre la configuración de AASA, consulta Enlaces universales y enlaces de aplicaciones.

Cuándo necesitas código de aplicación para gestionar enlaces

El método delegado que implementes dependerá del tipo de enlace que estés utilizando:

Usar Branch con Braze

Si utilizas Branch como proveedor de vínculos, tu configuración requiere algunos pasos adicionales más allá de la configuración estándar de enlaces universales:

  1. SDK de Branch: Integra el SDK de Branch siguiendo la documentación de Branch.
  2. Dominios asociados: Añade tu dominio de Branch (por ejemplo, applinks:yourapp.app.link) en Xcode, en Signing & Capabilities.
  3. BrazeDelegate: Implementa braze(_:shouldOpenURL:) para redirigir los enlaces de Branch al SDK de Branch en lugar de dejar que Braze los gestione directamente.
  4. Reenviar enlaces universales: Establece configuration.forwardUniversalLinks = true en tu configuración del SDK de Braze.

Para obtener detalles sobre la implementación y orientación sobre la depuración, consulta Branch para la vinculación en profundidad.
New Stuff!