Créer un Canvas
Utilisez Canvas lorsque vous souhaitez guider les utilisateurs à travers un parcours en plusieurs étapes. Canvas relie des délais, des prises de décision et des messages afin que vous puissiez créer des expériences ramifiées en fonction de ce que font les utilisateurs et du moment où ils le font. Pour une étape de communication unique sur un ou plusieurs canaux, utilisez les Campaigns.
Prérequis
- Autorisations pour créer et lancer des Canvas (consultez Autorisations)
- Des Segments ou des filtres qui définissent qui doit entrer dans le Canvas
Avant de commencer
- Consultez les principes de base de Canvas pour aligner l’entrée, les messages et les objectifs de conversion sur votre cas d’usage.
- Pour une présentation guidée, suivez le cours Braze Learning sur Canvas.
- Partez d’un modèle de Canvas Braze, ou demandez à Operator de rédiger un Canvas à partir de vos consignes.
Étape 1 : Définir les bases du Canvas
- Accédez à Messaging > Canvas.
- Sélectionnez Create Canvas.
- Nommez votre Canvas, assignez des Teams et créez ou ajoutez des tags. Vous pouvez également attribuer des événements de conversion au Canvas.

Étiquetez vos Canvas pour les retrouver facilement et en tirer des rapports. Par exemple, lorsque vous utilisez le générateur de rapports, vous pouvez filtrer par tags spécifiques.
Choisir les événements de conversion
Choisissez votre type d’événement de conversion, puis sélectionnez les conversions à enregistrer. Ces événements de conversion mesurent l’efficacité de votre Canvas.
Si votre Canvas comporte plusieurs variantes ou un groupe de contrôle, Braze utilise cet événement de conversion pour déterminer la meilleure variation permettant d’atteindre cet objectif de conversion. En suivant la même logique, vous pouvez créer plusieurs événements de conversion.
Étape 2 : Choisir un calendrier d’entrée
Vous pouvez choisir l’une des trois façons dont les utilisateurs peuvent entrer dans votre Canvas.
Avec la livraison planifiée, les utilisateurs entrent selon un calendrier défini, de la même manière que vous planifiez une Campaign. Vous pouvez inscrire des utilisateurs dans un Canvas dès son lancement, les faire entrer dans votre parcours à un moment futur, ou de manière récurrente (quotidienne, hebdomadaire ou mensuelle).
Si vous sélectionnez un calendrier récurrent mensuel, notez que certains mois peuvent ne pas comporter le jour sélectionné. Par exemple, supposons que vous configurez un Canvas pour un envoi mensuel le 31e jour. Dans ce cas, Braze envoie le dernier jour de ce mois, comme le 30 avril, car le 31 avril n’existe pas.
Lors de l’utilisation de la livraison en fuseau horaire local, Braze évalue l’éligibilité à l’entrée deux fois : d’abord à l’heure des Samoa (UTC+13) le jour planifié, puis au fuseau horaire local de l’utilisateur. Un utilisateur doit être éligible aux deux vérifications pour entrer dans le Canvas. Si vos filtres d’entrée utilisent des fenêtres temporelles relatives (par exemple, « il y a plus de 2 jours »), la période de 24 heures peut ne pas s’être écoulée au moment de la première vérification, ce qui provoque l’entrée des utilisateurs avec un jour de retard. Pour éviter cela, utilisez une fenêtre temporelle plus large, d’au moins deux jours. Pour plus de détails, consultez Quand Braze évalue-t-il les utilisateurs pour la livraison en fuseau horaire local ?
Avec la livraison par événement, les utilisateurs entrent dans le Canvas et commencent à recevoir des messages lorsqu’ils effectuent des actions particulières, comme ouvrir votre application, effectuer un achat ou déclencher un événement personnalisé.
Vous pouvez contrôler d’autres aspects du comportement du Canvas depuis la fenêtre Audience d’entrée, y compris les règles de rééligibilité et les paramètres de limite de fréquence. Vous pouvez utiliser l’entrée Canvas par événement avec des étapes de messages in-app. Les messages in-app ne sont pas disponibles dans les étapes classiques basées sur des actions (déclencheur et délai).

