Configuration initiale d'iOS

En bref : la configuration initiale de l'app permet au marketeur de créer des liens qui enverront les utilisateurs existants directement dans l'app. La configuration initiale est également une condition préalable pour le deep linking et le deep linking différé.

Méthodes d'ouverture des apps

Il y a deux méthodes d'ouverture d'app qui doivent être implémentées pour couvrir l'ensemble de votre base d'utilisateurs. La méthode utilisée dépend de la version de la plateforme mobile.

Les deux méthodes et instructions de mise en œuvre sont décrites en détail dans les sections suivantes.

MéthodeDescriptionVersions iOSProcédure
liens universelOuvre l'app mobile directement sur l'activité par défaut. Les liens universels ont le même format que les liens web classiques (ex : https://yourbrand.onelink.me or https://www.yourbrand.com)iOS 9 et supérieure
  1. Récupérer l'ID de bundle et l'ID de préfixe de l'app.
  2. Activer les domaines associés.
Schéma d'URIOuvre directement l'app en fonction du chemin d'activité spécifié dans le schéma d'URI.Toutes les versions iOS
  1. Définir un schéma d'URI avec le marketeur.
  2. Activer les domaines associés.
  3. Test

Procédures pour les liens universels iOS

Getting the app bundle ID and prefix ID

  1. Connectez-vous à votre compte Apple Developer
  2. Dans le menu de gauche, sélectionnez Certificats, identifiants et profils.
  3. Dans Identifiants, sélectionnez ID d'app.
  4. Cliquez sur l'application concernée.
  5. Copiez l'ID de préfixe et l'ID de bundle de l'app.
  6. Transmettez l'ID de préfixe et l'ID de bundle de l'app à votre marketeur.
    Le marketeur l'utilisera dans le tableau de bord AppsFlyer pour enregistrer l'app.
    certs_apple_info!

Enabling associated domains

Pour prendre en charge les domaines associés à votre app :

Suivez les instructions d'iOS pour les domaines associés.

Configuring mobile apps to register approved domains

La configuration des apps mobile pour enregistrer les domaines approuvés se passe dans Xcode. Elle requiert le sous-domaine OneLink que votre marketeur a généré.

Pour configurer les applications mobile afin d'enregistrer les domaines approuvés :

  1. Récupérez le sous-domaine OneLink auprès de votre marketeur.
  2. Dans Xcode, cliquez sur votre projet
  3. Cliquez sur la cible du projet (voir la capture d'écran qui suit).
  4. Ouvrez l'onglet Capacités.
  5. Activez Domaine associé.
  6. Ajoutez le sous-domaine que vous a transmis votre marketeur.
    Le format est 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

Ouverture des apps depuis les navigateurs

Les liens universels fonctionnent uniquement lorsque l'on clique dessus. Par exemple, on peut cliquer sur un lien sur une page Web dans un email. Le fait de coller le lien dans la barre d'adresse du navigateur ne permet pas d'être redirigé vers l'app via un Deep Link.

Sous-domaine du OneLink

Bien que le sous-domaine du OneLink puisse être modifié à tout moment, cette opération rend inopérantes toutes les URL OneLink utilisant le sous-domaine d'origine.

OneLink dans les apps des réseaux sociaux

Certaines apps, dont celles appartenant à certains réseaux sociaux, ne prennent pas entièrement en charge les liens universels. Pour obtenir plus d'informations, reportez-vous à ce guide.

Autres limitations et problèmes

Il peut exister d'autres restrictions concernant les liens universels. Veuillez consulter ledépannage OneLink pour en savoir plus.

Procédures pour le schéma d'URI

Les schémas d'URI sont des URL menant les utilisateurs directement à l'app mobile.

Lorsque l'utilisateur d'une app saisit un schéma d'URI dans la barre d'adresse d'un navigateur, ou clique sur un lien basé sur un schéma d'URI, l'app se lance et l'utilisateur suit un deep link.

Lorsqu'un lien universel ne parvient pas à ouvrir une application, le schéma d'URI peut être utilisé en solution de secours pour l'ouverture.

Deciding on a URI scheme

Pour choisir un schéma d'URI :

  1. Contact the marketer.
  2. Choisissez un schéma d'URI. Par exemple : yourappname://

📘

  • Utilisez un schéma d'URI le plus particulier possible pour votre app et votre marque afin d'éviter les répétitions avec d'autres apps de l'écosystème. Les doublons entre applications est un problème qui est inhérent au protocole du schéma URI.
  • Le schéma d'URI ne doit pas commencer par http ou https.
  • Le schéma d'URI doit être défini de manière similaire sur Android et iOS.
  1. Envoyez le schéma d'URI au marketeur, par exemple afshopapp://mainactivity.

Adding URI scheme

Pour ajouter le schéma d'URI :

  1. Sur Xcode, ouvrez le fichier d'informations de l'application (plist).
  2. Ajoutez une entrée Types d'URL.
  3. Développez les lignes Type d'URL et Élément 0.
  4. Ajoutez un identifiant unique pour l'identifiant URL de l'application sous forme de valeur. Il est préférable de choisir un identifiant unique qui ne risque pas d'être utilisé par d'autres applications.
  5. Faites un clic droit sur Identifiant d'URL et sélectionnez Ajouter une ligne > Schémas d'URI.
  6. Définissez la valeur de Élément 0 d'après votre schéma unique.

info_list_uri_schemes!

Prerequisites:

Un appareil iOS avec l'app installée. Vérifiez que c'est bien l'app d'origine (et la version) à laquelle vous avez apporté des modifications (et implémenté des liens universels et des schémas d'URI).

Testing the URI scheme:

  1. Contactez le marketeur et obtenez le lien personnalisé qu'il a créé.
  2. Envoyez l'URL courte ou longue que le marketeur vous transmet sur votre téléphone. Vous pouvez soit :
    • Scanner le code QR avec la caméra de votre téléphone ou bien l'app QR scanner.
    • Vous envoyer le lien par e-mail ou par WhatsApp, et l'ouvrir sur votre téléphone
      .
  3. Cliquez sur le lien de votre appareil mobile. L'app devrait s'ouvrir sur son écran d'accueil.

Si le lien n'ouvre pas l'app, ajoutez le paramètre af_force_deeplink=true au lien d'attribution personnalisé. Par exemple :

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

URI scheme limitations

Ni Apple ni Google n'appliquent de nomenclature pour les schémas d'app. Choisissez un nom de schéma propre à votre marque pour éviter les conflits entre les différentes apps. Un bon nom de schéma peut correspondre à l'ID de groupe de votre app, par exemple com.company.app

Pour permettre à OneLink de fournir à la fois iOS et Android, il est important que le même schéma soit défini pour les deux plateformes.

Quand un OneLink comprenant af_force_deeplink=true est ouvert dans iOS 12.3.1, la logique suivante s'applique :

  • Une boîte de dialogue s'affiche demandant à l'utilisateur si l'application s'est installée :
    • Si l'utilisateur choisit OK (l'app est installée), AppsFlyer tentera d'ouvrir l'app à l'aide du schéma d'URI.
    • Si l'utilisateur choisit Annuler (l'app n'est pas installée), AppsFlyer redirigera l'utilisateur vers l'app store.
    • Si l'utilisateur choisit OK mais que l'application n'est pas installée, un message d'erreur s'affichera :

uri_cannot_open_page!