FAQ des liens universels
Plusieurs facteurs peuvent affecter le comportement de vos liens universels. Si vous obtenez des résultats inattendus avec vos liens universels, en environnements de test et de production, consultez cet article pour trouver une solution. Si votre problème persiste, contactez-nous.
Problèmes généraux
La syntaxe et le codage de mon URL sont-ils corrects ?
Si votre deeplink ne vous dirige pas vers la destination spécifiée ou renvoie une erreur HTTP 404, vérifiez d'abord le codage et la syntaxe de l'URL.
Les URL utilisent généralement cette syntaxe : scheme://host:port/path?query-string#fragment-id
Chaque partie de l'URL réalise une fonction propre et utilise des caractères spécifiques pour identifier et séparer les valeurs. Le schéma et l'hôte ne sont pas sensibles à la casse, mais le chemin d'accès et la chaîne-requête le sont. Une URL contenant une erreur ne peut pas s'ouvrir comme attendu.
Lorsque vous configurez votre deeplink, soyez attentif aux conditions suivantes :
- Si vous ajoutez un paramètre Adjust à une chaîne de requête URL contenant déjà des paramètres de requête, utilisez un caractère
&. Sinon, toute information après le deuxième?dans une URL est rejetée.- Exemple correct :
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012 - Exemple incorrect :
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- Exemple correct :
- Si votre chaîne de requête est codée, faites-la commencer pas
/ou assurez-vous qu'elle est intégrée à un paramètredeeplink.
Si votre application n'est pas déjà installée et que ces conditions ne sont pas satisfaites, le paramètre adjust_t est rejeté par le navigateur. Adjust a besoin de ce paramètre pour localiser la source du clic ; sans lui, nous renvoyons une erreur HTTP 404 URL not found.
Exemples
En fonction de la configuration de votre URL, votre deeplink peut avoir les comportements suivants :
| Configuration des deeplinks | Exemple d'URL de lien | Comportement |
|---|---|---|
URL de lien + paramètre deep_link | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | Ouvre l'application à la page in-app spécifiée. |
| lien universel | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | Ouvre l'application à la page in-app spécifiée. |
| lien universel | https://abcd.adj.st/?path&adjust_t=r40ncx7 | Ouvre l'application si elle est installée, mais ne peut pas atteindre la page in-app spécifiée. |
| lien universel | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | N'est pas valide et renvoie une erreur. |
Pourquoi ne puis-je pas voir mes données d'attribution et/ou niveaux de campagne ?
Si vos données d'attribution ou niveaux de campagne dans votre URL de deeplink ne sont pas disponibles, il existe certainement un problème de configuration. Vérifiez que les paramètres d'ID d'appareil et les paramètres de campagne (si applicable) ne sont pas tronqués à cause d'erreurs de codage dans les fallbacks ou les callbacks. Par exemple, l'URL ne doit pas contenir d'espaces ou de caractères non valides.
Pourquoi suis-je redirigé vers le store alors que mon application est installée ?
Généralement, ce comportement signifie que votre deeplink n'a pas réussi à ouvrir l'application et que nous utilisons une redirection vers le store avec un fallback. Pour tester cette situation, procédez comme suit :
Suivez nos instructions de test en tant qu'utilisateur existant pour les liens universels et les liens avec le paramètre deep_link.
Si votre test réussit et que l'application s'ouvre, tenez compte de l'environnement dans lequel le deeplink a été activé au moment de son échec. Vérifiez ensuite si des paramètres supplémentaires sont nécessaires pour cette instance.
- Par exemple, si un lien universel JSR est activé dans Slack, l'indicateur
adjust_deeplink_js=1doit être présent. Il aide à charger le schéma avant la redirection vers le store. Si votre lien ne fonctionne pas même lorsque l'indicateuradjust_deeplink_jsest présent, alors votre schéma d'application est peut-être saisi de manière incorrecte dans Campagne.
- Par exemple, si un lien universel JSR est activé dans Slack, l'indicateur
Assurez-vous qu'il n'existe aucune erreur de codage vers vos fallbacks ou callbacks dans l'URL de lien susceptible de la briser. Cela entraînera le rejet des paramètres. Et à cause des paramètres rejetés, le lien complet ne fonctionnera pas comme attendu.
Pourquoi mon deeplink ne s'ouvre-t-il pas à l'emplacement approprié dans l'application ?
Si votre lien ne mène pas à l'emplacement souhaité, mais qu'il ouvre votre application, déterminez si c'est la configuration de votre lien ou de votre application qui cause le problème.
- Hébergez le domaine du lien universel (
https://abcd.adj.st/) ou le schéma (myapp://) dans un environnement web, puis activez-le (clic) depuis cet emplacement. - Contactez votre équipe de développement pour vous assurer que les chemins dans l'application sont configurés correctement.
Adjust reçoit les données de clic entrantes pour les deeplinks à l'aide d'un lien Adjust ou de paramètres Adjust supplémentaires. Un deeplink direct contenant uniquement un domaine spécifique à votre application ne renverra aucune donnée à Adjust.
Envoi de données de clic :
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1Pas d'envoi de données de clic :
myapp://welcomePour recevoir des données de clic pour les applications déjà installées et pour la réattribution des deeplinks, assurez-vous d'implémenter le clic SDK dans le SDK Adjust (iOS ; Android).
Les deeplinks qui déclenchent un clic SDK sont rapportés sous la forme de clics dans Datascape. Ils sont également visibles dans vos données brutes à l'aide du callback click. Pour obtenir une vue granulaire des clics résultant d'un clic SDK de deeplink, incluez le paramètre {is_deeplink_click}.
Problèmes avec les liens universels.
Pourquoi mon lien universel n'ouvre-t-il pas une application installée ?
Vérifiez que vous avez configuré vos liens universels correctement.
Déterminez l'environnement depuis lequel Apple ouvre le lien. Les redirections vers des liens universels ne sont pas autorisées par Apple hors de Safari. Vous devez donc héberger le lien universel ou le schéma brut dans un environnement web. Par exemple,
https://abcd.adj.st/oumyapp://, respectivement. Avec l'application installée sur votre appareil de test, visitez la page hébergeant le schéma ou le lien universel brut, puis sélectionnez le lien.
Si votre application ne s'ouvre pas :
- Ouvrez votre page HTML de test dans Safari, puis sélectionnez l'icône Partager. Vous devriez voir un menu « Ouvrir avec... » avec votre application répertoriée comme l'une des options. Si c'est le cas, alors la configuration des domaines associés est correcte et le fichier AASA (Apple App Site Association) a été correctement téléchargé. Vous devez peut-être désinstaller et réinstaller l'application si vous ne voyez pas cette option.
- Vérifiez que votre Bundle ID est identique en test et en production.
- Assurez-vous que les valeurs de votre application iOS Bundle ID et App Prefix dans AppView sont correctes. Si la configuration est correcte et que votre application ne s'ouvre toujours pas, contactez votre développeur pour analyser plus précisément l'association du lien universel ou du schéma avec l'application.
- Vérifiez si l'attribut
target=“_blank”fait partie de votre lien :
Cela peut provoquer l'ouverture de l'application dans l'environnement de test, mais pas dans celui de production.
Par exemple avec l'attribut target=“_blank”, votre code HTML peut ressembler à :
<a href="[https://abcd.adj.st](https://abcd.adj.st/)" target="_blank">Universal Link to App</a>
Pour résoudre ce problème, supprimez l'attribut, comme dans l'exemple suivant :
<a href="[https://abcd.adj.st](https://abcd.adj.st/)">Universal Link to App</a>
Pourquoi suis-je redirigé vers le store alors que mon application est installée ?
- Suivez nos instructions de test pour les liens universels. Passez également en revue les étapes données dans la section « Pourquoi mon lien universel n'ouvre-t-il pas une application installée ? » ci-dessus.
- Déterminez l'environnement dans lequel le lien universel a été activé lorsqu'il a échoué. Vérifiez ensuite si des paramètres supplémentaires sont nécessaires pour cette instance.
- Par exemple, si un lien universel JSR est activé dans Slack, l'indicateur
adjust_deeplink_js=1doit être présent. Il aide à charger le schéma avant la redirection vers le store. Si votre lien ne fonctionne pas même lorsque l'indicateuradjust_deeplink_jsest présent, alors votre schéma d'application est peut-être saisi de manière incorrecte dans les paramètres de votre application dans AppView.
- Par exemple, si un lien universel JSR est activé dans Slack, l'indicateur
Pourquoi mes deeplinks ou mes deeplinks différés ne s'ouvrent-ils pas au bon endroit dans l'application après installation ?
Si votre lien ne mène pas à l'emplacement souhaité, mais qu'il ouvre votre application, déterminez si c'est la configuration de votre lien ou de votre application qui cause le problème.
- Hébergez le domaine du lien universel (
https://abcd.adj.st/) ou le schéma (myapp://) dans un environnement web, puis activez-le (clic) depuis cet emplacement. - Contactez votre équipe de développement pour vous assurer que les chemins dans l'application sont configurés correctement.
Si vous êtes dirigé vers le chemin d'accès correct en tant qu'utilisateur existant, mais pas en tant que nouvel utilisateur, inspectez votre appareil via la Console de test et assurez-vous que le clic vous a été attribué. Si ce n'est pas le cas, oubliez l'appareil à l'aide de la Console de test, puis réessayez.
Si le clic vous a été attribué, inspectez votre appareil pour vérifier s'il inclut un paramètre deeplink. Si ce n'est pas le cas, assurez-vous qu'il n'existe aucune erreur de codage ou des caractères spéciaux qui tronquent l'URL en amont du paramètre deeplink.
Enfin, si un paramètre deeplink est inclus, assurez-vous que le chemin d'accès est présent et conforme à vos attentes. Si le chemin n'existe pas, il a été tronqué. Contactez support@adjust.com pour obtenir de l'aide.
Pourquoi mon lien universel ne fonctionne-t-il pas depuis une publication Facebook ou Instagram ?
Assurez-vous qu'un chemin est ajouté à vos liens universels. Sans chemin, l'utilisateur sera dirigé vers le store, même si l'application est installée. Le chemin d'accès fourni n'a pas besoin d'être valide.
Exemple d'un paramètre avec un chemin : https://abcd.adj.st/path?adjust_t=abc123
Puis-je utiliser des liens universels dans les campagnes email ?
Généralement, iOS n'autorise pas les redirections vers des liens universels hors de Safari. Ce comportement a donc un impact sur tous les environnements utilisant SFSafariViewController.
Il existe de nombreux environnements dans lequel un email peut être ouvert, comme un navigateur ou une application de messagerie électronique qui ne prend pas en charge les liens universels. En conséquence, la meilleure pratique est d'utiliser des liens JSR ou, dans l'idéal, l'une des intégrations ESP d'Adjust.
Pourquoi ne puis-je pas voir mes données d'attribution et/ou niveaux de campagne ?
Vérifiez si les paramètres Adjust sont préfixés avec adj_ ou adjust_. Les paramètres Adjust non préfixés avec adj_ ou adjust_ sont ignorés et leurs données ne s'affichent pas automatiquement.
Pourquoi mon partenaire ne reçoit-il pas les callbacks attribués alors que les installations sont attribuées correctement ?
- Vérifiez si vous avez ajouté le paramètre ID de clic au lien universel.
- Assurez-vous qu'il n'existe aucune erreur de codage vers vos fallbacks ou callbacks dans l'URL de lien susceptible de la briser.
- Vérifiez que le paramètre ID de clic est préfixé avec
adj_ouadjust_
Pourquoi ai-je des problèmes avec les liens universels JSR dans Safari pour iOS 12.2 et 12.3 ?
Pour iOS 12.2 et 12.3, les liens universels JSR ne s'ouvrent pas toujours correctement lorsqu'ils sont activés dans un environnement Safari. Cela a un impact dans les cas où l'en-tête HTTP référent n'est pas lisible : par exemple, en mode incognito.
Pour les campagnes Safari, nous conseillons donc d'utiliser des liens universels bruts. Cependant, cette solution ne fonctionne pas pour les campagnes email avec des URL enveloppées.
À partir d'iOS 13+, ce problème disparaît, car nous pouvons appliquer un fallback vers le schéma. Mais ce cas de figure exige toutefois un pop-up supplémentaire.