Créer un Canvas

Utilisez Canvas lorsque vous souhaitez guider les utilisateurs à travers un parcours en plusieurs étapes. Canvas connecte des délais, des décisions et des messages afin de 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

• Permissions pour créer et lancer des Canvas (voir Permissions)
• Des Segments ou des filtres définissant qui doit entrer dans le parcours

Avant de commencer

• Consultez les bases de Canvas pour vous assurer que l’entrée, la communication et les objectifs de conversion correspondent à votre cas d’usage.
• Pour un parcours guidé, suivez le cours Canvas sur Braze Learning.
• Partez d’un modèle de Canvas Braze, ou demandez à Operator de rédiger un Canvas à partir de consignes.

Étape 1 : Définir les bases du Canvas

1. Accédez à Messaging > Canvas.
2. Sélectionnez Create Canvas.
3. Nommez votre Canvas, assignez des Teams et créez ou ajoutez des tags. Vous pouvez également attribuer des événements de conversion au Canvas.

Conseil

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

• livraison planifiée
• livraison par événement
• livraison déclenchée par api

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

Remarque

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.

Important

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_properties affiché 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 :

1

{"external_user_id": "user_123", "context": {"product_name": "shoes"}}

Propriétés d’entrée Canvas :

1

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

• POST : Envoyer des messages Canvas via une livraison déclenchée par API
• POST : Planifier des Canvas déclenchés par API
• POST : Mettre à jour des Canvas planifiés déclenchés 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.

Étape 3 : Définir l’audience cible

Seuls les utilisateurs correspondant aux critères définis peuvent entrer dans le parcours à l’étape Target Audience, ce qui signifie que Braze évalue l’éligibilité de l’audience cible avant que les utilisateurs n’entrent dans le parcours Canvas. Par exemple, si vous souhaitez cibler les nouveaux utilisateurs, vous pouvez sélectionner un Segment d’utilisateurs ayant utilisé votre application pour la première fois il y a moins d’une semaine.

Important

Dans les espaces de travail comportant 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 des étapes de message individuelles. Pour restreindre les étapes de message aux utilisateurs d’une application spécifique, activez Validate audience at message send et ajoutez un Segment ciblant l’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 limitent pas l’application qui reçoit le message.

Dans Entry Controls, vous pouvez limiter le nombre d’utilisateurs à chaque exécution planifiée du Canvas. Pour les Canvas déclenchés par API et par événement, cette limite s’applique à chaque heure UTC.

Avertissement

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

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 s’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 sélectionnée en fonction du 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 durée de vie du Canvas
• Déclenché par API : Par heure, par jour, ou durée de vie du Canvas

Par exemple, si vous avez un Canvas planifié et que vous sélectionnez Limit entrance volume en définissant le champ Maximum entries à 500 000 utilisateurs avec Every time Canvas is scheduled comme cadence limite, alors le Canvas n’envoie qu’à 500 000 utilisateurs par envoi planifié.

Conseil

Braze ne recommande pas de sélectionner Every time the Canvas is scheduled pour l’IP warming, car cela peut entraîner une augmentation des volumes d’envoi.

Définir les critères de sortie

La définition des critères de sortie détermine quels utilisateurs vous souhaitez faire sortir d’un Canvas. Si un utilisateur effectue l’événement d’exception ou correspond aux Segments et filtres, il ne recevra 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, pas au niveau du filtre ou du groupe de filtres.
• Pendant le chargement des statistiques exactes, une estimation arrondie peut apparaître. Le chiffre exact s’affiche dans la section Reachable Users une fois chargé. Vous pouvez sélectionner Show Additional Stats pour 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é devrait être de 99,999 % ou plus.

Pour consulter des statistiques supplémentaires, telles que 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.

Important

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

Conseil

Gagnez du temps en partant d’un modèle Canvas de Braze. Parcourez la bibliothèque pour trouver un modèle qui correspond à 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. Les variantes représentent un parcours que vos utilisateurs empruntent et peuvent contenir plusieurs étapes et branches.

Vous pouvez ajouter des variantes supplémentaires 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é des différentes stratégies d’engagement.

Conseil

