Aliasage de lien
Utilisez l’aliasage de lien pour créer des noms reconnaissables, générés par l’utilisateur, afin d’identifier les liens envoyés dans les e-mails depuis Braze. Ces liens sont disponibles pour le reciblage par segmentation, le déclenchement basé sur les actions et l’analyse des liens.
À propos de l’aliasage de lien
L’aliasage de lien vous permet de créer des noms générés par l’utilisateur pour identifier et suivre les liens envoyés dans les e-mails. Vous pouvez ainsi utiliser efficacement ces alias de lien reconnaissables dans vos e-mails pour suivre l’engagement et analyser les performances des campagnes, sans avoir besoin de référencer le lien complet.
Avec l’aliasage de lien, vous pouvez :
- Recibler les utilisateurs qui ont cliqué sur des liens spécifiques : identifier et cibler les utilisateurs qui ont cliqué sur un lien.
- Créer des déclencheurs basés sur les actions : envoyer un e-mail lorsqu’un utilisateur clique sur un lien.
- Analyser les indicateurs : comparer combien d’utilisateurs ont cliqué sur le lien A par rapport au lien B.
Comment ça fonctionne
Braze identifie de manière unique les liens dans les e-mails en ajoutant un paramètre supplémentaire appelé lid (également connu sous le nom d’identifiant de lien) à chaque URL de lien. Cette valeur lid permet à Braze de suivre, surveiller et agréger les interactions des utilisateurs avec le lien, même si les autres paramètres de l’URL peuvent différer. Cela permet de fournir des informations sur la façon dont les utilisateurs interagissent avec le contenu de vos campagnes par e-mail.
Les identifiants de lien seront également mis à jour si une campagne par e-mail, un Canvas avec un message e-mail ou un Content Block est dupliqué.
Créer un alias de lien

Link Management apparaît dans le compositeur d’e-mail de la Campaign ou du Canvas lorsque Braze active la gestion des liens pour votre compte. Pour créer et modifier des alias de lien, l’aliasage de lien doit être activé. Si Link Management est absent, contactez votre gestionnaire de compte pour activer l’aliasage de lien.
Pour créer un alias de lien, ouvrez le corps de votre e-mail dans la Campaign ou le composant Canvas, puis ouvrez Link Management depuis la zone Content. Les compositeurs glisser-déposer et HTML utilisent la même disposition de barre latérale :
Éditeur glisser-déposer
- Sélectionnez Edit Email Body pour ouvrir le compositeur glisser-déposer.
- Dans la barre latérale du compositeur, sélectionnez Content (à côté de Sending Settings et Preview & Test). Pour en savoir plus sur cette disposition, consultez Créer un e-mail avec le glisser-déposer.
- Dans le sous-menu Content, sélectionnez Link Management (il apparaît sous Design and Build). Si le sous-menu est réduit, développez-le à l’aide de la flèche de contrôle dans la barre latérale.
Éditeur HTML
- Accédez au corps de votre e-mail dans le compositeur.
- Dans la barre latérale du compositeur, sélectionnez Content.
- Dans le sous-menu Content, sélectionnez Link Management sous Design and Build.
Dans Link Management :
- Braze génère automatiquement des alias de lien par défaut uniques pour chacun de vos liens.
- Donnez un nom à l’alias. Les alias doivent être nommés de manière unique par variante de Campaign par e-mail ou composant Canvas.
Vous pouvez également définir un alias qui sera utilisé pour référencer un lien spécifique lors du traitement des rapports ou de la segmentation.


L’aliasage de lien est uniquement pris en charge dans les attributs href au sein des balises d’ancrage HTML où il est possible d’ajouter un paramètre de requête en toute sécurité. Il est recommandé d’inclure un point d’interrogation (?) à la fin de votre lien afin que Braze puisse facilement ajouter la valeur lid. Sans l’ajout de la valeur lid, Braze ne reconnaîtra pas l’URL pour l’aliasage de lien.
Gérer les alias de lien
Pour afficher tous vos alias de lien suivis, procédez comme suit :
- Accédez à Settings > Email Preferences sous Workspace Settings.
- Sélectionnez l’onglet Link Aliasing Settings.

Si vous utilisez l’ancienne navigation, ces paramètres se trouvent sous Gérer les paramètres.
Ici, vous pouvez trier, rechercher et désactiver le suivi des alias de lien.


