URLs, liens et liens profonds

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

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.

Deep Linking

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 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 grâce à la propriété additionalData — utile lorsque vous avez besoin de plus de flexibilité qu’une simple URL.

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.

Pour les liens de désinscription, consultez 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

Comment le suivi des clics dans les e-mails réécrit les URL

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. Par exemple :https://some-domain.com/the-pagedevient 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 :

{{ '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 :

{{ 'https://some-domain.com/the-page' | do_not_track_link }}

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.

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

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

User properties
Tags
custom_data
Custom Events

Injectez des valeurs telles que external_id ou email directement dans les URL.

https://yourdomain.com/profile/user={{subscription.external_id}}

Si le external_id de l’User est 12345, l’URL finale est :

https://yourdomain.com/profile/user=12345

De même :

https://yourdomain.com/profile/email={{subscription.email}}

Si l’e-mail de l’User est john@example.com, l’URL finale est :

https://yourdomain.com/profile/email=john@example.com

Référencez les tags utilisateur stockés dans OneSignal.

https://yourdomain.com/topic/{{tag_key}}

Si l’User a un tag tag_key avec la valeur technology, l’URL finale est :

https://yourdomain.com/topic/technology

Si tag_key n’est pas défini, l’URL devient :

https://yourdomain.com/topic/

Utilisez le filtre default pour définir une valeur de repli :

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 :

https://yourdomain.com/invoice={{message.custom_data.invoice_number}}

Requête API avec custom_data :

{
    "template_id": "YOUR_TEMPLATE_ID",
    "custom_data": {
        "invoice_number": "12345"
    }
}

URL finale :

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 :

https://yourdomain.com/order/{{ journey.event.purchase.properties.order_id }}

Si le dernier événement purchase inclut "order_id": "98765", l’URL finale est :

https://yourdomain.com/order/98765

Assigner l’événement pour plus de lisibilité :

{% assign event = journey.event.purchase %}
https://yourdomain.com/order/{{ event.properties.order_id }}

Accéder à l’événement le plus récent stocké :

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

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

Automatic UTMs for push notifications

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 :

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.
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 : 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.
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 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 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 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 pour un exemple.

Deep Linking

Configurez les schémas d’URL personnalisés et le routage spécifique à l’application pour les messages push et in-app.

Personalization

Insérez des données utilisateur dynamiques dans les messages grâce à la syntaxe Liquid et aux tags.

Using Liquid syntax

Guide de référence pour les filtres, balises et variables Liquid dans les templates OneSignal.

Email message reports

Consultez les métriques de livraison, d’ouverture et de taux de clics pour vos campagnes e-mail.

Action buttons

Ajoutez des boutons d’appel à l’action aux notifications push avec des URL personnalisées.

Premiers pas et paramètres

Canaux de messagerie

Journeys

Audience et événements personnalisés

Analyses et intégrations

Confidentialité et sécurité

URLs, liens et liens profonds

Comment fonctionnent les liens

Liens profonds

Deep Linking

Push

Launch URL

Additional data

Suivi des liens dans les e-mails

Liens SMS/RCS traçables

URL dynamiques

Paramètres UTM

Gestion des URL et substitutions

FAQ

Comment créer un lien vers l’app store ?

Puis-je créer un lien vers une autre application ?

Pourquoi ma launch URL ne fonctionne-t-elle pas ?

Les paramètres UTM fonctionnent-ils avec les e-mails et les SMS ?

Puis-je empêcher une notification push d’ouvrir une URL ?

Deep Linking

Personalization

Using Liquid syntax

Email message reports

Action buttons

Premiers pas et paramètres

Canaux de messagerie

Journeys

Audience et événements personnalisés

Analyses et intégrations

Confidentialité et sécurité

​Comment fonctionnent les liens

​Liens profonds

Deep Linking

​Push

​Launch URL

​Additional data

​Suivi des liens dans les e-mails

​Liens SMS/RCS traçables

​URL dynamiques

​Paramètres UTM

​Gestion des URL et substitutions

​FAQ

​Comment créer un lien vers l’app store ?

​Puis-je créer un lien vers une autre application ?

​Pourquoi ma launch URL ne fonctionne-t-elle pas ?

​Les paramètres UTM fonctionnent-ils avec les e-mails et les SMS ?

​Puis-je empêcher une notification push d’ouvrir une URL ?

Deep Linking

Personalization

Using Liquid syntax

Email message reports

Action buttons

Comment fonctionnent les liens

Liens profonds

Push

Launch URL

Additional data

Suivi des liens dans les e-mails

Liens SMS/RCS traçables

URL dynamiques

Paramètres UTM

Gestion des URL et substitutions

FAQ

Comment créer un lien vers l’app store ?

Puis-je créer un lien vers une autre application ?

Pourquoi ma launch URL ne fonctionne-t-elle pas ?

Les paramètres UTM fonctionnent-ils avec les e-mails et les SMS ?

Puis-je empêcher une notification push d’ouvrir une URL ?