Interact with Canvas Step n’est pas disponible en tant que déclencheur d’entrée par événement pour les Canvas. Il ne peut être utilisé que comme déclencheur pour les Campaigns. Pour déclencher un Canvas à partir d’un autre, utilisez le composant Canvas Envoyer vers une destination, ou créez un webhook Braze-à-Braze qui appelle l’endpoint /canvas/trigger/send.

Si votre Canvas par événement envoie des messages plus tôt que prévu, vérifiez que l’horodatage de votre événement personnalisé est envoyé avec l’heure actuelle et non une heure antidatée. Par exemple, si un Canvas par événement comporte un délai de trois heures après qu’un utilisateur effectue un événement personnalisé, Braze utilise l’horodatage envoyé avec l’événement personnalisé pour évaluer ce délai. Si l’horodatage est antidaté de plus de trois heures, Braze considère que le délai est déjà écoulé et envoie le message immédiatement.
Avec la livraison déclenchée par API, les utilisateurs entrent dans votre Canvas et commencent à recevoir des messages après que vous les avez ajoutés via l’endpoint /canvas/trigger/send. Le tableau de bord inclut un exemple de requête cURL.
La clé des propriétés d’entrée dans cette requête dépend des fonctionnalités disponibles dans votre espace de travail :
- Si le tableau de bord affiche Variables de contexte, transmettez les données d’entrée optionnelles dans l’objet
context. - Si le tableau de bord affiche Propriétés d’entrée Canvas, utilisez l’objet hérité
canvas_entry_propertiesaffiché dans l’exemple du tableau de bord.
Par exemple, l’objet destinataire utilise l’une des clés de données d’entrée suivantes :
Variables de contexte :
{"external_user_id": "user_123", "context": {"product_name": "shoes"}}
Propriétés d’entrée Canvas :
{"external_user_id": "user_123", "canvas_entry_properties": {"product_name": "shoes"}}
Vous pouvez utiliser les endpoints suivants pour la livraison déclenchée par API :
Après avoir sélectionné votre méthode de livraison, ajustez les paramètres en fonction de votre cas d’usage, puis continuez à définir votre audience cible.
Comportement de déduplication pour les Canvas utilisant l’éditeur d’origine
Si la fenêtre de rééligibilité est inférieure à la durée maximale du Canvas, un utilisateur peut entrer à nouveau et recevoir les messages de plusieurs composants. Dans le cas limite où la nouvelle entrée d’un utilisateur atteint le même composant que son entrée précédente, Braze déduplique les messages de ce composant.
Si un utilisateur entre à nouveau dans le Canvas, atteint le même composant que son entrée précédente et est éligible à un message in-app pour chaque entrée, l’utilisateur reçoit le message deux fois (en fonction de la priorité des messages in-app) à condition qu’il rouvre une session deux fois.
Étape 3 : Définir l’audience cible
Seuls les utilisateurs qui correspondent aux critères définis peuvent entrer dans le parcours à l’étape Target Audience. Braze évalue donc l’éligibilité de l’audience cible avant que les utilisateurs n’entrent dans le parcours Canvas. Par exemple, pour cibler les nouveaux utilisateurs, vous pouvez sélectionner un Segment d’utilisateurs qui ont utilisé votre application pour la première fois il y a moins d’une semaine.

Dans les espaces de travail qui comportent plusieurs applications, l’éligibilité de l’audience d’entrée dans un Canvas est évaluée uniquement lorsque les utilisateurs entrent dans le Canvas, et non au niveau de chaque étape de message. Pour réserver les étapes de message aux utilisateurs d’une application spécifique, activez Validate audience at message send et ajoutez un Segment ciblant cette application dans les validations de réception de l’étape de message, ou utilisez Liquid au moment de l’envoi. Les filtres tels que Has app ne déterminent pas quelle application reçoit le message.

