Liens universels et App Links

Cet article décrit comment configurer les liens universels Apple et les Android App Links.

Les liens universels Apple et les Android App Links sont des mécanismes conçus pour offrir une transition fluide entre le contenu web et les applications mobiles. Alors que les liens universels sont spécifiques à iOS, les Android App Links remplissent la même fonction pour les applications Android.

Fonctionnement des liens universels et des App Links

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

Lorsqu’un lien universel ou un 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 peut également être configuré pour rediriger vers l’App Store ou le Google Play Store respectivement.

En d’autres termes, les liens universels permettent à un site web d’associer ses pages web à des écrans spécifiques de l’application, de sorte que lorsqu’un utilisateur clique sur un lien vers une page web correspondant à un écran de l’application, celle-ci peut être ouverte directement (si l’application est actuellement 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 par e-mail, car les e-mails peuvent être ouverts et cliqués depuis des appareils de bureau et mobiles.

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

Conditions préalables

Pour utiliser les liens universels et les App Links :

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

Configuration des liens universels et des App Links

Pour que les applications prennent en charge les liens universels ou les App Links, iOS et Android nécessitent tous deux qu’un fichier de permissions spécial soit hébergé sur le domaine du lien. Ce fichier contient les définitions des applications autorisées à ouvrir les liens de ce domaine et, pour iOS, les chemins que ces applications sont autorisées à ouvrir :

• iOS : fichier Apple App Site Association (AASA)
• Android : fichier Digital Asset Links

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, configurées au sein de l’application :

• iOS : définis comme « Associated Domains » dans Xcode
• Android : définis dans le fichier AndroidManifest.xml de l’application

Cette association bidirectionnelle domaine-application est nécessaire pour qu’un lien universel ou un App Link fonctionne et empêche toute application de détourner les liens d’un domaine particulier ou tout domaine d’ouvrir une application 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 encapsuler tous les liens et inclure des paramètres d’URL pour le suivi des clics dans les e-mails 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 une configuration supplémentaire. Assurez-vous d’ajouter le domaine de suivi des clics (links.email.example.com) comme domaine que l’application est autorisée à ouvrir. De plus, le domaine de suivi des clics doit servir les fichiers AASA (iOS) ou Digital Asset Links (Android). Cela contribuera à garantir que les liens d’e-mail avec suivi des clics fonctionnent de façon fluide.

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 d’e-mails. Consultez les 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 AASA ou AndroidManifest pathPrefix pour ne traiter comme liens universels que les liens contenant /uni/ dans le chemin d’URL.
2. Ajoutez l’attribut universal="true" à la balise d’ancrage (<a>) de votre lien. Cela modifie le chemin d’URL du lien encapsulé pour 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 encapsulés. Consultez 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 contenant /uni/ dans le chemin d’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 dans la section Attributs de l’éditeur par glisser-déposer pour l’e-mail, ou modifiez manuellement le HTML du lien pour inclure l’attribut suivant dans la balise d’ancrage de votre lien : data-msys-sublink="custom_path".

Ce chemin personnalisé vous permet de traiter sélectivement les URL contenant 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 SparkPost sur les liens profonds. Cet article contient des exemples de code pour iOS et Android.

Désactiver le suivi des clics lien par lien

Vous pouvez désactiver le suivi des clics pour des liens spécifiques en ajoutant du code HTML à votre message e-mail pour l’éditeur HTML ou à un bloc HTML pour l’éditeur par glisser-déposer.

SendGrid

Si votre fournisseur de services d’e-mailing est SendGrid, utilisez le code HTML clicktracking=off comme ceci :

<a clicktracking=off href="[INSERT https LINK HERE]">click here</a>

SparkPost

Si votre fournisseur de services d’e-mailing est SparkPost, utilisez le code HTML data-msys-clicktrack="0" comme ceci :

<a data-msys-clicktrack="0" href="[INSERT https LINK HERE]">click here</a>

Amazon SES

Si votre fournisseur de services d’e-mailing est Amazon SES, utilisez le code HTML ses:no-track comme ceci :

<a ses:no-track href="[INSERT https LINK HERE]">click here</a>

Éditeur par glisser-déposer

Lorsque vous utilisez l’éditeur d’e-mail par glisser-déposer, saisissez votre code HTML en tant qu’attribut personnalisé si votre lien est attaché à du texte, un bouton ou une image.

Attribut personnalisé pour un lien texte

SendGrid

Sélectionnez les éléments suivants pour l’attribut personnalisé :

• Name : clicktracking
• Value : off

SparkPost

Sélectionnez les éléments suivants pour l’attribut personnalisé :

• Name : data-msys-clicktrack
• Value : 0

Attribut personnalisé pour un bouton ou une image

SendGrid

Sélectionnez les éléments suivants pour l’attribut personnalisé :

• Name : clicktracking
• Value : off
• Type : Link

SparkPost

Sélectionnez les éléments suivants pour l’attribut personnalisé :

• Name : data-msys-clicktrack
• Value : 0
• Type : Link

Résolution des problèmes liés aux liens universels avec suivi des clics

Si vos liens universels ne fonctionnent pas comme prévu dans vos e-mails, par exemple en redirigeant le destinataire de son application de messagerie vers le navigateur web avant de finalement rediriger vers l’application, consultez ces conseils pour résoudre les problèmes de configuration de vos liens universels.

Vérifier l’emplacement du fichier de liens

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

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

Il est important de s’assurer que ces fichiers sont toujours accessibles publiquement. Si vous ne pouvez pas y accéder, vous avez peut-être manqué une étape dans la configuration des liens universels pour l’e-mail.

Vérifier les définitions de domaines

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

• iOS : vérifiez les Associated Domains configurés dans Xcode pour votre application (étape 1c). Vérifiez que le domaine de suivi des clics est inclus dans cette liste.
• Android : ouvrez la page d’informations de l’application (appui long sur l’icône de l’application et cliquez sur ⓘ). Dans le menu d’informations de l’application, localisez Ouvrir par défaut et appuyez dessus. Cela devrait afficher un écran 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.