FAQ sur les deeplinks
Plusieurs facteurs peuvent affecter le comportement de vos deeplinks. Si vous obtenez des résultats inattendus avec vos deeplinks, en test comme en production, consultez cet article pour trouver une solution. Si votre problème persiste, contactez support@adjust.com.
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}.
Résolution des problèmes de deeplinks avec lien + paramètre deep_link
Pourquoi mon deeplink ne fonctionne-t-il pas depuis une publication Facebook ?
Les campagnes exécutées dans des publications Facebook doivent utiliser une URL de lien Adjust avec un paramètre de deeplink ajouté. De plus, le paramètre de deeplink doit avoir un chemin d'accès ajouté ou 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://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Résolution des problèmes de deeplinks différés
Pourquoi mes deeplinks différés ne s'ouvrent-ils pas au bon endroit dans l'application après installation ?
Lorsque votre deeplink différé ne vous dirige pas au bon emplacement dans l'application après installation, vérifiez si le chemin d'accès existe. Hébergez le schéma (myapp://) dans un environnement web et cliquez dessus pour déterminer si le problème provient de la configuration de votre lien ou de votre application. 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 deeplink différé ne fonctionne-t-il pas après avoir oublié l'appareil ?
Parfois, lors des tests, le deeplink différé persiste pendant quelque temps après le clic, même lorsque l'appareil a été oublié dans la Console de test.
Si cette situation se produit, votre test peut ressembler à ce qui suit :
- Vous avez cliqué sur le deeplink, installé l'application et l'avez ouverte.
- Vous avez désinstallé l'application.
- Vous avez oublié l'appareil dans la Console de test.
- Vous exécutez un autre test (clic, installation, ouverture) et le deeplink différé ne fonctionne pas.
Dans ce cas, désinstallez à nouveau l'application, oubliez votre appareil dans la Console de test, puis relancez le test. Après cela, le deeplink différé devrait de nouveau fonctionner comme attendu.