Évitez de configurer une campagne ou un Canvas basé sur une action avec le même déclencheur que le filtre d’audience (comme un attribut modifié ou un événement personnalisé effectué). Une condition de concurrence peut survenir lorsque l’utilisateur ne fait pas partie de l’audience au moment où il déclenche l’événement, ce qui signifie qu’il ne recevra pas la campagne ou n’entrera pas dans le Canvas.
Comment AND et OR se combinent dans l’audience d’entrée
L’audience d’entrée du Canvas utilise la même logique de Segments et de filtres que les Campaigns. Braze combine chaque critère de manière différente.
| Critères | Mode de combinaison |
|---|---|
| Segments sous Cibler les utilisateurs par segment | Les utilisateurs doivent appartenir à chacun des Segments sélectionnés (AND) |
| Filtres supplémentaires et vos Segments | Les utilisateurs doivent également correspondre aux filtres supplémentaires (AND avec les Segments) |
| Filtres au sein d’un groupe de filtres | Les utilisateurs doivent satisfaire tous les filtres (AND) ou au moins un filtre (OR) |
| Groupes de filtres | Les utilisateurs doivent correspondre à tous les groupes (AND) ou à au moins un groupe (OR) |
Vous pouvez ainsi créer des logiques telles que :
(Segment A AND Segment B) AND ((Filter 1 OR Filter 2) AND (Filter 3 OR Filter 4))(Segment A) AND ((Filter 1 AND Filter 2 AND Filter 3) OR (Filter 4 OR Filter 5 OR Filter 6))
AND signifie qu’un utilisateur doit remplir toutes les conditions de l’énoncé. OR signifie qu’un utilisateur doit remplir au moins une condition. Pour en savoir plus sur les groupes d’exclusion et le ciblage négatif avec OR, ou pour découvrir d’autres exemples, consultez la section Logique de segmentation avec AND et OR.
Tester votre audience
Après avoir ajouté des Segments et des filtres à votre audience cible, vous pouvez vérifier que votre audience est configurée comme prévu en recherchant un utilisateur pour confirmer qu’il correspond aux critères de l’audience.
Sélectionner les contrôles d’entrée
Les contrôles d’entrée déterminent si les utilisateurs sont autorisés à entrer de nouveau dans un Canvas. Vous pouvez également limiter le nombre de personnes pouvant entrer dans ce Canvas selon une cadence choisie, en fonction de votre type de planification d’entrée :
- Planifié : Durée de vie du Canvas ou à chaque exécution planifiée du Canvas
- Par événement : Par heure, par jour ou sur la durée de vie du Canvas
- Déclenché par API : Par heure, par jour ou sur la durée de vie du Canvas
Par exemple, si vous avez un Canvas planifié, que vous sélectionnez Limit entrance volume et que vous définissez le champ Maximum entries sur 500 000 utilisateurs avec Every time Canvas is scheduled comme cadence limite, le Canvas n’envoie qu’à 500 000 utilisateurs par envoi planifié. Pour les Canvas déclenchés par API et par événement, une limite horaire du volume d’entrée s’applique à chaque heure UTC.


