Guía de enlaces profundos de OneLink™

Los esquemas URI son URL que llevan a los usuarios directamente a actividades de las aplicaciones móviles. En Android, los esquemas URI también pueden usarse para establecer enlaces profundos entre los usuarios y actividades específicas.

Si los usuarios de una aplicación ingresan un esquema URI en el cuadro de la barra de direcciones de un navegador, la aplicación se inicia y los usuarios se conectan mediante enlaces profundos. Lo mismo sucede cuando los usuarios hacen clic en enlaces que incluyen esquemas URI.

AppsFlyer es compatible con la funcionalidad de enlaces profundos con esquema URI a través de las URL OneLink, mediante el parámetro af_dp.

Configurar los esquemas URI

La configuración de OneLink para el esquema URI debe hacerse en colaboración entre el marketer y el desarrollador.

La configuración del esquema URI se produce en dos lugares:

1. En la página de plantilla de OneLink
2. En la aplicación

El esquema URI en las instrucciones a continuación es greatapp://.

Para los marketers

Para los desarrolladores

<activity android:name="com.appsflyer.sample.Activity">    
      <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="greatapp" />
      </intent-filter>
</activity>

<activity android:name="com.appsflyer.sample.Activity1">    
      <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="greatapp" />
        <data android:host="activity1" />
      </intent-filter>
</activity>

<activity android:name="com.appsflyer.sample.Activity2">    
      <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="greatapp" />
        <data android:host="activity2" />
      </intent-filter>
</activity>

Probar los esquemas URI 

Para probar el esquema URI, crea un enlace de atribución personalizado.

1. Genera un enlace de atribución personalizado desde el OneLink creado.
2. Instala la aplicación en tu dispositivo.
3. Envía el enlace de atribución al dispositivo.
4. Haz clic en el enlace.

Si el enlace no abre la aplicación, agrega el parámetro af_force_deeplink=true para personalizar el enlace de atribución. Por ejemplo:

https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true 

Limitaciones

Ni Apple ni Google exigen nombres exclusivos para los esquemas de aplicaciones. Elige un nombre de esquema exclusivo para tu marca a fin de evitar conflictos de esquemas entre las distintas aplicaciones. Un buen nombre de esquema podría ser el ID del paquete de la aplicación, es decir com.company.app.

Para que OneLink pueda funcionar con iOS y Android, es importante que se defina el mismo esquema para ambas plataformas. A continuación, presentamos las instrucciones para iOS y Android.

El método de enlaces universales establece enlaces entre una aplicación móvil de iOS y un sitio web/dominio asociados. En esta guía, te mostramos cómo crear y usar los enlaces universales con OneLink.

La configuración de enlaces universales con OneLink es un proceso de dos partes:

1. Configuración de OneLink
2. Configuración de aplicaciones móviles para registrar dominios aprobados

Configuración de OneLink

La configuración de OneLink para enlaces universales debe hacerse en colaboración entre el marketer y el desarrollador.

Para los desarrolladores

Para los marketers

Una vez finalizados los pasos anteriores, cada vez que los usuarios hacen clic en una URL de dominio autorizado (cuando la aplicación ya está instalada en el dispositivo), iOS inicia la aplicación asociada como su actividad predeterminada.

Cómo mantener el esquema URI

Aún con iOS9+, es importante implementar un esquema URI. Algunos navegadores o aplicaciones no son compatibles con enlaces universales y recurren al método de esquema URI como opción de reserva. Consulta nuestra guía sobre cómo configurar el esquema URI para enlaces profundos.

Limitaciones de los enlaces universales

Los enlaces universales tienen algunas limitaciones que debes tener en cuenta.

Este método, que se introdujo con Android 6.0, es la versión de Google de los enlaces universales y tiene beneficios similares. Para obtener más información, consulta nuestro artículo sobre enlaces de aplicaciones.

Configuración de los enlaces de aplicaciones de Android

