Liens universels et liens vers les applications

Les liens universels Apple et les liens vers les applications Android sont des mécanismes conçus pour assurer une transition fluide entre les contenus web et les applications mobiles. Alors que les liens universels sont spécifiques à iOS, les liens d’application Android ont la même fonction pour les applications Android.

Comment fonctionnent les liens universels et les liens applicatifs ?

Les liens universels (iOS) et les liens d’application (Android) sont des liens web standard (http://mydomain.com) qui pointent à la fois vers une page web et vers un élément de contenu à l’intérieur d’une application.

Lorsqu’un lien universel ou App Link est ouvert, le système d’exploitation vérifie si une application installée est enregistrée pour ce domaine. Si une application est trouvée, elle est lancée immédiatement sans jamais charger la page web. Si aucune application n’est trouvée, l’URL web est chargée dans le navigateur web par défaut de l’utilisateur, qui pourrait également être configuré pour rediriger vers l’App Store ou le Google Play Store respectivement.

En clair, les liens universels permettent à un site web d’associer ses pages web à des écrans d’application spécifiques. Ainsi, lorsqu’un utilisateur clique sur un lien vers une page web correspondant à un écran d’application, l’application peut être ouverte directement (si l’application est déjà installée).

Ce tableau présente les principales différences entre les liens universels et les liens profonds traditionnels :

Cas d’utilisation

Les liens universels et les App Links sont le plus souvent utilisés pour les campagnes d’e-mail, car les e-mails peuvent être ouverts et cliqués aussi bien depuis un ordinateur de bureau que depuis un appareil mobile.

Certains canaux ne fonctionnent pas bien avec ces liens. Par exemple, les notifications push, les messages in-app et les cartes de contenu doivent utiliser des liens profonds basés sur des schémas (mydomain://).

Conditions préalables

Pour utiliser les liens universels et les liens applicatifs :

• Votre site web doit être accessible via HTTPS
• Votre application doit être disponible sur l’App Store (iOS) ou le Google Play Store (Android).

Mise en place de liens universels et d’App Links

Pour que les apps prennent en charge les liens universels ou App Links, iOS et Android exigent qu’un fichier d’autorisations spécial soit hébergé dans le domaine du lien. Ce fichier contient les définitions des apps capables d’ouvrir les liens de ce domaine et, pour iOS, les chemins que ces apps sont autorisées à ouvrir :

• iOS : Dossier de l’Apple App Site Association (AASA)
• Android : Fichier de liens de ressources numériques

En plus de ce fichier de permissions, il existe des définitions codées en dur des domaines de liens que l’application est autorisée à ouvrir et qui sont configurées au sein de l’application :

• iOS : Définir comme “Domaines associés” dans Xcode
• Android : Défini dans le fichier AndroidManifest.xml de l’application

Cette association domaine-app en deux parties est nécessaire pour qu’un lien universel ou App Link fonctionne et empêche toute app de détourner les liens d’un domaine particulier ou tout domaine d’ouvrir une app particulière.

• ios
• android

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

Liens universels, App Links et suivi des clics

Nos partenaires d’envoi d’e-mails, SendGrid et SparkPost, utilisent des domaines de suivi des clics pour envelopper tous les liens et inclure des paramètres d’URL pour le suivi des clics dans les e-mails de Braze.

Par exemple, un lien comme https://www.example.com devient quelque chose comme https://links.email.example.com/uni/wf/click?upn=abcdef123456….

Pour permettre aux liens d’e-mail avec suivi des clics de fonctionner comme des liens universels ou des App Links, vous devrez effectuer quelques configurations supplémentaires. Veillez à ajouter le domaine de suivi des clics (links.email.example.com) en tant que domaine que l’application est autorisée à ouvrir. En outre, le domaine de suivi des clics doit servir les fichiers AASA (iOS) ou Digital Asset Links (Android). Cela vous permettra de vous assurer que les liens d’e-mail avec suivi des clics fonctionnent de façon fluide/sans heurts/de façon homogène.

Si vous ne souhaitez pas que chaque lien de suivi des clics soit un lien universel ou un App Link, vous pouvez spécifier quels liens doivent être des liens universels en fonction du partenaire d’envoi de l’e-mail. Reportez-vous aux sections suivantes pour plus de détails.

SendGrid

Pour traiter un lien de suivi des clics Sendgrid comme un lien universel :

1. Configurez vos valeurs pathPrefix AASA ou AndroidManifest pour ne traiter que les liens avec /uni/ dans le chemin URL comme des liens universels.
2. Ajoutez l’attribut universal="true" à l’étiquette d’ancrage de votre lien (<a>). Cette opération modifie le chemin d’accès à l’URL du lien enveloppé pour y inclure /uni/.

Par exemple :

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

3. Assurez-vous que votre application est configurée pour gérer correctement les liens enveloppés. Reportez-vous à l’article de SendGrid sur la résolution des liens de suivi des clics SendGrid et suivez les étapes correspondant à votre système d’exploitation. Cet article contient des exemples de code pour iOS et Android.

Avec cette configuration, les liens avec /uni/ dans le chemin URL fonctionneront comme des liens universels, tandis que tous les autres liens fonctionneront comme des liens web.

SparkPost

Pour traiter un lien de suivi des clics SparkPost comme un lien universel, ajoutez l’attribut suivant à la section Attributs de l’éditeur par glisser-déposer pour l’e-mail, ou modifiez manuellement le code HTML du lien pour inclure l’attribut suivant dans l’étiquette d’ancrage de votre lien : data-msys-sublink="custom_path".

Ce chemin personnalisé vous permet de traiter sélectivement les URLs ayant cette valeur comme un lien universel.

Par exemple :

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

Ensuite, assurez-vous que votre application est configurée pour gérer correctement le chemin personnalisé. Consultez l’article de SparkPost sur l’ utilisation du suivi des clics de SparkPost sur les liens profonds. Cet article contient des exemples de code pour iOS et Android.

Résolution des problèmes des liens universels avec le suivi des clics

Si vos liens universels ne fonctionnent pas comme prévu dans vos e-mails, par exemple en faisant passer le destinataire de son application e-mail au navigateur web avant de le rediriger finalement vers l’application, consultez ces conseils pour résoudre les problèmes liés à la configuration de votre lien universel.

Vérifier l’emplacement/localisation du fichier de liaison

Assurez-vous que le fichier AASA (iOS) ou le fichier Digital Asset Links (Android) se trouve au bon emplacement/localisation :

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

Il est important de veiller à ce que ces fichiers soient toujours accessibles au public. Si vous ne pouvez pas y accéder, il se peut que vous ayez oublié une étape dans la configuration des liens universels pour l’e-mail.

Vérifier la définition des domaines

Assurez-vous que les définitions des domaines que votre application est autorisée à ouvrir sont correctes.

• iOS : Passez en revue les domaines associés configurés dans Xcode pour votre app(étape 1c). Vérifiez que le domaine de suivi des clics est inclus dans cette liste.
• Android : Ouvrez la page d’information de l’application (appuyez longuement sur l’icône de l’application et cliquez sur ⓘ). Dans le menu d’information sur l’application, repérez l’option Ouvrir par défaut et appuyez dessus. Un écran devrait s’afficher avec tous les liens vérifiés que l’application est autorisée à ouvrir. Vérifiez que le domaine de suivi des clics est inclus dans cette liste.