Braze déconseille de sélectionner Every time the Canvas is scheduled pour l’IP warming, car cela peut entraîner une hausse des volumes d’envoi.
Définir les critères de sortie
Les critères de sortie déterminent quels utilisateurs vous souhaitez faire sortir d’un Canvas. Si un utilisateur effectue l’événement d’exception ou correspond aux Segments et filtres définis, il ne reçoit plus aucun message.
Calculer la population cible
Dans la section Target Population, vous pouvez consulter un résumé de votre audience, comme les Segments sélectionnés et les filtres supplémentaires, ainsi qu’une répartition du nombre d’utilisateurs joignables par canal de communication. Pour calculer le nombre exact d’utilisateurs joignables dans votre audience cible au lieu de l’estimation par défaut, sélectionnez Calculer les statistiques exactes.
À noter :
- Le calcul des statistiques exactes peut prendre quelques minutes. Cette fonction calcule uniquement les statistiques exactes au niveau du Segment, et non au niveau du filtre ou du groupe de filtres.
- Pendant le chargement des statistiques exactes, une estimation arrondie peut s’afficher. Le chiffre exact apparaît dans la section Reachable Users une fois chargé. Vous pouvez sélectionner Show Additional Stats pour obtenir une répartition détaillée.
- Pour les Segments de grande taille, il est normal d’observer de légères variations, même lors du calcul des statistiques exactes. La précision de cette fonctionnalité est d’au moins 99,999 %.
Pour consulter des statistiques supplémentaires, comme le chiffre d’affaires moyen sur la durée de vie des utilisateurs ciblés, sélectionnez Show Additional Statistics.
Pourquoi le nombre de l’audience cible peut différer du nombre d’utilisateurs joignables
La taille de la population cible affichée dans une campagne ou un Canvas peut différer de la taille de l’audience atteignable pour un segment, même si vous ajoutez directement ce segment dans votre campagne ou votre Canvas sans filtre supplémentaire. Cela peut se produire pour plusieurs raisons :
- Lorsqu’un groupe de contrôle global s’applique à une campagne ou à un Canvas, les utilisateurs de ce groupe de contrôle global sont exclus du décompte des utilisateurs pouvant être atteints.
- La taille de la population cible d’une campagne ou d’un Canvas exclut les utilisateurs qui ne sont pas joignables via les différents canaux de messages ; le comportement diffère d’un canal à l’autre. Par exemple, l’audience atteignable pour une campagne ou un Canvas exclut les utilisateurs qui sont désabonnés, marqués comme spam (pour les e-mails) ou qui ont fait l’objet d’un échec d’envoi définitif (pour les e-mails). Le segment lui-même, en revanche, n’exclut que les désinscriptions lorsqu’il affiche le nombre estimé d’utilisateurs atteignables par e-mail.
- Braze n’envoie des messages SMS qu’aux utilisateurs faisant partie du groupe d’abonnement sélectionné. Par conséquent, la population cible SMS d’une campagne ou d’un Canvas exclura également tous les utilisateurs qui ne font pas partie du groupe d’abonnement sélectionné.
Étape 4 : Sélectionner les paramètres d’envoi
Sélectionnez Send Settings pour modifier vos paramètres d’abonnement, activer la limitation du débit et activer les heures calmes. En activant la limitation du débit ou la limite de fréquence, vous pouvez alléger la pression marketing exercée sur vos utilisateurs et vous assurer de ne pas les sur-solliciter.
Pour les Canvas ciblant les canaux e-mail et notification push, vous pouvez restreindre votre Canvas afin que seuls les utilisateurs qui ont explicitement accepté (opted-in) reçoivent le message (en excluant les utilisateurs abonnés ou désabonnés). Par exemple, supposons que vous ayez trois utilisateurs avec des statuts d’abonnement différents :
- Utilisateur A est abonné aux e-mails et a les notifications push activées. Cet utilisateur ne reçoit pas l’e-mail, mais recevra la notification push.
- Utilisateur B a explicitement consenti aux e-mails, mais n’a pas les notifications push activées. Cet utilisateur recevra l’e-mail, mais ne recevra pas la notification push.
- Utilisateur C a explicitement consenti aux e-mails et a les notifications push activées. Cet utilisateur recevra à la fois l’e-mail et la notification push.
Pour ce faire, configurez les Subscription Settings pour envoyer ce Canvas aux « utilisateurs ayant explicitement accepté uniquement ». Cette option garantit que seuls les utilisateurs ayant explicitement accepté reçoivent votre e-mail, et Braze n’envoie vos notifications push qu’aux utilisateurs pour lesquels les notifications push sont activées par défaut.
Ces paramètres d’abonnement sont appliqués étape par étape, ce qui signifie qu’ils n’ont aucun effet sur l’audience d’entrée. Ce paramètre est donc utilisé pour évaluer l’éligibilité d’un utilisateur à recevoir chaque étape du Canvas.

Avec cette configuration, n’incluez aucun filtre dans l’étape Target Audience qui limite l’audience à un seul canal (par exemple, Foreground Push Enabled = True ou Email Subscription = Opted-In).
Vous pouvez choisir de définir des heures calmes (la période pendant laquelle vos messages ne sont pas envoyés) pour votre Canvas. Activez Enable Quiet Hours dans vos Send Settings. Sélectionnez ensuite vos heures calmes dans le fuseau horaire local de l’utilisateur, et indiquez si le message doit être abandonné ou envoyé à la prochaine heure disponible.
Lorsque l’option Send at next available time est sélectionnée, les heures calmes suspendent le message et l’envoient à la prochaine heure disponible en dehors des heures calmes. Par exemple, supposons que les heures calmes soient configurées pour empêcher l’envoi de messages entre 11 h 30 et 14 h 30 dans le fuseau horaire local de l’utilisateur, et qu’un utilisateur entre dans une étape Message à 11 h 35. Comme cette heure se situe dans les heures calmes, le message n’est pas encore envoyé, et l’utilisateur reçoit l’étape Message à 14 h 30, c’est-à-dire après les heures calmes.
Étape 5 : Créer le parcours

