Personnaliser les URL d’action et de média avec Liquid

Personnalisez les destinations des liens et le contenu pour chaque utilisateur qui reçoit votre message en ajoutant des variables Liquid aux URL des boutons, liens, images et vidéos.

Deep link vers du contenu in-app

Conseil

Pour les développeurs : Pour un guide sur le choix entre les schémas personnalisés, les liens universels et d’autres options — y compris quand vous avez besoin d’un fichier AASA, quelles méthodes de délégué d’application implémenter et comment déboguer les problèmes — consultez le Guide des deep links iOS et la Résolution des problèmes de deep linking.

Qu’est-ce que le deep linking ?

Le deep linking est un moyen de lancer une application native et de fournir des informations supplémentaires lui indiquant d’effectuer une action spécifique ou d’afficher un contenu spécifique.

Il se compose de trois parties :

1. Identifier l’application à lancer.
2. Indiquer à l’application l’action à effectuer.
3. Fournir à l’action les données supplémentaires dont elle aura besoin.

Les deep links sont des URI personnalisés qui renvoient vers une partie spécifique de l’application et contiennent ces trois éléments. L’élément clé est la définition d’un schéma personnalisé. http: est le schéma que presque tout le monde connaît, mais les schémas peuvent commencer par n’importe quel mot. Un schéma doit commencer par une lettre, mais peut ensuite contenir des lettres, des chiffres, des signes plus, des signes moins ou des points. En pratique, il n’existe pas de registre central pour prévenir les conflits, il est donc recommandé d’inclure votre nom de domaine dans le schéma. Par exemple, twitter:// est l’URI iOS pour lancer l’application mobile de X, anciennement Twitter.

Tout ce qui suit les deux-points dans un deep link est du texte libre. C’est à vous de définir sa structure et son interprétation ; cependant, une convention courante consiste à le modéliser d’après les URL http:, en incluant un // initial et des paramètres de requête (par exemple, ?foo=1&bar=2). Pour l’exemple précédent, twitter://user?screen_name=[id] serait utilisé pour lancer un profil spécifique dans l’application.

Important

Pour les applications construites avec des frameworks wrapper (par exemple, Flutter ou Cordova), Braze ne fournit pas de support de deep linking spécifique au wrapper. Vous devez configurer les deep links au niveau natif iOS et Android. Pour Cordova, consultez Deep linking dans les notifications push.

Schémas d’URI système

Les schémas d’URI standard gérés nativement par iOS et Android (tels que tel:, mailto: et sms:) peuvent être saisis directement dans le champ d’URL du deep link sans nécessiter d’intégration de deep link personnalisée dans votre application.

Ceux-ci fonctionnent pour les comportements au clic des notifications push et les actions des boutons de messages in-app. Aucune configuration supplémentaire du SDK ni modification du code de l’application n’est nécessaire.

Balises UTM et attribution de campagne

Qu’est-ce qu’une balise UTM ?

Les balises UTM (Urchin Traffic Manager) vous permettent d’inclure des détails d’attribution de campagne directement dans les liens. Les balises UTM sont utilisées par Google Analytics pour collecter des données d’attribution de campagne et peuvent être utilisées pour suivre les propriétés suivantes :

• utm_source : L’identifiant de la source du trafic (par exemple, my_app)
• utm_medium : Le support de la campagne (par exemple, newsfeed)
• utm_campaign : L’identifiant de la campagne (par exemple, spring_2016_campaign)
• utm_term : L’identifiant d’un terme de recherche payante qui a amené l’utilisateur vers votre application ou site web (par exemple, pizza)
• utm_content : Un identifiant pour le lien ou contenu spécifique sur lequel l’utilisateur a cliqué (par exemple, toplink ou android_iam_button2)

Les balises UTM peuvent être intégrées dans les liens HTTP (web) classiques et les deep links, et suivies à l’aide de Google Analytics.

Calculs des balises UTM

Braze rapporte le Total des clics pour tous les liens d’une Campaign ou d’une étape Canvas, ce qui peut inclure des liens sans balises UTM. Cela signifie que vous pouvez voir un résultat différent (souvent inférieur) dans vos liens de suivi de campagne Google Analytics par rapport au Total des clics affiché dans les performances de votre campagne ou le générateur de rapports.

Utiliser les balises UTM avec Braze

Si vous souhaitez utiliser des balises UTM avec des liens HTTP (web) classiques (par exemple, pour l’attribution de campagne de vos Campaigns par e-mail) et que votre organisation utilise déjà Google Analytics, vous pouvez utiliser le générateur d’URL de Google pour générer des liens UTM. Ces liens peuvent être facilement intégrés dans le contenu de vos Campaigns Braze comme n’importe quel autre lien.

Pour utiliser des balises UTM dans les deep links vers votre application, celle-ci doit avoir le SDK Google Analytics approprié intégré et correctement configuré pour gérer les deep links. Vérifiez auprès de vos développeurs si vous n’êtes pas sûr de cela.

Une fois le SDK Analytics intégré et configuré, les balises UTM peuvent être utilisées avec les deep links dans les Campaigns Braze. Pour configurer les balises UTM pour votre campagne, incluez les balises UTM nécessaires dans l’URL de destination ou les deep links. Les exemples suivants montrent comment utiliser les balises UTM dans les notifications push et les messages in-app.

Attribuer les ouvertures push et les clics de messages in-app avec des balises UTM

• ouvertures push
• clics de messages in-app

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=iam&utm_campaign=spring2021giftcards&utm_content=web_link

Utiliser la personnalisation Liquid dans les URL

Vous pouvez construire dynamiquement vos URL directement dans le compositeur Braze, ce qui vous permet d’ajouter des paramètres UTM dynamiques à vos URL ou d’envoyer aux utilisateurs des liens uniques (comme les diriger vers leur panier abandonné ou vers un produit spécifique de nouveau en stock).

Créer une URL avec des balises de personnalisation Liquid prises en charge

Les URL peuvent être générées dynamiquement grâce à l’utilisation de n’importe quelle balise de personnalisation Liquid prise en charge.

1
https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}

Nous prenons également en charge le raccourcissement des variables Liquid définies de manière personnalisée, comme dans les exemples suivants :

Créer une URL à l’aide de variables Liquid

1
2
{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}

Raccourcir les URL générées par des variables Liquid

Canaux pris en charge : KakaoTalk, LINE, SMS, RCS, WhatsApp

Nous raccourcissons les URL générées par Liquid, y compris celles incluses dans les propriétés de déclenchement par API. Par exemple, si {{api_trigger_properties.${url_value}}} représente une URL valide, nous raccourcissons et suivons cette URL avant d’envoyer le message.

Raccourcir les URL dans l’endpoint /messages/send

Le raccourcissement de liens est également activé pour les messages envoyés uniquement par API via l’endpoint /messages/send. Pour une liste complète des paramètres de requête, consultez les paramètres de requête.