Guide de Deep Linking OneLink™

Les schémas d'URI sont des URL menant les utilisateurs directement aux activités des applications mobiles. Sur Android. les schémas d'URI peuvent également servir à rediriger les utilisateurs vers certaines activités via le Deep Linking.

Si les utilisateurs d'une app saisissent un schéma d'URI dans la barre d'adresse d'un navigateur, l'app se lance et les utilisateurs suivent un Deep Link. Il se passe la même chose lorsque les utilisateurs client sur des liens porteurs d'un schéma d'URI.

AppsFlyer fournit la même fonctionnalité de Deep Linking du schéma d'URI via les URL OneLink avec le paramètre af_dp.

Réglage des schémas d'URI

La configuration de OneLink relative au schéma d'URI doit être effectuée conjointement par le marketeur et le développeur.

La configuration du schéma d'URI s'effectue à deux endroits :

1. La page de modèle OneLink
2. L'app

Le schéma d'URI des instructions suivantes est greatapp://.

Marche à suivre pour le marketeur

Marche à suivre pour le développeur

<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>

Test des schémas d'URI 

Pour tester le schéma d'URI, créez un lien d'attribution personnalisé.

1. Générez un lien d'attribution personnalisé à partir du lien OneLink que vous avez créé
2. Installez l'app sur votre appareil
3. Envoyez le lien d'attribution à l'appareil
4. Cliquez sur le lien

Si le lien ne s'ouvre pas dans 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 

Limites

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

Lorsqu'un OneLink ayant un code 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'application est installée), AppsFlyer tentera d'ouvrir l'application à l'aide du schéma d'URI
  • Si l'utilisateur choisit Annuler (l'application 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'affiche :
    

    

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 plates-formes. Voici les instructions pour iOS et Android.

Le deep Linking via schémas d'URI n'est actuellement pas pris en charge sur les appareils Amazon.

La méthode des liens universels relie une application mobile iOS à un site Web/domaine associé. Ce guide explique comment créer et utiliser les liens universels avec OneLink.

La configuration des liens universels avec OneLink s'effectue en deux étapes :

1. Configuration de OneLink
2. Configuration des applications mobiles pour enregistrer les domaines approuvés

Configuration de OneLink

La configuration de OneLink pour les liens universels doit être réalisée conjointement par le marketeur et le développeur.

Marche à suivre pour le développeur

 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;
  }

Marche à suivre pour le marketeur

Une fois les étapes ci-dessus terminées, chaque fois que les utilisateurs cliquent sur une URL de domaine autorisée (lorsque l'application est déjà installée sur l'appareil), iOS lance l'application associée comme activité par défaut.

Conservation du schéma d'URI

Même sous iOS9 et les versions ultérieures, il demeure important d'implémenter un schéma d'URI Il arrive que des navigateurs ou des apps ne prennent pas en charge les liens universels et emploient à la place la méthode de schéma d'URI. Consultez notre guide de configuration du schéma d'URI pour le Deep Linking.

Limitation des liens universels

Les liens universels présentent certaines limitations que vous devez prendre en compte.

Disponible depuis Android 6.0, cette méthode est la version des liens universels de Google et présente des avantages similaires. Pour en savoir plus, consultez notre article sur les App Links.

Configuration des App Links Android

La configuration de OneLink pour les App Links Android doit être réalisée conjointement par le marketeur et le développeur.

Marche à suivre pour le développeur

AppsFlyerLib.getInstance().sendDeepLinkData(this); 

Marche à suivre pour le marketeur

Deep Linking vers activités spécifiques

Les App Links Android vous permettent de rediriger les utilisateurs vers certaines activités via des Deep Links.

<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>
      

Conservation du schéma d'URI

Il demeure important d'implémenter un schéma d'URI, car il arrive que des appareils Android ne prennent pas encore en charge les App Links et emploient à la place la méthode de schéma d'URI. Consultez notre guide de configuration du schéma d'URI pour le Deep Linking.

Limitation des App Links

Les App Links présentent certaines limitations que vous devez prendre en compte.

Aucune action spécifique nécessaire