Gagnez du temps en partant d’un modèle Canvas de Braze. Parcourez la bibliothèque pour trouver un modèle adapté à votre cas d’usage, puis personnalisez-le. Pour plus d’informations, consultez Modèles Canvas.
Étape 5.1 : Ajouter des variantes
Sélectionnez Ajouter une variante, puis ajoutez une nouvelle variante à votre Canvas. Une variante représente un parcours suivi par vos utilisateurs et peut contenir plusieurs étapes et branches.
Vous pouvez ajouter d’autres variantes en sélectionnant le bouton plus . Lorsque vous ajoutez de nouvelles variantes, vous pouvez ajuster la répartition de vos utilisateurs entre elles afin de comparer et d’analyser l’efficacité de différentes stratégies d’engagement.

Par défaut, l’attribution des variantes Canvas utilise un hachage déterministe de l’ID utilisateur et de l’ID du Canvas (et non le numéro de compartiment aléatoire de l’utilisateur). Un utilisateur reste sur la même variante lors d’une nouvelle entrée si les pourcentages de distribution n’ont pas changé. Si les pourcentages changent après le lancement, les utilisateurs qui entrent à nouveau peuvent se voir attribuer une variante différente.
Pour une attribution qui reste fixe même lorsque les pourcentages changent, utilisez une seule variante, stockez un nombre aléatoire avec une étape Mise à jour utilisateur, puis orientez les utilisateurs avec les Parcours d’audience. Développez les étapes suivantes pour voir la méthode complète.
Développer pour voir les étapes
- Créez un attribut personnalisé de type Nombre pour stocker votre nombre aléatoire. Donnez-lui un nom facile à retrouver, comme
lottery_numberourandom_assignment. Dans votre tableau de bord, accédez à Paramètres des données > Attributs personnalisés. - Utilisez une seule variante Canvas (ou ajoutez la même étape Mise à jour utilisateur à chaque variante). Ajoutez une étape Mise à jour utilisateur au début du parcours. Cette étape génère et stocke le nombre aléatoire avant que les utilisateurs n’atteignent votre étape Parcours d’audience.
- Dans l’étape Mise à jour utilisateur, sélectionnez l’Éditeur JSON avancé. Utilisez la balise {% random %} pour générer le nombre. Pour plus de détails, consultez Envoyer des messages avec un nombre aléatoire. Par exemple,
{% random 10 %}renvoie un entier compris entre 0 et 9. Définissez l’attribut personnalisé de l’étape 1 avec un JSON comme celui-ci :
{% if {{custom_attribute.${lottery_number}}} == blank %} {% capture lottery_number_str %}{% random 10 %}{% endcapture %} { "attributes": [ { "lottery_number": {{ lottery_number_str | plus: 0 }} } ] } {% endif %}
Le bloc {% if %} définit le nombre uniquement lorsque l’attribut est vide, de sorte que les utilisateurs conservent la même attribution lorsqu’ils entrent à nouveau dans le Canvas.
- Ajoutez une étape Parcours d’audience après l’étape Mise à jour utilisateur. Dans chaque groupe d’audience, ajoutez des filtres basés sur votre attribut personnalisé au lieu d’utiliser des pourcentages de distribution des variantes.
Par exemple, si vous avez utilisé{% random 10 %}, un groupe pourrait utiliserlottery_numberest inférieur à 4, un autre est supérieur à 3 et inférieur à 7, et un troisième est supérieur à 6 et inférieur à 10.
Étape 5.2 : Ajouter des étapes
Vous pouvez ajouter d’autres étapes à votre flux de travail Canvas en glissant-déposant des composants depuis la barre latérale Composants. Vous pouvez aussi sélectionner le bouton plus pour ajouter un composant via le menu contextuel. Pour la liste complète des composants, consultez Composants Canvas.

