> ## Documentation Index > Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt > Use this file to discover all available pages before exploring further. # URLs, liens et liens profonds > Configurez les URL de lancement, les liens profonds, les URL dynamiques, le suivi UTM et le suivi des clics dans les messages push, e-mail, in-app, SMS et RCS. ## Comment fonctionnent les liens Chaque message OneSignal — push, e-mail, in-app, SMS ou RCS — peut inclure une URL qui amène l'User vers une destination lorsqu'il clique. Cette destination peut être une page web qui s'ouvre dans un navigateur ou un [lien profond](#liens-profonds) qui s'ouvre directement dans votre application. La façon dont vous définissez l'URL dépend du canal : * **Push** : Utilisez le champ **Launch URL** dans le tableau de bord ou le paramètre `url` dans l'API. * **E-mail** : Ajoutez des liens via l'éditeur d'e-mail ou en HTML. OneSignal suit automatiquement les clics. * **In-app** : Configurez les [Click Actions](./iam-click-actions) sur les boutons, images ou arrière-plans. * **SMS/RCS** : Ajoutez des liens directement dans le message. Utilisez **Insert Trackable Link** dans le tableau de bord pour le raccourcissement et le suivi automatiques. Voir [Liens SMS/RCS traçables](#sms%2Frcs-trackable-links). ### Liens profonds Pour ouvrir du contenu directement dans votre application plutôt que dans un navigateur, utilisez un lien profond. La prise en charge des liens profonds varie selon le canal : * **Push et in-app** : Prennent en charge les schémas d'URL personnalisés comme `votre-app://produit/123` et les universal links / App Links en `https://`. * **E-mail et SMS** : Seuls les universal links / App Links en `https://` sont pris en charge. Les schémas d'URL personnalisés ne fonctionnent pas car les clients de messagerie et les applications SMS ne les gèrent pas. Guide complet pour configurer les schémas d'URL personnalisés, les universal links et le routage spécifique à l'application. ### Push #### Launch URL La **Launch URL** s'ouvre lorsque l'User clique sur une notification push. Elle doit commencer par `https://`. Pour utiliser des URL `http://` sur les appareils Apple, configurez la propriété [NSAppTransportSecurity](https://developer.apple.com/documentation/bundleresources/information_property_list/nsapptransportsecurity) dans le fichier `Info.plist` de votre application. Si vous envoyez un seul message aux Users web et mobiles, utilisez les champs d'URL spécifiques à chaque plateforme : * `url` — cible toutes les plateformes * `web_url` — cible uniquement les Subscriptions web push * `app_url` — cible uniquement les Subscriptions mobiles Tableau de bord OneSignal affichant le champ de saisie Launch URL pour les notifications push Pour ignorer une notification web push sans ouvrir aucune page, ajoutez `?_osp=do_not_open` à la launch URL, par exemple `https://yoursite.com/page?_osp=do_not_open`. Cela fonctionne uniquement pour le web push. #### Additional data Au lieu d'une Launch URL, vous pouvez envoyer des paires clé-valeur personnalisées via le champ **Additional Data** (`data` dans l'API). Votre application lit ces données via le [SDK's Notification Click Listener](./mobile-sdk-reference#push-notification-events) grâce à la propriété `additionalData` — utile lorsque vous avez besoin de plus de flexibilité qu'une simple URL. Tableau de bord OneSignal affichant le champ Additional Data avec une paire clé-valeur personnalisée ### Suivi des liens dans les e-mails OneSignal suit automatiquement les clics sur les liens dans les e-mails lorsque **Track link clicks** est activé pour l'e-mail ou le template (activé par défaut). OneSignal suit le nombre total de clics et les clics uniques par e-mail et par lien individuel (jusqu'à 30 liens par e-mail). Consultez ces statistiques dans les [Email Message Reports](./email-message-reports). Pour les liens de désinscription, consultez [Unsubscribe Links & Email Subscriptions](./unsubscribe-links-email-subscriptions). Rapport de message e-mail OneSignal affichant l'activité des clics avec le nombre total et unique de clics par lien Le suivi fonctionne en réécrivant les URL pour capturer l'événement de clic, puis en redirigeant l'User vers la destination d'origine. Cela se produit presque instantanément mais peut entraîner un comportement inattendu avec les [liens profonds](./deep-linking). Par exemple : `https://some-domain.com/the-page` devient quelque chose comme : `https://some-domain/c/eJxU0D2uGzEMBODTrDoZJPW3...` L'User est immédiatement redirigé vers l'URL cible. Si vous construisez des liens avec la syntaxe Liquid, OneSignal peut ne pas les détecter automatiquement. Marquez explicitement un lien comme traçable : ```liquid theme={null} {{ 'https://some-domain.com/the-page' | track_link }} ``` Pour désactiver le suivi pour tout un e-mail, décochez **Track link clicks** dans l'éditeur d'e-mail du tableau de bord ou définissez `disable_email_click_tracking: true` dans l'API. Paramètres d'e-mail du tableau de bord OneSignal avec Track link clicks décoché Pour désactiver le suivi pour un lien spécifique tout en le conservant pour les autres, ajoutez l'attribut `disable-tracking=true` à sa balise d'ancrage : ```html theme={null} Voir la page ``` Désactiver le suivi pour tout un e-mail signifie qu'aucune donnée de clic n'est collectée — le CTR affiche « N/A » dans les [Email Message Reports](./email-message-reports). ### Liens SMS/RCS traçables OneSignal fournit des liens raccourcis et traçables pour les messages SMS/RCS en utilisant le domaine `1sgnl.co`. Il suffit d'envelopper votre URL dans `{{ "https://your-url.com" | track_link }}` et le lien sera remplacé par un lien traçable lors de l'envoi du message. Pour l'utilisation via l'API, consultez la [référence de l'API de création de message SMS/RCS](/reference/sms). Un seul lien traçable est autorisé par message SMS/RCS. Depuis le tableau de bord, vous pouvez également cliquer sur le bouton **Insert Trackable Link** sous la zone de saisie du message et entrer votre URL : Modal du tableau de bord OneSignal pour insérer un lien raccourci traçable dans un message SMS Cliquez sur **Insert trackable link** pour ajouter le lien court à votre message : ```liquid theme={null} Your order is on its way! Track it here: {{ "https://your-url.com" | track_link }} ``` Lors de l'envoi du message, les doubles accolades et leur contenu seront remplacés par un lien traçable `1sgnl.co/XXXX` : Notification SMS sur un appareil mobile affichant un lien raccourci traçable *** ## URL dynamiques Vous pouvez créer des URL personnalisées et spécifiques à chaque utilisateur avec la [syntaxe Liquid](./using-liquid-syntax). Par exemple, incluez l'identifiant d'un User dans l'URL afin que chaque personne arrive sur sa propre page de profil, ou insérez un identifiant de produit d'un événement récent pour pointer directement vers un article pertinent. Les URL dynamiques peuvent extraire des données de : * Propriétés utilisateur (par exemple, `external_id`, `email`) * Tags stockés dans OneSignal * `custom_data` envoyées via l'API * Custom Events (dans les Journeys) Injectez des valeurs telles que `external_id` ou `email` directement dans les URL. ```text theme={null} https://yourdomain.com/profile/user={{subscription.external_id}} ``` Si le `external_id` de l'User est `12345`, l'URL finale est : ```text theme={null} https://yourdomain.com/profile/user=12345 ``` De même : ```text theme={null} https://yourdomain.com/profile/email={{subscription.email}} ``` Si l'e-mail de l'User est `john@example.com`, l'URL finale est : ```text theme={null} https://yourdomain.com/profile/email=john@example.com ``` Référencez les tags utilisateur stockés dans OneSignal. ```text theme={null} https://yourdomain.com/topic/{{tag_key}} ``` Si l'User a un tag `tag_key` avec la valeur `technology`, l'URL finale est : ```text theme={null} https://yourdomain.com/topic/technology ``` Si `tag_key` n'est pas défini, l'URL devient : ```text theme={null} https://yourdomain.com/topic/ ``` Utilisez le filtre `default` pour définir une valeur de repli : ```text theme={null} https://yourdomain.com/topic/{{tag_key | default: 'unknown'}} ``` Utilisez l'API de création de message avec des Templates. Définissez l'URL dans le template avec une syntaxe Liquid qui référence l'objet `custom_data`. URL du template : ```text theme={null} https://yourdomain.com/invoice={{message.custom_data.invoice_number}} ``` Requête API avec `custom_data` : ```json theme={null} { "template_id": "YOUR_TEMPLATE_ID", "custom_data": { "invoice_number": "12345" } } ``` URL finale : ```text theme={null} https://yourdomain.com/invoice=12345 ``` Personnalisez les URL en utilisant les Custom Events capturés dans les Journeys. Référencez les propriétés d'événement directement ou assignez l'événement à une variable pour une syntaxe plus lisible. **Référencer les propriétés d'événement directement :** ```text theme={null} https://yourdomain.com/order/{{ journey.event.purchase.properties.order_id }} ``` Si le dernier événement `purchase` inclut `"order_id": "98765"`, l'URL finale est : ```text theme={null} https://yourdomain.com/order/98765 ``` **Assigner l'événement pour plus de lisibilité :** ```liquid theme={null} {% assign event = journey.event.purchase %} https://yourdomain.com/order/{{ event.properties.order_id }} ``` **Accéder à l'événement le plus récent stocké :** ```text theme={null} https://yourdomain.com/product/{{ journey.last_event.properties.product_id | default: 'unknown' }} ``` **Noms d'événements avec espaces ou caractères spéciaux (notation avec crochets) :** ```text theme={null} https://yourdomain.com/status/{{ journey.event["order status"].properties.current_status }} ``` Les Custom Events ne peuvent être référencés que dans des Templates utilisés au sein de Journeys. Utilisez `journey.first_event`, `journey.last_event` ou `journey.event.` pour accéder aux données d'événement en Liquid. N'injectez des données que dans des parties de l'URL — gardez le protocole (`https://`) et le domaine comme texte statique. Utilisez le filtre `default` pour définir une valeur de repli si une valeur est absente. *** ## Paramètres UTM Les paramètres UTM permettent de suivre les performances des campagnes en ajoutant des informations de `source`, `medium` et `campaign` aux URL. Ajoutez les paramètres UTM directement aux URL dans vos messages. Pour les notifications push envoyées depuis le tableau de bord, OneSignal peut ajouter automatiquement les UTM. Accédez à **Settings > Push & In-app > UTM Settings** et activez **Turn on automated UTM tagging**. Une fois activé, OneSignal ajoute ces valeurs (modifiables) : * **Source** = `utm_source` — par défaut `onesignal` * **Medium** = `utm_medium` — par défaut `push` * **Campaign** = `utm_campaign` — par défaut `{{ sendDate }}-{{ title }}` * `sendDate` : Date d'envoi * `title` : Les 15 premiers caractères alphanumériques, tirets bas ou tirets du titre du message Exemple : ```text theme={null} https://test.com?utm_source=onesignal&utm_medium=push&utm_campaign=2020-06-03-sale-today ``` Le balisage UTM automatique s'applique uniquement aux notifications push envoyées depuis le tableau de bord. Il ne fonctionne pas avec : * Les e-mails, SMS ou messages in-app * Les Journeys, Templates ou messages automatisés * Les requêtes API * Le bouton « Send Test Message » * Les champs Additional data Pour ces cas, ajoutez manuellement les paramètres UTM dans vos templates ou charges utiles API. #### Gestion des URL et substitutions Si vous ajoutez manuellement des paramètres UTM à une launch URL alors que le balisage automatique est activé, vos UTM manuels remplacent les valeurs automatiques. *** ## FAQ ### Comment créer un lien vers l'app store ? Utilisez l'URL de la boutique comme launch URL : * **Android** : Utilisez le lien Google Play, par exemple `https://play.google.com/store/apps/details?id=com.example.app`. Voir [Linking to Google Play](https://developer.android.com/distribute/marketing-tools/linking-to-google-play.html). * **iOS** : Utilisez le lien App Store mais remplacez `https://` par `itms-apps://` pour ouvrir directement l'application App Store, par exemple `itms-apps://apps.apple.com/app/id123456789`. ### Puis-je créer un lien vers une autre application ? Pour les messages push et in-app, vous pouvez utiliser un schéma d'URL pour créer un lien profond vers une autre application. Par exemple, pour [créer un lien profond vers WhatsApp](https://faq.whatsapp.com/425247423114725) : `whatsapp://wa.me/15551234567`. Pour les e-mails et les SMS, utilisez des liens `https://` à la place — les schémas d'URL personnalisés ne sont pas pris en charge. ### Pourquoi ma launch URL ne fonctionne-t-elle pas ? Causes courantes : * **URL incorrecte** : L'URL doit commencer par `https://`. Si vous utilisez `http://` sur des appareils Apple, vous devez configurer [NSAppTransportSecurity](https://developer.apple.com/documentation/bundleresources/information_property_list/nsapptransportsecurity). * **Schémas personnalisés sur mobile** : Les liens profonds comme `votre-app://chemin` peuvent ne pas fonctionner comme launch URL sur toutes les plateformes. Utilisez le champ **Additional Data** ou consultez [Deep Linking](./deep-linking) pour un routage fiable dans l'application. * **Comportement par défaut du web push** : Si aucune launch URL n'est définie, le web push ouvre votre page d'accueil. Définissez une launch URL explicitement pour contrôler la destination. * **Interférence du suivi des clics** : Dans les e-mails, la réécriture des liens pour le suivi des clics peut casser les liens profonds. Essayez de [désactiver le suivi des clics](#suivi-des-liens-dans-les-e-mails) pour ce lien spécifique. ### Les paramètres UTM fonctionnent-ils avec les e-mails et les SMS ? Non. Le balisage UTM automatique s'applique uniquement aux notifications push envoyées depuis le tableau de bord. Pour les e-mails et les SMS, ajoutez manuellement les paramètres UTM aux URL dans vos templates ou charges utiles API. Consultez [Paramètres UTM](#paramètres-utm) pour la liste complète des limitations. ### Puis-je empêcher une notification push d'ouvrir une URL ? Sur mobile, cliquer sur une notification push ouvre toujours l'application. Sur le web, ajoutez `?_osp=do_not_open` à la launch URL pour ignorer la notification sans ouvrir aucune page. Voir le [conseil Launch URL](#launch-url) pour un exemple. *** Configurez les schémas d'URL personnalisés et le routage spécifique à l'application pour les messages push et in-app. Insérez des données utilisateur dynamiques dans les messages grâce à la syntaxe Liquid et aux tags. Guide de référence pour les filtres, balises et variables Liquid dans les templates OneSignal. Consultez les métriques de livraison, d'ouverture et de taux de clics pour vos campagnes e-mail. Ajoutez des boutons d'appel à l'action aux notifications push avec des URL personnalisées.