Enlaces universales y App Links

Este artículo describe cómo configurar los enlaces universales de Apple y los Android App Links.

Los enlaces universales de Apple y los Android App Links son mecanismos diseñados para proporcionar una transición fluida entre el contenido web y las aplicaciones móviles. Mientras que los enlaces universales son específicos de iOS, los Android App Links cumplen el mismo propósito para las aplicaciones Android.

Cómo funcionan los enlaces universales y los App Links

Los enlaces universales (iOS) y los App Links (Android) son enlaces web estándar (http://mydomain.com) que apuntan tanto a una página web como a un contenido dentro de una aplicación.

Cuando se abre un enlace universal o un App Link, el sistema operativo comprueba si alguna aplicación instalada está registrada para ese dominio. Si se encuentra una aplicación, se lanza inmediatamente sin cargar nunca la página web. Si no se encuentra ninguna aplicación, la URL web se carga en el navegador web predeterminado del usuario, que también podría estar configurado para redirigir a la App Store o Google Play Store respectivamente.

En pocas palabras, los enlaces universales permiten que un sitio web asocie sus páginas web con pantallas específicas de la aplicación, de modo que cuando un usuario hace clic en un enlace a una página web que corresponde a una pantalla de la aplicación, esta puede abrirse directamente (si está instalada actualmente).

Esta tabla describe las diferencias clave entre los enlaces universales y los vínculos profundos tradicionales:

Casos de uso

Los enlaces universales y los App Links se usan más comúnmente para Campaigns de correo electrónico, ya que los correos electrónicos pueden abrirse y hacer clic desde dispositivos de escritorio y móviles.

Algunos canales no funcionan bien con estos enlaces. Por ejemplo, las notificaciones push, los mensajes dentro de la aplicación y Content Cards deben usar vínculos profundos basados en esquema (mydomain://).

Requisitos previos

Para usar enlaces universales y App Links:

• Tu sitio web debe ser accesible a través de HTTPS
• Tu aplicación debe estar disponible en la App Store (iOS) o Google Play Store (Android)

Configuración de enlaces universales y App Links

Para que las aplicaciones admitan enlaces universales o App Links, tanto iOS como Android requieren que se aloje un archivo de permisos especial en el dominio del enlace. Este archivo contiene definiciones de qué aplicaciones pueden abrir enlaces de ese dominio y, para iOS, qué rutas pueden abrir estas aplicaciones:

• iOS: Archivo Apple App Site Association (AASA)
• Android: Archivo Digital Asset Links

Además de este archivo de permisos, hay definiciones codificadas de qué dominios de enlace la aplicación tiene permitido abrir que se configuran dentro de la aplicación:

• iOS: Se establece como “Associated Domains” en Xcode
• Android: Se define en el archivo AndroidManifest.xml de la aplicación

Esta asociación bidireccional dominio-aplicación es necesaria para que un enlace universal o App Link funcione y evita que cualquier aplicación secuestre enlaces de un dominio en particular o que cualquier dominio abra una aplicación en particular.

• ios
• android

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "JHGFJHHYX.com.facebook.ios",
        "paths": [
          "*"
        ]
      }
    ]
  }
}

Enlaces universales, App Links y seguimiento de clics

Nuestros socios de envío de correo electrónico, SendGrid y SparkPost, usan dominios de seguimiento de clics para envolver todos los enlaces e incluir parámetros de URL para el seguimiento de clics en los correos electrónicos de Braze.

Por ejemplo, un enlace como https://www.example.com se convierte en algo como https://links.email.example.com/uni/wf/click?upn=abcdef123456….

Para permitir que los enlaces de correo electrónico con seguimiento de clics funcionen como enlaces universales o App Links, necesitarás realizar alguna configuración adicional. Asegúrate de añadir el dominio de seguimiento de clics (links.email.example.com) como un dominio que la aplicación tiene permitido abrir. Además, el dominio de seguimiento de clics debe servir los archivos AASA (iOS) o Digital Asset Links (Android). Esto ayudará a garantizar que los enlaces de correo electrónico con seguimiento de clics funcionen sin problemas.

Si no quieres que cada enlace de seguimiento de clics sea un enlace universal o App Link, puedes especificar qué enlaces deben ser enlaces universales según el socio de envío de correo electrónico. Consulta las siguientes secciones para más detalles.

SendGrid

Para tratar un enlace de seguimiento de clics de SendGrid como un enlace universal:

1. Configura los valores de pathPrefix de tu AASA o AndroidManifest para que solo traten los enlaces con /uni/ en la ruta URL como enlaces universales.
2. Añade el atributo universal="true" a la etiqueta anchor (<a>) de tu enlace. Esto cambia la ruta URL del enlace envuelto para incluir /uni/.

