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.

Lien profond vers du contenu in-app

Qu’est-ce que la création de liens profonds ?

La création de liens profonds est un moyen de lancer une application native et de lui fournir des informations supplémentaires pour effectuer une action spécifique ou afficher un contenu spécifique.

Cela comporte trois parties :

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

Les liens profonds sont des URI personnalisés qui renvoient vers une partie spécifique de l’application et contiennent ces trois éléments. L’essentiel est de définir 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 éviter 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 lien profond 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.

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 servir à 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 classiques (web) et les liens profonds, et suivies à l’aide de Google Analytics.

Calculs des balises UTM

Braze rapporte le Total des clics pour tous les liens d’une campagne ou d’une étape du 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 classiques (web) (par exemple, pour l’attribution de campagne de vos campagnes 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 campagnes Braze comme n’importe quel autre lien.

Pour utiliser des balises UTM dans les liens profonds vers votre application, celle-ci doit avoir le SDK Google Analytics approprié intégré et correctement configuré pour gérer les liens profonds. 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 liens profonds dans les campagnes Braze. Pour configurer les balises UTM pour votre campagne, incluez les balises UTM nécessaires dans l’URL de destination ou les liens profonds. 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 sur les messages in-app avec les balises UTM

• ouvertures push
• clics sur les 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 votre 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 diriger les utilisateurs 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 à 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 personnalisées. Voici quelques exemples :

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

Nous raccourcissons les URL générées par Liquid, y compris celles incluses dans les propriétés de déclenchement 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 API uniquement via l’endpoint /messages/send. Pour une liste complète des paramètres de requête, consultez les paramètres de requête.