Par défaut, l’attribution des variantes Canvas utilise un hachage déterministe de l’identifiant utilisateur et de l’identifiant Canvas (et non le numéro de compartiment aléatoire de l’utilisateur). Un utilisateur reste sur la même variante lors de la réentrée si les pourcentages de distribution sont inchangés. Si les pourcentages changent après le lancement, les utilisateurs qui réentrent dans le Canvas peuvent être affectés à une variante différente.

Pour une attribution qui reste fixe 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 le processus complet.

Développer pour voir les étapes

1. Créez un attribut personnalisé de type Nombre pour stocker votre nombre aléatoire. Donnez-lui un nom facile à retrouver, comme lottery_number ou random_assignment. Dans votre tableau de bord, accédez à Paramètres des données > Attributs personnalisés.
   
   
2. Utilisez une seule variante Canvas (ou ajoutez la même étape de 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.
   
   
3. 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 en utilisant un JSON comme celui-ci :
   
   

   
   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   
   {% 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 réentrent dans le Canvas.

4. 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 de variantes.
   
   Par exemple, si vous avez utilisé {% random 10 %}, un groupe pourrait utiliser lottery_number est 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 des étapes supplémentaires à votre flux de travail Canvas en glissant-déposant des composants depuis la barre latérale Composants. Vous pouvez également sélectionner le bouton plus pour ajouter un composant via le menu contextuel. Pour la liste complète des composants, consultez Composants Canvas.

Important

Vous pouvez ajouter jusqu’à 200 étapes dans un Canvas. Si votre Canvas dépasse 200 étapes, des problèmes de chargement peuvent survenir.

À 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 de délai de 3 jours suivie d’une étape de 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 modifier le délai à un jour spécifique, comme le 1er mars. Ce jour-là, les utilisateurs passeront à l’étape suivante.

Vous pouvez également modifier les Paramètres d’action d’une étape Parcours d’action pour retenir les utilisateurs pendant une période d’évaluation et prioriser leur prochain parcours en fonction des actions réalisées pendant cette période.

Messages dans Canvas

Utilisez une étape de 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 les données d’entrée et les propriétés d’événement en Liquid, consultez Propriétés de contexte et d’événement. Sélectionnez Terminé une fois que vous avez fini de configurer l’étape.

Étape 5.3 : Modifier les connexions

Pour déplacer une connexion entre des étapes, sélectionnez la flèche reliant 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 Canvas.

Si une seule variante comporte plusieurs branches avec la même audience et le même horaire d’envoi, Braze ne garantit pas une répartition équitable entre ces branches. La distribution peut favoriser la branche créée en premier. Pour une répartition équitable, utilisez les 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 qui a une 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 préserver l’exactitude du test, Braze suit le nombre de conversions pour vos variantes et le groupe de contrôle pendant exactement la même durée, comme indiqué sur l’écran de sélection de l’événement 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 du Canvas avec BrazeAI

Pour un Canvas comportant plusieurs variantes de premier niveau, activez l’option Optimiser avec BrazeAI (affichée sous le nom Sélection intelligente dans certains espaces de travail) afin d’ajuster automatiquement le pourcentage d’utilisateurs entrant dans chaque variante. BrazeAI utilise les performances des variantes pour maximiser le nombre attendu de conversions.

Ajoutez au moins deux variantes et un événement de conversion. Ensuite, sélectionnez un pourcentage de variante pour ouvrir Modifier la répartition des variantes et activez Optimiser avec BrazeAI.

Après l’échéance initiale de conversion, BrazeAI examine les performances toutes les 12 heures et redirige davantage d’utilisateurs vers la variante qui génère le plus de conversions. Lorsque l’optimisation identifie un gagnant décisif, 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ésumé du Canvas, puis sélectionnez Launch Canvas pour enregistrer et lancer. Si le flux de travail d’approbation de Canvas est activé, approuvez les détails du Canvas répertoriés avant le lancement. Après le lancement, consultez les analyses sur la page Canvas Details.

Conseil

Pour modifier un Canvas après le lancement, consultez Modifier les Canvas après le lancement.

Étapes suivantes

• Analyse de Canvas
• Modifier les Canvas après le lancement
• Composants de Canvas
• Modèles de Canvas