La configuración de OneLink para los enlaces de aplicaciones de Android debe hacerse en colaboración entre el marketer y el desarrollador.

Para los desarrolladores

Para los marketers

Enlaces profundos en actividades específicas

Los enlaces de aplicaciones de Android te permiten establecer enlaces profundos entre los usuarios y actividades específicas.

<activity android:name="com.king.candycrushsaga.DeepLink">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
            android:host="demo.onelink.me"
            android:pathPrefix="/ST6c/c0aae4f" />
    </intent-filter>
</activity>

<activity android:name="com.appsflyersmaple.guide.DeepLink2">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
            android:host="demo.onelink.me"
            android:pathPrefix="/ST6c/6f0b5993" />
    </intent-filter>
</activity>

<activity android:name="com.king.candycrushsaga.DeepLink3">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
            android:host="demo.onelink.me"
            android:pathPrefix="ST6c/b40bder4" />
    </intent-filter>
</activity>
      

Cómo mantener el esquema URI

Es importante implementar un esquema URI, ya que algunos dispositivos Android aún no son compatibles con enlaces de aplicaciones y recurren al método de esquema URI como opción de reserva. Consulta nuestra guía sobre cómo configurar el esquema URI para enlaces profundos.

Limitaciones de los enlaces de aplicaciones

Los enlaces de aplicaciones tienen algunas limitaciones que debes tener en cuenta.

No es necesario realizar ninguna acción especial.

Para que el nuevo OneLink funcione, el archivo AASA de la aplicación debe estar actualizado. Después de crear una plantilla de OneLink nueva, envía una versión nueva a la tienda. Solo los usuarios de iOS que actualizaron a la nueva versión pueden activar una URL de OneLink incorporada en la plantilla nueva.

1. Después de crear una plantilla nueva de OneLink, copia el nuevo ID de OneLink generado para la plantilla.
2. Copia el fragmento de XML en la parte inferior de la sección de enlaces de aplicaciones y agrégalo a tu archivo AndroidManifest.xml que está dentro de la intención en la que deseas establecer el enlace profundo, además de las intenciones anteriores.
3. Lanza la nueva versión en la tienda. Solo los usuarios de Android que hayan actualizado a la nueva versión podrán activar una URL de OneLink incorporada en la plantilla nueva.

1. Instala e inicia la aplicación en tu dispositivo (o en el simulador de iPhone en iOS).
   [Si la aplicación está recién instalada, lleva la aplicación al fondo y tráela de vuelta al primer plano dos o más veces].
2. Prepara una URL de OneLink para la aplicación, que tenga el parámetro af_dp con una ruta de esquema válida (por ejemplo, "greatapp://cars").
3. En el dispositivo probado, pega el enlace en un mensaje de correo electrónico, en las notas, en un SMS, en un generador de códigos QR, etc.
4. Haz clic en el enlace.

Resultado esperado: la aplicación debe abrirse en la actividad solicitada señalada por el parámetro af_dp.

1. Cierra sesión para salir de la aplicación.
2. Elimina la aplicación.
3. Prepara una URL de OneLink para la aplicación, que tenga el parámetro af_dp (u otro) con una ruta de esquema válida (por ejemplo, "greatapp://cars").
4. En el dispositivo probado, pega el enlace en un mensaje de correo electrónico, en las notas, en un SMS, en un generador de códigos QR, etc.
5. Haz clic en el enlace.
6. Instala e inicia la aplicación en tu dispositivo (o en el simulador de iPhone en iOS).

Resultado esperado: la aplicación captura el enlace (datos de conversión) en el primer inicio. Se extrae el parámetro af_dp y se redirige al usuario dentro de la aplicación según el valor del parámetro af_dp.

1. Instala e inicia la aplicación en tu dispositivo (o en el simulador de iPhone en iOS).
   [Si la aplicación está recién instalada, lleva la aplicación al fondo y tráela de vuelta al primer plano dos o más veces].