Afin que le nouveau OneLink fonctionne, le fichier AASA de l'app doit être mis à jour. Après avoir créé le nouveau modèle OneLink, soumettez une nouvelle version au magasin. Seuls les utilisateurs iOS qui ont effectué la mise à jour vers la nouvelle version peuvent activer une URL OneLink intégrée au nouveau modèle.

1. Après avoir créé le nouveau modèle OneLink, copiez le nouvel ID Onelink généré à cette fin.
2. Copiez le snippet XML en bas de la section App Link et ajoutez-le à votre fichier AndroidManifest.xml dans l'intention vers laquelle vous souhaitez rediriger l'utilisateur via Deep Linking, en plus de la ou des intentions précédentes.
3. Publiez la nouvelle version dans le magasin Seuls les utilisateurs Android qui ont effectué la mise à jour vers la nouvelle version peuvent activer une URL OneLink intégrée au nouveau modèle.

1. Installez et lancez l'application sur votre appareil (ou simulateur d'iPhone sur iOS).
   [Si l'application vient d'être installée, placez-la en arrière-plan, puis revenez au premier plan deux fois ou plus.]
2. Préparez une URL OneLink pour l'application, possédant le paramètre af_dp avec un chemin de schéma valide (par exemple "greatapp://cars").
3. Sur l'appareil testé, collez le lien dans l'e-mail, les notes, les SMS, le générateur de code QR, etc.
4. Cliquez sur le lien.

Résultat attendu : l'application doit s'ouvrir sur l'activité indiquée par af_dp.

1. Déconnectez-vous de l'application.
2. Supprimez l'application.
3. Préparez une URL OneLink pour l'application, possédant le paramètre af_dp (ou un autre) avec un chemin de schéma valide (par exemple "greatapp://cars").
4. Sur l'appareil testé, collez le lien dans l'e-mail, les notes, les SMS, le générateur de code QR, etc.
5. Cliquez sur le lien.
6. Installez et lancez l'applicationsur votre appareil (ou sur le simulateur d'iPhone pour iOS).

Résultat attendu : le lien (données de conversion) est récupéré par l'application au premier lancement. Le paramètre af_dp est extrait et l'utilisateur est redirigé dans l'application en fonction de la valeur donnée à af_dp.

1. Installez et lancez l'application sur votre appareil (ou simulateur d'iPhone sur iOS).
   [Si l'application vient d'être installée, placez-la en arrière-plan, puis revenez au premier plan deux fois ou plus.]
2. Préparez une URL OneLink pour l'application, possédant le paramètre af_dp (ou un autre) avec un chemin de schéma valide (par exemple "greatapp://cars").
3. iOS - Collez le lien dans les notes, dans l'iMessage ou dans un e-mail en utilisant le client Mail d'Apple .
   Android - Collez le lien dans un e-mail, dans Chrome, dans un SMS ou dans le générateur de code QR etc. N'utilisez pas Slack, Facebook ou toute autre application sociale pour cliquer sur le lien !
4. Cliquez sur le lien.

Résultat attendu : l'application s'ouvre immédiatement, sans redirection via le navigateur. Le paramètre af_dp est extrait et l'utilisateur est redirigé dans l'application en fonction de la valeur donnée à af_dp.

Oui, mais seulement en partie. Bien que OneLink soit un outil de Deep Linking complet, les URL spécifiques à une app peuvent également rediriger via le Deep Linking les utilisateurs qui font appel au schéma d'URI. En pratique, cela signifie que vous pouvez utiliser le Deep Linking sur les apps Android en ajoutant simplement le paramètre af_dp à un lien d'attribution AppsFlyer standard.
Les liens universels, à savoir la méthode de Deep Linking disponible pour plus de 98 % des utilisateurs d'iOS, peuvent uniquement être activés par OneLink et non par les liens d'attribution conventionnels d'une plate-forme unique.

Malheureusement, oui.
Les apps sociales traitent le Deep Linking des posts viraux de différentes manières, ce qui rompt souvent l'expérience utilisateur. La solution de contournement recommandée par AppsFlyer pour les diagnostics d'appareil et les redirections via OneLink consiste à utiliser les pages d'accueil comme indiqué dans le guide des redirections OneLink.