Por ejemplo:

1
<a href=”https://www.example.com” universal="true">

3. Asegúrate de que tu aplicación está configurada para manejar los enlaces envueltos correctamente. Consulta el artículo de SendGrid sobre Resolving SendGrid Click Tracking Links y sigue los pasos para tu sistema operativo. Este artículo contiene código de ejemplo para iOS y Android.

Con esta configuración, los enlaces con /uni/ en la ruta URL funcionarán como enlaces universales, mientras que todos los demás enlaces funcionarán como enlaces web.

SparkPost

Para tratar un enlace de seguimiento de clics de SparkPost como un enlace universal, añade el siguiente atributo a la sección de atributos del editor de arrastrar y soltar para correo electrónico, o edita manualmente el HTML del enlace para incluir el siguiente atributo en la etiqueta anchor de tu enlace: data-msys-sublink="custom_path".

Esta ruta personalizada te permite tratar selectivamente las URL con ese valor como un enlace universal.

Por ejemplo:

1
<a href=”https://www.example.com” data-msys-sublink="open-in-app">

Luego, asegúrate de que tu aplicación está configurada para manejar la ruta personalizada correctamente. Consulta el artículo de SparkPost sobre Using SparkPost click tracking on deep links. Este artículo contiene código de ejemplo para iOS y Android.

Desactivar el seguimiento de clics enlace por enlace

Puedes desactivar el seguimiento de clics para enlaces específicos añadiendo código HTML a tu mensaje de correo electrónico para el editor HTML o a un bloque HTML para el editor de arrastrar y soltar.

SendGrid

Si tu proveedor de servicios de correo electrónico es SendGrid, usa el código HTML clicktracking=off de esta manera:

<a clicktracking=off href="[INSERT https LINK HERE]">click here</a>

SparkPost

Si tu proveedor de servicios de correo electrónico es SparkPost, usa el código HTML data-msys-clicktrack="0" de esta manera:

<a data-msys-clicktrack="0" href="[INSERT https LINK HERE]">click here</a>

Amazon SES

Si tu proveedor de servicios de correo electrónico es Amazon SES, usa el código HTML ses:no-track de esta manera:

<a ses:no-track href="[INSERT https LINK HERE]">click here</a>

Editor de arrastrar y soltar

Al usar el editor de arrastrar y soltar para correo electrónico, introduce tu código HTML como un atributo personalizado si tu enlace está adjunto a texto, un botón o una imagen.

Atributo personalizado para un enlace de texto

SendGrid

Selecciona lo siguiente para el atributo personalizado:

• Name: clicktracking
• Value: off

SparkPost

Selecciona lo siguiente para el atributo personalizado:

• Name: data-msys-clicktrack
• Value: 0

Atributo personalizado para un botón o imagen

SendGrid

Selecciona lo siguiente para el atributo personalizado:

• Name: clicktracking
• Value: off
• Type: Link

SparkPost

Selecciona lo siguiente para el atributo personalizado:

• Name: data-msys-clicktrack
• Value: 0
• Type: Link

Solución de problemas de enlaces universales con seguimiento de clics

Si tus enlaces universales no funcionan como se espera en tus correos electrónicos, como por ejemplo cuando el destinatario navega desde su aplicación de correo electrónico al navegador web antes de finalmente redirigir a la aplicación, consulta estos consejos para solucionar problemas con la configuración de tu enlace universal.

Verifica la ubicación del archivo de enlace

Asegúrate de que el archivo AASA (iOS) o el archivo Digital Asset Links (Android) está ubicado en el lugar correcto:

• iOS: https://click.tracking.domain/.well-known/apple-app-site-association
• Android: https://click.tracking.domain/.well-known/assetlinks.json

Es importante asegurarse de que estos archivos siempre sean accesibles públicamente. Si no puedes acceder a ellos, es posible que hayas omitido un paso en la configuración de enlaces universales para correo electrónico.

Verifica las definiciones de dominio

Asegúrate de que tienes las definiciones correctas para los dominios que tu aplicación tiene permitido abrir.

• iOS: Revisa los Associated Domains configurados en Xcode para tu aplicación (paso 1c). Comprueba que el dominio de seguimiento de clics está incluido en esa lista.
• Android: Abre la página de información de la aplicación (mantén presionado el icono de la aplicación y haz clic en ⓘ). Dentro del menú de información de la aplicación, localiza Open by default y tócalo. Esto debería mostrar una pantalla con todos los enlaces verificados que la aplicación tiene permitido abrir. Comprueba que el dominio de seguimiento de clics está incluido en esa lista.