Utilisez les endpoints Lister les alias de lien pour une Campaign et Lister les alias de lien pour un Canvas pour extraire l’alias défini dans chaque variante de message d’une Campaign ou d’un composant Canvas spécifique aux e-mails.
Braze recommande d’évaluer les liens dans l’e-mail, d’ajouter des modèles de lien et de fournir une convention de nommage adaptée à la segmentation et aux rapports. Cela vous aide à garder une trace de tous les liens.
Lorsque l’aliasage de lien est activé, les messages, les Content Blocks et les modèles de lien ne sont pas modifiés. Tous les messages existants utilisant des modèles de lien ou des Content Blocks resteront identiques. Cependant, lorsque vous mettez à jour un message, le balisage d’alias de lien s’appliquera à tous les liens, vous devrez donc réappliquer les modèles de lien pour que les liens soient visibles.
Comment les liens sont mis à jour avec l’aliasage de lien
Les tableaux suivants fournissent des exemples de liens dans le corps d’un e-mail, les résultats de l’aliasage de lien et des explications sur la façon dont le lien original est mis à jour avec l’aliasage de lien.
Permalien
Logique : Braze insère un point d’interrogation (?) et ajoute le premier paramètre de requête dans l’URL.
| Lien dans le corps de l’e-mail | Lien avec aliasage |
|---|---|
https://www.braze.com |
https://www.braze.com?lid=slfdldtqdhdk |
Lien avec des paramètres de requête supplémentaires
Logique : Braze détecte d’autres paramètres de requête et ajoute lid= à la fin de l’URL.
| Lien dans le corps de l’e-mail | Lien avec aliasage |
|---|---|
https://www.braze.com?utm_campaign=retention&utm_source=email |
https://www.braze.com?utm_campaign=retention&utm_source=email&lid=0goty30mviyz |
Lien HTML
Logique : Braze reconnaît qu’un lien est une URL et qu’un point d’interrogation (?) est déjà présent, le paramètre de requête lid est donc ajouté après le point d’interrogation.
| Lien dans le corps de l’e-mail | Lien avec aliasage |
|---|---|
<a href="{{custom_attribute.{product_url}}}?"> |
<a href="{{custom_attribute.{product_url}}}?lid=ac7a548g5kl7"> |
Lien avec ancre
Logique : Braze s’attend à ce que l’URL utilise une structure standard où les ancres (#) sont présentes après un point d’interrogation (?). Comme Braze lit de gauche à droite, le point d’interrogation et la valeur lid sont ajoutés avant l’ancre.
| Lien dans le corps de l’e-mail | Lien avec aliasage |
|---|---|
https://www.braze.com#bookmark1?utm_source=email |
https://www.braze.com?lid=eqslgd5a9m3y#bookmark1?utm_source=email |
Lien avec ancre et balise de capture
Logique : Lors de l’utilisation de l’aliasage de lien avec des URL contenant des ancres (#), Braze s’attend à ce que l’ancre soit placée après les paramètres de requête. Cela signifie que la valeur lid doit être ajoutée avant l’ancre pour un suivi correct, et comme Braze lit l’URL de gauche à droite, le point d’interrogation (?) et le lid doivent précéder l’ancre.
| Lien dans le corps de l’e-mail | Lien avec aliasage |
|---|---|
<a href="https://www.braze.com/promotions#special-offer">Check out our special offer!</a> |
<a href="https://www.braze.com/promotions?lid={{link_alias}}#special-offer">Check out our special offer!</a> |
Suivi des alias de lien
Dans la barre latérale du compositeur, sélectionnez Content > Link Management (sous Design and Build), puis sélectionnez les alias que vous souhaitez marquer comme suivis. Les alias suivis sont disponibles dans les filtres de segmentation qui référencent les alias de lien (voir Filtres de segmentation). Vous pouvez également envoyer des messages basés sur les actions ou faire avancer les utilisateurs dans un Canvas lorsqu’ils cliquent sur un alias de lien dans un e-mail — voir Filtres basés sur les actions. Le paramètre suivi ne modifie pas la comptabilisation des clics sur ce lien dans les rapports de performances des e-mails.

Pour suivre les indicateurs d’engagement des liens, assurez-vous que votre lien commence par HTTP ou HTTPS. Pour désactiver le suivi des clics pour des liens spécifiques, consultez Liens universels et App Links.
Braze vous permet de sélectionner un nombre illimité de liens à suivre, mais vous ne pouvez recibler les utilisateurs que sur les liens les plus récents sur lesquels ils ont cliqué. Les profils utilisateur incluent les 100 liens les plus récemment cliqués. Par exemple, si vous suivez 500 liens et qu’un utilisateur clique sur les 500, vous pouvez recibler ou créer des segments basés sur les 100 liens les plus récemment cliqués.


Braze ne suit que les 100 derniers alias de lien cliqués au niveau du profil.
Filtres basés sur les actions
Vous pouvez créer des messages basés sur les actions ciblant n’importe quel lien (suivi ou non suivi) ou recibler les utilisateurs selon qu’ils ont cliqué sur un alias dans n’importe quelle Campaign par e-mail ou composant Canvas.

Filtres de segmentation
Dans Braze, si vous avez un alias de lien dans votre e-mail et qu’un utilisateur clique dessus, l’événement est enregistré dans le profil de l’utilisateur avec l’alias.
Si vous utilisez le filtre de segmentation « A cliqué sur un alias dans n’importe quelle Campaign ou étape Canvas » et que vous décidez ensuite de renommer cet alias de lien, les données de clics précédentes dans le profil utilisateur ne sont pas mises à jour, ce qui signifie qu’elles affichent toujours l’ancien alias de lien. Ainsi, si vous ciblez des utilisateurs en fonction du nouvel alias de lien, cela n’inclura pas les données de l’ancien alias de lien.
Si vous utilisez le filtre de segmentation « A cliqué sur un alias dans une Campaign » ou « A cliqué sur un alias dans un Canvas », ce filtre sélectionne vos utilisateurs selon qu’ils ont cliqué sur un alias spécifique dans une Campaign ou un Canvas spécifique. Si plusieurs utilisateurs partagent la même adresse e-mail et que l’alias de lien est cliqué, tous les autres utilisateurs partageant cette adresse e-mail voient leur profil utilisateur mis à jour. Ces profils sont également mis à jour par les événements de réception et d’ouverture, pas seulement par les événements de clic.
Les filtres de segmentation suivants s’appliquent aux événements de clic qui sont suivis au moment où l’événement est traité. Cela signifie que le fait de ne plus suivre des liens ne supprimera pas les données existantes et que le suivi d’un lien ne remplira pas rétroactivement les données. Pour plus de détails, consultez Filtres de segmentation.
Arrêt du suivi des liens
L’arrêt du suivi d’un lien ne réaffectera pas les segments existants avec le filtre vers l’alias non suivi. Les anciennes données resteront dans les profils utilisateur jusqu’à ce qu’elles soient remplacées par des données plus récentes.
Les liens dans les messages archivés ne sont plus suivis automatiquement. Cependant, si des messages archivés sont désarchivés, les liens devront être suivis à nouveau. Lorsque les alias de lien sont suivis, les rapports de lien sont indexés par l’alias au lieu des domaines de premier niveau ou des URL complètes.
Pour afficher tous les liens de votre Campaign par e-mail et leurs clics totaux respectifs, accédez à Message Analytics > Email Performance > Preview & Heatmap, et sélectionnez le bouton bascule Show Heatmap.

Événement de clic sur un e-mail
Si vous exportez vos données d’engagement avec Currents, un événement de clic sur un e-mail sera légèrement différent si l’aliasage de lien est activé. Il comportera deux champs supplémentaires pour l’événement de clic sur un e-mail lorsque l’aliasage de lien est activé : link_id et link_alias.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Email Click: users.messages.email.Click
{
"id": (string) unique ID of this event,
"user_id": (string) Braze user ID of the user,
"external_user_id": (string) External ID of the user,
"time": (int) 10-digit UTC time of the event in seconds since the epoch,
"timezone": (string) IANA time zone of the user at the time of the event,
"campaign_id": (string) ID of the campaign if from a campaign,
"campaign_name": (string) name of the campaign,
"message_variation_id": (string) ID of the message variation if from a campaign,
"message_variation_name": (string) the name of the message variation if from a campaign,
"canvas_id": (string) ID of the Canvas if from a Canvas,
"canvas_name": (string) name of the Canvas,
"canvas_variation_id": (string) ID of the Canvas variation the user is in if from a Canvas,
"canvas_variation_name": (string) name of the Canvas variation the user is in if from a Canvas,
"canvas_step_id": (string) ID of the step for this message if from a Canvas,
"canvas_step_name": (string) name of the step for this message if from a Canvas,
"send_id": (string) ID of the message if specified for the campaign (See Send Identifier under API Identifier Types),
"dispatch_id": (string) ID of the message dispatch (unique ID for each 'transmission' sent from the Braze platform). Users who are sent a schedule message get the same dispatch_id. Action-based or API-triggered messages get a unique dispatch_id per user.,
"email_address": (string) email address for this event,
"url": (string) the URL that was clicked (Email Click events only),
"user_agent": (string) description of the user's system and browser for the event (Email Click and Open events only),
"ip_pool": (string) IP pool used for message sending,
"link_id": (string) unique value generated by Braze for the URL,
"link_alias": (string) alias name set when the message was sent
}

Le comportement de dispatch_id diffère entre Canvas et les Campaigns car Braze traite les étapes Canvas (à l’exception des étapes d’entrée, qui peuvent être planifiées) comme des événements déclenchés, même lorsqu’elles sont « planifiées ». En savoir plus sur le comportement de dispatch_id dans Canvas et les Campaigns.
Mise à jour notée en août 2019.
Aliasage de lien dans les Content Blocks
Les nouveaux Content Blocks verront leurs liens modifiés, Braze ajoutant un lid= à chaque lien le cas échéant. Cette valeur de marque substitutive est résolue lors de l’insertion dans une variante de message e-mail.
Pour modifier les liens dans les Content Blocks existants qui ont été créés avant que Braze n’active l’aliasage de lien, dupliquez les Content Blocks existants, puis modifiez les liens dans les Content Blocks dupliqués.
Lorsqu’un Content Block sans valeur lid est inséré dans un nouveau message, les liens de ce Content Block ne sont pas suivis avec un alias. Lorsqu’un nouveau Content Block est inséré dans une « ancienne » variante de message, les liens de cette variante de message seront reconnus par l’aliasage de lien. Les liens du Content Block sont également reconnus. Cependant, les « anciens » Content Blocks ne peuvent pas imbriquer de « nouveaux » Content Blocks.

Pour les Content Blocks, Braze recommande de créer des copies des Content Blocks existants à utiliser dans les nouveaux messages. Cela peut être fait par duplication en masse pour éviter les scénarios où vous pourriez référencer un Content Block qui n’a pas été activé pour l’aliasage de lien dans un nouveau message.
Aliasage de lien pour les URL générées par Liquid
Pour les URL générées par Liquid (par exemple, assign dans le HTML, valeurs extraites d’un Content Block ou Liquid dans un attribut personnalisé), Braze a besoin d’un emplacement clair pour insérer le paramètre de requête lid. Dans la plupart des cas, lorsque du Liquid reste dans l’URL, Braze ne déduit pas s’il faut commencer une nouvelle chaîne de requête avec ? ou joindre une requête existante avec &, sauf si vous ajoutez ce délimiteur vous-même.
Procédez comme suit :
- Si l’URL ne contient pas déjà de chaîne de requête, ajoutez
?après le Liquid (par exemple,?). - Si l’URL contient déjà
?et des paramètres de requête, ajoutez&après le Liquid (par exemple,&).

Lorsque vous utilisez des modèles de lien avec des URL générées par Liquid, Braze peut normaliser de manière conservatrice l’URL rendue après l’exécution du Liquid lorsqu’elle contient exactement deux caractères ? utilisés comme séparateurs de requête. Le second ? peut être réécrit en & afin que Braze modifie le moins possible l’URL.
Braze n’essaie pas de corriger tous les cas de ? en double, et le traitement des URL plus complexes reste intentionnellement limité. Ajoutez le bon ? ou & dans votre balisage en premier lieu, et considérez toute normalisation comme une protection limitée — pas comme un substitut à des URL bien formées ou à la reconnaissance des liens dans Link Management lorsqu’aucun délimiteur n’est présent.
Sans un ? ou & final (ou un autre point d’insertion pris en charge), l’aliasage de lien ne reconnaît pas l’URL, Link Management ne la liste pas et les modèles de lien ne s’appliquent pas.
Fragments d’URL (#) et paramètres de suivi
Le fragment (# et tout ce qui suit) n’est pas envoyé au serveur lors d’une requête de lien normale. Braze insère lid dans la chaîne de requête, qui doit apparaître avant le #. Si votre href contient du Liquid et un fragment # mais pas de ? ou & avant le #, Braze ne peut pas ajouter lid en toute sécurité, et le lien peut ne pas apparaître dans Link Management ni être suivi comme alias de lien.
Cela est particulièrement courant dans l’éditeur glisser-déposer lorsqu’une URL de bouton mélange du Liquid avec un modèle basé sur un hash (par exemple, un chemin statique, puis #, puis des paires clé-valeur supplémentaires). Dans ce cas, ajoutez ? immédiatement avant le # afin que la chaîne de requête (y compris lid) soit analysée avant le fragment.
1
https://example.com/campaign/to/abc123?#user_id={{${user_id}}}&source=email
Dans l’exemple précédent, le ? avant # donne à Braze un segment de requête auquel ajouter lid. Sans cela, le lien peut ne pas apparaître dans Link Management.
Considérations pour l’éditeur glisser-déposer
Dans l’éditeur glisser-déposer, les champs contenant un lien (comme l’URL d’un bouton) valident le href sous-jacent avant l’exécution du Liquid. Les espaces, sauts de ligne et autres caractères non compatibles avec les URL peuvent provoquer un comportement inattendu lorsque Braze ajoute des modèles de lien ou des paramètres d’aliasage de lien. Lorsque vous avez besoin de Liquid conditionnel pour la destination, définissez l’URL dans un bloc HTML (voir la section suivante) et référencez une seule variable dans le champ URL du glisser-déposer au lieu de placer du Liquid complexe directement dans ce champ.
Exemple avec un Content Block
Si un Content Block contient un lien tel que https://www.braze.com/} sans ? ou & final, Braze ne sait pas où ajouter lid, et le lien n’est pas pris en compte pour Link Management. Ajoutez ? ou & à la fin de l’URL dans le Content Block (selon qu’une chaîne de requête existe déjà ou non), enregistrez le Content Block, et le lien pourra être reconnu.
Rapports lorsque l’URL varie par utilisateur
Chaque href distinct dans le message correspond à un identifiant de lien et un alias de lien pour Link Management et les rapports basés sur les alias. Lorsque les alias de lien sont suivis, les rapports e-mail dans le tableau de bord sont indexés par l’alias plutôt que par chaque URL résolue possible.
Utilisez d’abord les approches suivantes dans Braze :
- Analyse des e-mails de Campaign et Canvas : consultez les clics agrégés par lien depuis Message Analytics > Email Performance > Preview & Heatmap avec Show Heatmap activé, comme décrit dans Arrêt du suivi des liens.
- Clics par destinataire dans le générateur de requêtes : exécutez le modèle du générateur de requêtes Email URLs clicked pour une Campaign ou un Canvas. Le modèle affiche des liens dépersonnalisés pour les comptages résumés ; l’export CSV inclut les ID utilisateur des cliqueurs, le lien sur lequel ils ont cliqué et un horodatage. (Les URL dépersonnalisées suppriment les balises Liquid pour la vue résumée ; consultez la description du modèle pour plus de détails.)
- Ventilations par alias dans le compositeur : si vous avez besoin que chaque destination (par exemple, chaque
offer_id) apparaisse comme sa propre ligne dans Link Management et dans les rapports basés sur les alias, utilisez des valeurshrefdistinctes (et donc des alias distincts) — par exemple, des liens distincts par branche — au lieu d’un seul lien dont le chemin change par utilisateur.
Si vous utilisez également des exports d’engagement en streaming, les événements de clic sur un e-mail incluent un champ url ; consultez Événement de clic sur un e-mail sur cette page pour savoir comment ce payload est lié à l’aliasage de lien.
Exemple
Utilisez ce modèle lorsque l’URL assignée n’a pas de paramètres de requête :
1
2
3
{% assign link1 = "https://www.braze1.com" %}
<a href="{{link1}}?">Visit Braze</a>
Si l’URL assignée contient déjà ? et des paramètres de requête, ajoutez & après le Liquid au lieu de ? :
1
2
3
{% assign link_with_params = "https://www.braze1.com?campaign=test" %}
<a href="{{link_with_params}}&">Visit Braze</a>
URL avec Liquid conditionnel
Lorsque des balises Liquid conditionnelles sont utilisées à l’intérieur d’un href (par exemple, pour définir une URL avec {% if %}, {% elsif %} ou {% unless %}), l’aliasage de lien ne s’applique pas à ces liens. Cela signifie que ces liens n’apparaissent pas dans Link Management et ne reçoivent pas de lid pour le suivi des clics.
Recommandé : construisez l’URL finale dans un bloc HTML avec assign (ou {% capture %}), puis référencez cette variable partout où vous avez besoin du lien. Dans l’éditeur glisser-déposer, collez la variable dans le champ URL du bouton avec un ? ou & final selon le cas — par exemple, ?.
1
2
3
4
5
{% if {{custom_attribute.${account_tier}}} == "pro" %}
{% assign url = "https://example.com/pro/verify" %}
{% else %}
{% assign url = "https://example.com/retail/account" %}
{% endif %}
Dans le champ URL du bouton (glisser-déposer) ou en HTML, pointez le href vers la variable avec un délimiteur :
1
<a href="{{ url }}?">Go to account</a>
Vous pouvez également capturer l’URL dans une seule variable :
1
2
3
4
5
6
7
8
9
{% capture url %}
{%- if condition -%}
https://example.com/url1
{%- else -%}
https://example.com/url2
{%- endif -%}
{% endcapture %}
<a href="{{ url }}?">Go to account</a>