Il existe une autre solution de contournement aux fins de Deep Linking, qui peut être utilisée dans les cas ou le lien universel ou le lien d'app est cassé en raison de l'application hôte, par exemple Instagram Stories avec OneLink. La solution consiste à forcer l'utilisation d'un schéma d'URI pour le Deep Linking.

1. Ajoutez le paramètre af_dp à OneLink en spécifiant le chemin vers l'activité redirigée via Deep Linking (plus de détails)

2. Ajoutez &af_force_deeplink=true au lien d'attribution pour forcer l'utilisation d'af_dp

Cette solution de contournement fonctionne bien pour les utilisateurs actifs, c'est-à-dire les utilisateurs qui ont installé l'app sur leur appareil. Cependant, dans iOS, les utilisateurs de Safari qui n'ont pas installé l'app reçoivent un message d'erreur système puis sont redirigés vers la destination de secours définie.

Vous ne pouvez pas supprimer de modèles OneLink. Nous vous déconseillons de supprimer les modèles OneLink. Cela pourrait affecter les campagnes actives. Essayez plutôt de modifier la configuration du modèle. Si vous souhaitez toujours supprimer le modèle OneLink, contactez votre responsable de réussite client ou envoyez-nous un e-mail à l'adresse hello@appsflyer.com.

Oui, mais la modification du sous-domaine du OneLink peut rendre inopérants le deep linking et les liens personnalisés. Il est toujours préférable de créer une nouvelle configuration OneLink et des liens personnalisés, puis de supprimer progressivement l'ancien OneLink et les liens personnalisés qui en dépendent.

Modifier le sous-domaine du OneLink

1. Modifier le sous-domaine du OneLink : vous pouvez effectuer cette action dans la configuration du modèle OneLink.
2. Mettez à jour les liens personnalisés qui dépendent de la configuration OneLink :
   1. Allez à Gestion des liens personnalisés.
   2. Cliquez sur le lien que vous souhaitez mettre à jour.
   3. N'apportez aucune modification. Cliquez simplement sur Mettre à jour le lien au bas de la page.
3. Mettez à jour votre configuration Android. Reportez-vous à la section Configuration des liens d'application Android, plus précisément à la section relative à l'ajout d'un filtre d'intention aux activités dans le fichier AndroidManifest.xml.
4. Mettez à jour votre configuration iOS. Reportez-vous à la section Configuration des liens universels, plus précisément à la section relative à la configuration des domaines approuvés dans XCode.
5. Publiez les deux applications dans les app stores.

Le deep linking ne fonctionne pas pour les utilisateurs disposant d'anciennes versions de l'application, avant les modifications apportées au sous-domaine du OneLink. C'est pourquoi vous devez publier les applications dans les app stores après avoir modifié le sous-domaine du OneLink.

