Configuración inicial de iOS

De un vistazo: La configuración inicial de la aplicación permite al marketer crear enlaces que enviarán a los usuarios existentes de la aplicación directamente a la aplicación. La configuración inicial también es un requisito previo para enlaces profundos y enlaces profundos diferidos.

Métodos de apertura de aplicaciones

Hay dos métodos de apertura de aplicaciones que deben implementarse para cubrir toda tu base de usuarios. El método utilizado depende de la versión de la plataforma móvil.

Los dos métodos e instrucciones para la implementación se describen en detalle en las siguientes secciones.

MétodoDescripciónVersiones de iOSProcedimiento
enlaces universalesAbre la aplicación móvil directamente en la actividad predeterminada. Los enlaces universales toman el formato de los enlaces web regulares (p. ej., https://yourbrand.onelink.me o https://www.yourbrand.com)iOS 9 y superior
  1. Obtén el ID del paquete de la aplicación y el ID del prefijo.
  2. Habilita los dominios asociados.
Esquema URIAbrir la aplicación directamente en función de la ruta de actividad especificada en el esquema URL.Todas las versiones de iOS
  1. Decidir sobre un esquema URI con el marketer.
  2. Habilita los dominios asociados.
  3. Pruebas

Procedimientos para enlaces universales de iOS

Getting the app bundle ID and prefix ID

  1. Inicia sesión en tu cuenta de desarrollador de Apple.
  2. En el menú izquierdo, selecciona Certificates, Identifiers & Profiles (Certificados, identificadores y perfiles).
  3. En Identifiers (Identificadores), selecciona App IDs (ID de aplicación).
  4. Haz clic en la aplicación correspondiente.
  5. Copia el ID de prefijo y el ID del paquete de aplicaciones.
  6. Indícale el prefijo y el ID del paquete de aplicaciones al marketer.
    El marketer los usará en el panel de control de AppsFlyer para registrar la aplicación.
    certs_apple_info!

Enabling associated domains

Para admitir dominios asociados en tu aplicación:

Follow the iOS instructions to add the associated domains entitlement to your app.

Configuring mobile apps to register approved domains

La configuración de aplicaciones móviles para registrar dominios aprobados tiene lugar dentro de Xcode. Requiere el subdominio OneLink que genera tu marketer.

Para configurar aplicaciones móviles y así registrar dominios aprobados:

  1. Obtén el subdominio OneLink de tu marketer.
  2. En Xcode, haz clic en tu proyecto.
  3. Haz clic en el objetivo del proyecto (consulta la captura de pantalla que sigue).
  4. Pasa a la pestaña Capabilities (Capacidades).
  5. Activa la opción Associated Domain (Dominio asociado).
  6. Agrega el subdominio que obtuviste de tu marketer.
    El formato es applinks:subdomain.onelink.me.

xcode-associated-domains!

📘

To associate a domain with your app, you need to have the associated domain file on your domain and the appropriate entitlement in your app. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer hosts the apple-app-site-association file.
When a user installs your app, the system attempts to download the associated domain file and verify the domains in your Associated Domains Entitlement.

Universal Link limitations

Cómo abrir las aplicaciones desde navegadores

Los enlaces universales solo funcionan cuando se hace clic en ellos. Por ejemplo, cuando se hace clic en un enlace en una página web o correo electrónico. Pegar el enlace en la barra de direcciones del navegador no hace enlaces profundos en la aplicación.

Subdominio de OneLink

Si bien el subdominio de OneLink se puede cambiar en cualquier momento, esto hace que todas las URL de OneLink existentes que emplean el subdominio original dejen de funcionar.

OneLink en aplicaciones de redes sociales

No todas las aplicaciones, incluidas las aplicaciones de redes sociales, son totalmente compatibles con los enlaces universales. Para conocer más detalles, consulta esta guía.

Otras limitaciones y problemas

Es posible que haya otras limitaciones con los enlaces universales. Visita la resolución de problemas de OneLink para conocer más detalles.

Procedimientos para el esquema URI

Los esquemas URI son una URL que lleva a los usuarios directamente a la aplicación móvil.

Cuando un usuario de una aplicación ingresa un esquema URI en el cuadro de la barra de direcciones del navegador, o hace clic en un enlace basado en un esquema URI, la aplicación se inicia y el usuario se conecta mediante enlaces profundos.

Siempre que un enlace universal no abra la aplicación, el esquema URI se puede usar como respaldo para abrir la aplicación.

Deciding on a URI scheme

Para decidir sobre un esquema URI:

  1. Contact the marketer.
  2. Elige un esquema de URI. Por ejemplo: yourappname://

📘

  • Usa un esquema URI que sea lo más exclusivo posible para tu aplicación y marca a fin de evitar la superposición casual con otras aplicaciones del ecosistema. La superposición con otras aplicaciones es un problema inherente en la naturaleza del protocolo del esquema URI.
  • El esquema URI no debe comenzar con http o https.
  • El esquema URI debe definirse de manera similar en Android e iOS.
  1. Envía el esquema URI al marketer, p. ej. afshopapp://mainactivity.

Adding URI scheme

Para agregar el esquema URI:

  1. En Xcode, abre el archivo de información plist de la aplicación.
  2. Agrega una entrada de tipos de URL.
  3. Expande las filas Tipo de URL y Elemento 0.
  4. Agrega un identificador exclusivo de la aplicación para el identificador de URL como valor.
    Lo mejor es seleccionar un identificador exclusivo que otras aplicaciones probablemente no utilicen.
  5. Haz clic con el botón derecho en Identificador de URL y selecciona Agregar fila > Esquemas URI.
  6. Configura el valor Elemento 0 en tu esquema único.

info_list_uri_schemes!

Prerequisites:

Un dispositivo iOS con la aplicación instalada. Asegúrate de que sea la fuente y la versión de la aplicación en la que hiciste cambios (e implementaste los enlaces universales y esquemas URI).

Testing the URI scheme:

  1. Comunícate con el marketer y obtén el enlace personalizado que creó.
  2. Envía la URL corta o larga que obtienes del marketer a tu teléfono. Puedes elegir cualquiera de las siguientes opciones:
    • Escanear el código QR con la cámara de tu teléfono o con la aplicación de escáner de QR.
    • Enviar el enlace por correo electrónico o por WhatsApp y abrirlo en tu teléfono
      .
  3. Haz clic en el enlace en tu dispositivo móvil. La aplicación debería abrirse en su pantalla de inicio.

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

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

URI scheme limitations

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 de tu paquete de aplicaciones, por ejemplo, com.company.app.

Para que OneLink pueda funcionar con iOS y Android, es importante que se defina el mismo esquema para ambas plataformas.

Cuando un 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 OK (la aplicación está instalada), AppsFlyer intenta abrir la aplicación usando 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 OK, pero la aplicación no está instalada, aparece un mensaje de error:

uri_cannot_open_page!