2. Prepara una URL de OneLink para la aplicación, que tenga el parámetro af_dp (u otro) con una ruta de esquema válida (por ejemplo, "greatapp://cars").
3. iOS: pega el enlace en Notes, iMessage o en un mensaje de correo electrónico usando Apple Mail Client.
   Android: pega el enlace en un mensaje de correo electrónico, en Chrome, en un SMS, en un generador de códigos QR, etc. Importante: no uses Slack, Facebook ni ninguna otra aplicación de red social para hacer clic en el enlace.
4. Haz clic en el enlace.

Resultado esperado: la aplicación se abre inmediatamente sin redireccionamiento a través del navegador. Se extrae el parámetro af_dp y se redirige al usuario dentro de la aplicación según el valor del parámetro af_dp.

Sí, pero solo en parte. Aunque OneLink es una herramienta integral para los enlaces profundos, las URL regulares específicas de una aplicación también pueden establecer enlaces profundos con los usuarios que utilizan el esquema URI. En efecto, esto significa que puedes usar enlaces profundos en aplicaciones de Android si simplemente agregas el parámetro af_dp a un enlace de atribución regular de AppsFlyer.
Los enlaces universales, que constituyen el método disponible de enlaces profundos para más del 98% de los usuarios de iOS, solo pueden activarse mediante OneLink y no a través de enlaces de atribución regulares de plataformas únicas.

Desafortunadamente, sí.
Las aplicaciones de redes sociales tratan los enlaces profundos de publicaciones virales de diferentes maneras, lo que, a menudo, afecta la experiencia del usuario. La solución alternativa que AppsFlyer recomienda para el diagnóstico y el redireccionamiento de dispositivos a través de OneLink es mediante páginas de aterrizaje, tal como se explica en la guía de Instancias de redireccionamiento de OneLink.

Para establecer enlaces profundos, existe otra solución alternativa, que puede usarse en casos en los que el enlace universal o el enlace de aplicación está roto debido a la aplicación host, p. ej., las historias de Instagram con OneLink. La solución es forzar el uso de un esquema URI para establecer enlaces profundos.

1. Agrega el parámetro af_dp a OneLink y especifica la ruta a la actividad vinculada mediante el enlace profundo (más detalles).

2. Agrega &af_force_deeplink=true al enlace de atribución para forzar el uso de af_dp

Esta solución alternativa funciona bien para los usuarios activos, es decir, los usuarios que tienen la aplicación instalada en sus dispositivos. Sin embargo, en iOS, los usuarios de Safari que no tengan la aplicación instalada reciben un mensaje de error de sistema y, luego, se los redirige a la opción de reserva definida.