Vous pouvez ajouter jusqu’à 200 étapes dans un Canvas. Au-delà de 200 étapes, des problèmes de chargement peuvent survenir. Le nom d’une étape peut comporter jusqu’à 256 caractères.
À mesure que vous ajoutez des étapes, vous pouvez modifier le niveau de zoom pour vous concentrer sur les détails ou visualiser l’ensemble du parcours utilisateur. Zoomez avec Shift + + ou dézoomez avec Shift + -.
Durée maximale
La durée maximale correspond au temps le plus long qu’un utilisateur peut mettre pour terminer le Canvas. Braze la calcule en additionnant les délais et les fenêtres de déclenchement le long du chemin le plus long. Par exemple, une étape Délai de 3 jours suivie d’une étape Message donne une durée maximale de 3 jours.
Modifier une étape
Sélectionnez n’importe quel composant pour le modifier. Par exemple, sélectionnez une étape Délai pour fixer le délai à un jour précis, comme le 1er mars. Ce jour-là, les utilisateurs passent à l’étape suivante.
Vous pouvez également modifier les Paramètres d’action d’une étape Parcours d’action pour retenir les utilisateurs pendant une fenêtre d’évaluation et prioriser leur prochain parcours en fonction des actions effectuées pendant cette fenêtre.
Messages dans Canvas
Utilisez une étape Message pour envoyer des e-mails, des notifications push mobiles, des notifications push Web ou des webhooks. Sélectionnez vos canaux de communication, ajustez les paramètres de réception et personnalisez le contenu avec Liquid.
Pour utiliser les données d’entrée et les propriétés d’événement dans Liquid, consultez Propriétés de contexte et d’événement. Sélectionnez Terminé une fois la configuration de l’étape terminée.
Étape 5.3 : Modifier les connexions
Pour déplacer une connexion entre des étapes, sélectionnez la flèche qui relie les deux composants, puis sélectionnez un autre composant. Pour supprimer la connexion, sélectionnez la flèche, puis Annuler la connexion dans le pied de page du générateur de Canvas.
Si une même variante comporte plusieurs branches avec la même audience et le même horaire d’envoi, Braze ne garantit pas une répartition égale entre ces branches. La distribution peut favoriser la branche créée en premier. Pour obtenir une répartition égale, utilisez des filtres Numéro de compartiment aléatoire sur chaque branche. Pour plus d’informations, consultez Que se passe-t-il si l’audience et l’horaire d’envoi sont identiques pour un Canvas comportant une seule variante, mais plusieurs branches ?.
Étape 6 : Ajouter un groupe de contrôle
Vous pouvez ajouter un groupe de contrôle à votre Canvas en sélectionnant le bouton plus pour ajouter une nouvelle variante.
Braze suit les conversions des utilisateurs placés dans le groupe de contrôle, même s’ils ne reçoivent aucun message. Pour garantir la fiabilité du test, Braze suit le nombre de conversions de vos variantes et du groupe de contrôle sur exactement la même durée, comme indiqué sur l’écran de sélection des événements de conversion.
Vous pouvez ajuster la répartition entre vos messages en sélectionnant les en-têtes Nom de la variante.
Optimiser les variantes de Canvas avec BrazeAI
Pour un Canvas comportant plusieurs variantes de premier niveau, activez Optimiser avec BrazeAI (affiché sous le nom Sélection intelligente dans certains espaces de travail) afin d’ajuster automatiquement le pourcentage d’utilisateurs qui entrent dans chaque variante. BrazeAI s’appuie sur la performance des variantes pour maximiser le nombre de conversions attendu.
Ajoutez au moins deux variantes et un événement de conversion. Sélectionnez ensuite un pourcentage de variante pour ouvrir Modifier la distribution des variantes, puis activez Optimiser avec BrazeAI.
Une fois le délai de conversion initial écoulé, BrazeAI analyse la performance toutes les 12 heures et oriente davantage d’utilisateurs vers la variante qui génère le plus de conversions. Lorsque l’optimisation identifie un gagnant net, tous les futurs utilisateurs éligibles entrent dans cette variante.
Cette optimisation fonctionne mieux pour les Canvas dans lesquels de nouveaux utilisateurs entrent fréquemment.
Étape 7 : Enregistrer et lancer
Vérifiez le récapitulatif du Canvas, puis sélectionnez Lancer le Canvas pour l’enregistrer et le lancer. Si vous avez activé le workflow d’approbation des Canvas, approuvez les détails du Canvas répertoriés avant le lancement. Une fois le Canvas lancé, consultez les analyses sur la page Détails du Canvas.

Pour modifier un Canvas après son lancement, consultez Modifier des Canvas après leur lancement.