Oui. Et non.
af_dp peut contenir une valeur d'URI et tous les paramètres peuvent être transférés comme partie du chemin de l'URI, par exemple af_dp=greatapp%3A%2F%2Fparam1%2Fparam2 (greatapp://param1/param2).

Encore plus simple, vous pouvez ajouter des paramètres au lien d'attribution après le caractère « ? ».

Cependant, la concaténation de paramètres à la valeur d'af_dp après « ? » n'est PAS recommandée. Les paramètres peuvent être rejetés et ne pas être disponibles via les données de conversion ou d'autres API.
Mauvais exemple  : af_dp=greatapp%3A%2F%2F%3Fparam1%3Da%26param2%3Db (greatapp://?param1=a&param2=b).

Cela signifie que l'intégration du SDK pour le deep linking n'a pas été complètement terminée. La méthode continueUserActivity est manquante et doit être appelée.

Cela est généralement dû à un code dans l'application qui redirige vers un navigateur lorsqu'un lien https lance l'application.

Sur iOS 9 et 10, il existe une option permettant d'ignorer le deep linking (option supprimée sur iOS 11). Lorsqu'une application est ouverte via des liens universels, iOS affiche un lien de contournement de deep link en haut à droite de l'appareil qui définit le lien à ouvrir sans deep linking.

Il s'agit d'un paramètre basé sur l'application, enregistré sur chaque appareil unique. Le paramètre est conservé même si vous supprimez l'application et la réinstallez. La seule façon d'inverser cette situation consiste à réactiver le comportement du lien universel pour cette application sur votre appareil. Il existe plusieurs façons de procéder :

Pour réinitialiser ce paramètre, collez le OneLink dans les notes ou l'iMessage (ou dans d'autres applications prenant en charge les liens universels) et appuyez dessus de manière prolongée. Vous verrez une option « Ouvrir dans [app] ». Sélectionnez cette option ; tous les liens universels pour cette application fonctionneront à nouveau.

Sélectionnez Ouvrir dans votre app (par exemple ouvrir dans LoginBox).
Le Deep Linking est désormais restauré.

J'ai appuyé longuement, mais aucune option « Ouvrir dans votre application » ne s'est affichée !

• Les applications iOS sont construites avec un fichier d'approvisionnement (similaire à une licence). Ce fichier est généré sur la console du développeur Apple, et doit être activé pour les Universal Links.
• Dans Xcode : vérifiez que Domaines associés est activé dans l'onglet Fonctionnalités et comprend le domaine OneLink de l'app.
  
• Vérifiez que l'identifiant d'équipe de l'application correspond à celui entré sur la page de configuration OneLink.

Supprimez l'application, réinstallez-la et lancez-là à nouveau. Si le problème persiste, essayez d'ajouter une ligne aux domaines associés (afin de les modifier). Ensuite, supprimez l'application et réitérez le processus. Vérifiez également que le domaine de votre OneLink est le même que celui configuré sur l'application.

Nous avons compris votre message. Si les instructions précédentes n'ont pas résolu le problème, essayez de une nouvelle fois générer les fichiers de provisionnement de votre app. Téléchargez-les une fois de plus et double-cliquez dessus pour les installer dans Xcode.
Vous pouvez également essayer de supprimer l'app et de la réinstaller avec une version avancée.

iOS 11.2 et tous les correctifs ultérieurs présentent un bogue qui empêche parfois le Deep Linking de fonctionner via les liens universels.

Apparemment, le fichier apple-app-site-association utilisé pour ouvrir les apps avec les liens universels et automatiquement téléchargé avec toute installation d'app iOS ne parvient parfois pas à être téléchargé lors des installations d'apps sur les appareils exécutant iOS 11.2 et les versions ultérieures. En l'absence de ce fichier, les liens universels de l'appareil iOS ne parviennent pas à ouvrir directement les apps.

Si vous rencontrez ce problème en testant le Deep Linking, désinstallez l'app, redémarrez votre appareil iOS (mis en liste blanche) et réinstallez l'app. Aucun changement ? Réessayez.

L'étendue de ce problème sporadique est encore inconnue, bien que celui-ci ait été reproduit sur différents appareils iPhone exécutant iOS 11.2. Nous espérons qu'Apple corrigera bientôt ce bogue qui nuit au fonctionnement du Deep Linking de plus des deux tiers de ses utilisateurs iOS.

Remarque : vous pouvez cliquer sur le bouton Suivre en haut de l'écran pour être prévenu lorsque ce problème sera résolu ou en cas de mise à jour de cet article.

L'exclusion d'utilisateurs nuit à l'attribution et à la collecte des données. Nous vous expliquons pourquoi elle nuit au fonctionnement du mécanisme de Deep Linking et comment résoudre le problème.

Les App Links et les liens universels présentent une différence quant à la réponse de onAppOpenAttribution, en fonction du type de OneLink utilisé.

Sur iOS comme Android, en cas d'utilisation de la version courte de OneLink, les données de conversion représentent une carte structurée de l'ensemble des paramètres du lien :

Exemple :

{
  af_dp: "superapp://Deeplink",
  pid: "media_source_name"
  c: "campaign_name",
  link: "https://abcd.onelink.me/12ab/12ab34c"
  is_retargeting: true
}

La version longue de OneLink, quant à elle, produit une carte avec une seule paire clé-valeur contenant tout le OneLink.

{
  "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
}

La réponse du OneLink court est bien structurée et plus simple à analyser. C'est pourquoi nous vous recommandons d'utiliser la version courte de OneLink.