Sí... y no. af_dp puede contener un valor URI, y cualquier parámetro puede transferirse como parte de la ruta del URI, por ejemplo,  af_dp=greatapp%3A%2F%2Fparam1%2Fparam2 (greatapp://param1/param2).

Lo que es más simple, puedes agregar cualquier parámetro al enlace de atribución después del carácter "?".

Sin embargo, NO se recomienda la concatenación de parámetros al valor de af_dp después de "?". Es posible que los parámetros se descarten y no estén disponibles a través de los datos de conversión o de otras API.
Un mal ejemplo sería: af_dp=greatapp%3A%2F%2F%3Fparam1%3Da%26param2%3Db (greatapp://?param1=a&param2=b).

Esto significa que la integración del SDK para enlaces profundos no se completó completamente. Falta el método continueUserActivity en AppDelegate y debe invocarse.

Esto generalmente ocurre como resultado de un código dentro de la aplicación que efectúa un redireccionamiento a un navegador cuando un enlace https inicia la aplicación.

En iOS 9 y 10 (no en iOS 11), hay una opción para ignorar los enlaces profundos. Cuando se abre una aplicación mediante enlaces universales, iOS muestra un botón en la parte superior derecha del dispositivo que configura ese enlace para que se abra sin enlaces profundos.

Para restablecer esta configuración, toca durante un momento el enlace en tu dispositivo con iOS hasta que aparezca el siguiente menú emergente:

Selecciona Abrir en tu aplicación (p. ej., abrir en LoginBox).
Ahora, el enlace profundo está restablecido.

Toqué durante un momento el enlace, pero no veo la opción "Abrir en tu aplicación".

• Las aplicaciones de iOS se desarrollan con un archivo de aprovisionamiento (similar a una licencia). Este archivo se genera en la consola para desarrolladores de Apple y debe estar habilitado para enlaces universales.
• En Xcode, asegúrate de que la opción Dominios asociados esté activada en la pestaña Capacidades e incluya el dominio de OneLink para la aplicación.
  
• Asegúrate de que el id. del equipo de la aplicación coincida con el que se introdujo en la página de configuración de OneLink.

Elimina la aplicación, vuelve a instalarla y ejecútala de nuevo. Si continúa el problema, prueba a agregar otra fila en Associate Domains (Asociar dominios) (para que cambie). A continuación, elimina la aplicación y repite el proceso. También asegúrate de que tu OneLink tenga el mismo dominio que el configurado en la aplicación.

Sí, te entendemos. Si todo lo anterior no resolvió el problema, intenta generar nuevamente los archivos de aprovisionamiento para tu aplicación. Descárgalos una vez más y haz doble clic para instalarlos en Xcode.
También puedes probar a eliminar la aplicación y volver a instalarla con una versión avanzada.

iOS 11.2 y todas las revisiones posteriores tienen un error que, a veces, impide establecer enlaces profundos a través de enlaces universales.

Aparentemente, el archivo apple-app-site-association, que se usa para abrir aplicaciones con enlaces universales y se descarga automáticamente con cualquier instalación de aplicaciones de iOS, a veces, produce un error en la descarga con instalaciones de aplicaciones de dispositivos que ejecutan iOS 11.2 y versiones superiores. Sin este archivo en el dispositivo de iOS, los enlaces universales no pueden abrir directamente las aplicaciones.

Si observas este problema mientras realizas pruebas de enlaces profundos, desinstala la aplicación, reinicia tu dispositivo iOS (que se encuentra en la lista blanca) y vuelve a instalar la aplicación. ¿No fue de ayuda? Inténtalo de nuevo.

Aún no está claro qué tan generalizado realmente es este problema esporádico, aunque se ha reproducido en varios dispositivos iPhone con el sistema operativo iOS 11.2. Esperamos que Apple resuelva este error pronto, ya que puede afectar los enlaces profundos de más de 2/3 de sus usuarios de iOS.

Nota: Puedes hacer clic en el botón Seguir que se encuentra en la parte superior de la pantalla para recibir actualizaciones cuando este problema se solucione o cuando se actualice este artículo.

Los usuarios que optan por la exclusión afectan la correcta atribución y recolección de datos. Aquí se muestra por qué impiden el funcionamiento correcto del mecanismo de enlaces profundos y cómo se puede solucionar este problema.

Con los enlaces de aplicaciones o enlaces universales, existe una diferencia en la respuesta de onAppOpenAttribution según el tipo de OneLink que se use.

Tanto para iOS como para Android, cuando se usa la versión corta de OneLink, los datos de conversión constituyen un mapa estructurado de todos los parámetros incluidos en el enlace:

Ejemplo:

{
  af_dp: "superapp://Deeplink",
  pid: "media_source_name"
  c: "campaign_name",
  link: "https://abcd.onelink.me/12ab/12ab34c"
  is_retargeting: true
}

Por otro lado, la versión larga de OneLink produce un mapa con un par único de clave-valor que contiene el OneLink completo.

{
  "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
}

La respuesta para el OneLink corto está bien estructurada y es más fácil de analizar. Por lo tanto, te recomendamos que uses la versión corta de OneLink.