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

Configurez le template OneLink pour vos apps, si ce n'est pas déjà fait.

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>

AppsFlyerLib.getInstance().sendDeepLinkData(this); 

@Override
protected void onNewIntent(Intent intent) {
     super.onNewIntent(intent);
     setIntent(intent);
}

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 onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
  //Handle Conversion Data (Deferred Deep Link)
  }
  
  func onConversionDataFail(_ 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)onConversionDataSuccess:(NSDictionary*) installData {
  //Handle Conversion Data (Deferred Deep Link)
  
}

-(void)onConversionDataFail:(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 sur IOS

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

@Override
protected void onNewIntent(Intent intent) {
     super.onNewIntent(intent);
     setIntent(intent);
}

Marche à suivre pour le marketeur

Suivez les instructions concernant la configuration Android et la configuration de sous-domaine dans votre template OneLink.

Deep Linking vers activités spécifiques

Utilisation des données de conversion

Une autre méthode consiste à deep linker les utilisateurs selon les données de conversion. Par exemple, si l'utilisateur interagit avec une annonce qui promeut la catégorie chaussures de votre app, vous pouvez deep linker l'utilisateur à cette catégorie, et appliquer des réductions ou personnaliser le contenu.

1. Désignez une activité que l'utilisateur verra avant que votre code ne décide vers où le deep linker. Dans ce but, vous pouvez utiliser une activité vide ou l'activité principale. Cette activité agit comme une activité qui oriente les utilisateurs vers d'autres activités selon les données de conversion.
2. Suivez les étapes de la configuration Android pour le deep linking.
3. À l'étape 2, vous êtes invité à ajouter un morceau de code à une activité, dans le manifeste Android. Dans le manifeste Android, dans la balise activité de l'activité choisie, ajoutez ce morceau.
4. Dans l'activité de routage, ajoutez l'API :

   AppsFlyerLib.getInstance().sendDeepLinkData(this); 

5. Lorsque cette activité s'ouvre avec un deep linking, elle vérifie que onAppOpenAttribution reçoit bien les données de conversion.
6. Vous appliquez cette logique pour que onAppOpenAttribution décide où deep linker l'utilisateur.

Utilisation du filtre d'intention dans le manifeste Android

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>
      

AppsFlyerLib.getInstance().sendDeepLinkData(this); 

Conservation du schéma d'URI sur Android

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.

Le flux de Deep Linking d'iOS diffère légèrement de celui d'Android. Consultez le diagramme ci-dessous à titre d'illustration.

Le diagramme précédent illustre les points suivants :

1. L'utilisateur clique sur un Deep Link
2. La méthode continuteUserActivity ou openURL indique au SDK d'AppsFlyer que l'app a été ouverte via le Deep Linking
3. Le SDK AppsFlyer enregistre le lancement d'app
4. La méthode onAppOpenAttribution est ensuite appelée
5. La méthode onAppOpenAttribution contient les données de Deep Linking
6. Les données de Deep Linking permettent ensuite de rediriger les utilisateurs vers l'activité pertinente et de leur fournir le contenu correspondant

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 Notes, iMessage ou dans un e-mail à l'aide d'Apple Mail Client.
   Android : collez le lien dans un e-mail, SMS, générateur de code QR, etc. N'utilisez pas Slack ou Facebook ou aucune autre app 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.

Remarque sur le test de deep linking avec les liens universels : si vous modifiez les paramètre de Liens universels des templates OneLink (comme le sous-domaine OneLink ou le préfixe ID d'app), assurez-vous de supprimer puis réinstaller l'app après chaque modification.

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.

Non, il n'est pas possible de coller d'URL dans un navigateur Chrome d'Android ou dans Safari d'iOS.
Cette opération était prise en charge par le passé, mais elle est désormais obsolète pour raison de sécurité des navigateurs.
Effectuez votre test en cliquant sur les URL, et non en les copiant-collant dans la zone URL du navigateur.

Oui, il est possible de supprimer un template OneLink. Notez que s'il existe quelque part des URL OneLink qui utilisent le template supprimé, les utilisateurs ne seront simplement pas redirigés vers l'App Store après avoir cliqué. Par conséquent, assurez-vous qu'aucune URL OneLink n'utilise le template avant la suppression. N'oubliez pas qu'il est aussi possible de modifier tout simplement la configuration du template.

Oui, mais la modification du sous-domaine OneLink peut rendre inopérants le deep linking et les liens personnalisés. Il est toujours préférable de créer un nouveau template OneLink et des nouveaux 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 du template 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).

Si l'URL OneLink est placée dans une balise HTML "a" avec l'attribut target="_blank", sur Android elle ouvre une page vierge dans Chrome. Ce qui affecte la fonctionnalité OneLink. Assurez-vous que la balise "a" n'inclut pas l'attribut target.

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'ID Team de l'application correspond à celui entré sur la page de template 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.

iOS 13 présente un bogue qui empêche parfois le deep linking de fonctionner via les liens universels.

Il arrive qu'un processus qui s'exécute dans iOS 13 pour vérifier les installations échoue. Cet échec empêche iOS de vérifier les domaines associés. Il en résulte que le deep linking sous iOS 13 peut ne pas fonctionner. Cela ne se produit pas systématiquement mais la fréquence de ce dysfonctionnement est inconnue pour le moment. Cliquez ici pour plus d'informations.

Pour éviter ce problème, vous pouvez utiliser le mécanisme de deeplinking de schéma d'URI. Par défaut, lorsque les liens universels viennent à échouer, OneLink redirige l'utilisateur vers le store. Vous pouvez ajouter au lien le paramètre af_force_deeplink=true. Cela forcera OneLink à tenter d'opérer le deep linking en utilisant le schéma spécifié dans le paramètre af_dp.

Pour en savoir plus sur le deep linking forcé, cliquez ici .

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.

Chrome a sorti une nouvelle version de navigateur (V.79) qui interrompt la fonction de deep link chez certains utilisateurs.

Les utilisateurs concernés sont les utilisateurs Android qui cliquent sur un lien contenant le paramètre af_dp, ou bien ceux qui :

• N'ont pas installé l'app
• N'ont pas Chrome qui tourne en arrière-plan (même si l'app est installée)

Pour garantir que ces utilisateurs atteignent le bon contenu de l'app, nous avons créé une page d'accueil vers laquelle ils sont redirigés lorsqu'ils cliquent sur un lien contenant af_dp.

Ces utilisateurs sont redirigés vers le navigateur Chrome, où ils voient s'afficher une page d'accueil générée automatiquement par AppsFlyer, qui comprend le nom de l'app, l'icône et un bouton : Ouvrir l'application.

Le tableau suivant présente les différents cas de figure lorsqu'un utilisateur concerné clique sur une URL OneLink qui contient af_dp :