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.

Cuando un enlace OneLink que tiene af_force_deeplink=true se abre en iOS 12.3.1, se aplica la siguiente lógica:

• Se muestra una ventana de diálogo donde se le pregunta al usuario si la aplicación está instalada:
  • Si el usuario elige Aceptar (la aplicación está instalada), AppsFlyer intenta abrir la aplicación mediante el esquema URI.
  • Si el usuario elige Cancelar (la aplicación no está instalada), AppsFlyer lo redirige a la tienda de aplicaciones.
  • Si el usuario elige Aceptar, pero la aplicación no está instalada, aparece un mensaje de error:
    

    

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.

Actualmente, no se admiten enlaces profundos mediante esquemas URI en dispositivos Amazon.

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

 func onConversionDataReceived(_ installData: [AnyHashable: Any]) {
  //Handle Conversion Data (Deferred Deep Link)
  }
  
  func onConversionDataRequestFailure(_ error: Error?) {
    //    print("\(error)")
  }
  
  func onAppOpenAttribution(_ attributionData: [AnyHashable: Any]) {
    //Handle Deep Link Data
    
  }
  
  func onAppOpenAttributionFailure(_ error: Error?) {
  }
// Reports app open from a Universal Link for iOS 9 or later
  func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
    AppsFlyerTracker.shared().continue(userActivity, restorationHandler: restorationHandler)
    return true
  }

  // Reports app open from deep link from apps which do not support Universal Links (Twitter) and for iOS8 and below
  func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
    AppsFlyerTracker.shared().handleOpen(url, sourceApplication: sourceApplication, withAnnotation: annotation)
    return true
  }

  // Reports app open from deep link for iOS 10 or later
  func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    AppsFlyerTracker.shared().handleOpen(url, options: options)
    return true
  }
  

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
	AppsFlyerTracker.shared().continue(userActivity, restorationHandler: nil)
	return true
}

-(void)onConversionDataReceived:(NSDictionary*) installData {
  //Handle Conversion Data (Deferred Deep Link)
  
}

-(void)onConversionDataRequestFailure:(NSError *) error {
  
  NSLog(@"%@",error);
}


- (void) onAppOpenAttribution:(NSDictionary*) attributionData {
  
  //Handle Deep Link
}

- (void) onAppOpenAttributionFailure:(NSError *)error {
  NSLog(@"%@",error);
}

// Reports app open from a Universal Link for iOS 9 or above
- (BOOL) application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> *restorableObjects))restorationHandler {
    [[AppsFlyerTracker sharedTracker] continueUserActivity:userActivity restorationHandler:restorationHandler];
    return YES;
  }

  // Reports app open from deep link from apps which do not support Universal Links (Twitter) and for iOS8 and below
  - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation {
    [[AppsFlyerTracker sharedTracker] handleOpenURL:url sourceApplication:sourceApplication withAnnotation:annotation];
    return YES;
  }
  // Reports app open from deep link for iOS 10
  - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
  options:(NSDictionary *) options {
    [[AppsFlyerTracker sharedTracker] handleOpenUrl:url options:options];
    return YES;
  }

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

AppsFlyerLib.getInstance().sendDeepLinkData(this); 

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.

No puedes eliminar una plantilla de OneLink. No recomendamos eliminar plantillas de OneLink porque podría afectar las campañas activas. En lugar de eso, fíjate si puedes cambiar la configuración de la plantilla. Si deseas eliminar la plantilla de OneLink de todos modos, comunícate con tu gerente de atención al cliente o envíanos un mensaje de correo electrónico a hello@appsflyer.com.

Sí, pero si cambias el subdominio de OneLink, es posible que dejen de funcionar los enlaces profundos y los enlaces personalizados. Siempre es mejor crear una nueva configuración de OneLink y enlaces personalizados, y dejar de usar de a poco la configuración anterior de OneLink y los enlaces personalizados que dependen de ella.

Cómo cambiar el subdominio de OneLink

1. Si deseas cambiar el subdominio de OneLink, puedes hacerlo en la configuración de la plantilla de OneLink.
2. Actualiza los enlaces personalizados que dependen de la configuración de OneLink:
   1. Ve a Gestión de enlaces personalizados.
   2. Haz clic en el enlace que quieres actualizar.
   3. No hagas ningún cambio, simplemente haz clic en Actualizar enlace en la parte inferior de la página.
3. Actualiza tu configuración de Android: consulta la sección sobre configuración de enlaces de aplicaciones Android, específicamente la parte acerca de agregar filtros de intención a las actividades en AndroidManifest.xml.
4. Actualiza tu configuración de iOS: consulta la sección sobre configuración de enlaces universales, específicamente la parte acerca de configurar dominios aprobados en XCode.
5. Publica ambas aplicaciones en las tiendas de aplicaciones.

Los enlaces profundos no funcionan para los usuarios con versiones anteriores de la aplicación, antes de los cambios al subdominio de OneLink. Por este motivo, necesitas publicar las aplicaciones en las tiendas de aplicaciones después de cambiar el subdominio de OneLink.

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 (eliminada de iOS 11), hay una opción para ignorar los enlaces profundos. Cuando se abre una aplicación mediante enlaces universales, iOS muestra un enlace de derivación para evitar enlaces profundos en la parte superior derecha que configura ese enlace para que se abra sin enlaces profundos.

Se trata de una configuración específica de cada aplicación que se guarda en cada dispositivo de forma individual. La configuración se conserva incluso si eliminas la aplicación y la vuelves a instalar. La única manera de revertir esto es volver a activar el comportamiento de enlaces universales para esa aplicación en tu dispositivo. Existen un par de maneras de hacer esto:

Para restablecer esta configuración, pega el enlace OneLink en Notes o iMessage (o alguna otra aplicación que sea compatible con enlaces universales) y mantenlo pulsado. Verás una opción de "Abrir en [aplicación]". Selecciónala y, después de eso, volverán a funcionar todos los enlaces universales para esa aplicación.

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.