Questions fréquemment posées
Cet article répond à certaines questions fréquemment posées sur Canvas.
Création et modification de Canvas
Combien d’étapes puis-je inclure dans un Canvas ?
Vous pouvez ajouter jusqu’à 200 étapes dans un Canvas.
Quelle est la différence entre un composant et une étape ?
Un composant est un élément individuel de votre Canvas que vous pouvez utiliser pour déterminer l’efficacité de votre Canvas. Les composants peuvent inclure des actions telles que la division du parcours utilisateur, l’ajout d’un délai, ou encore le test de plusieurs chemins Canvas. Une étape dans Canvas fait référence au parcours utilisateur personnalisé dans les branches de votre Canvas. Essentiellement, votre Canvas est composé de composants individuels qui créent des étapes pour le parcours de vos utilisateurs.
Puis-je lancer un Canvas avec des étapes déconnectées ?
Oui. Vous pouvez également enregistrer des Canvas après le lancement avec des étapes déconnectées.
Où vont les utilisateurs lorsqu’ils atteignent une étape déconnectée ?
Si un utilisateur se trouve dans une étape déconnectée de votre flux Canvas, il passera à l’étape suivante s’il y en a une, et les paramètres de l’étape détermineront comment l’utilisateur doit avancer. Cela permet aux utilisateurs d’apporter des modifications aux étapes sans avoir à les connecter directement au reste du Canvas. Cela vous offre également une marge pour tester avant de passer en direct immédiatement, permettant ainsi d’enregistrer un brouillon.
Nous vous recommandons de vérifier la vue analytique pour les utilisateurs en attente dans une étape Canvas avant de déconnecter une étape.
Que se passe-t-il si l’audience et l’heure d’envoi sont identiques pour un Canvas qui a une variante, mais plusieurs branches ?
Nous mettons en file d’attente une tâche pour chaque étape : elles s’exécutent à peu près au même moment, et l’une d’entre elles « l’emporte ». En pratique, la répartition peut être relativement équilibrée, mais il est probable qu’il y ait au moins un léger biais en faveur de l’étape créée en premier.
De plus, nous ne pouvons pas garantir exactement à quoi ressemblera cette répartition. Si vous souhaitez une répartition égale, ajoutez un filtre numéro de compartiment aléatoire.
Comment les audiences Canvas sont-elles évaluées ?
Par défaut, les filtres et Segments pour les étapes complètes du Canvas sont vérifiés au moment de l’envoi. L’étape de l’arbre décisionnel effectue une évaluation juste après avoir reçu une étape précédente (ou avant un délai).
Quand un événement d’exception se déclenche-t-il ?
Les événements d’exception ne se déclenchent que lorsque l’utilisateur attend de recevoir le composant Canvas auquel il est associé. Si un utilisateur effectue une action à l’avance, l’événement d’exception ne se déclenchera pas. Si vous souhaitez exclure les utilisateurs ayant déjà effectué un certain événement, utilisez plutôt des filtres.
Comment la modification d’un Canvas affecte-t-elle les utilisateurs déjà dans le Canvas ?
Si vous modifiez certaines étapes d’un Canvas à plusieurs étapes, les utilisateurs qui faisaient déjà partie de l’audience mais n’ont pas encore reçu les étapes recevront la version mise à jour du message. Notez que cela ne se produira que s’ils n’ont pas encore été évalués pour l’étape.
Pour plus d’informations sur ce que vous pouvez modifier après le lancement, consultez Modifier votre Canvas après le lancement.
Que se passe-t-il lorsque vous arrêtez un Canvas ?
Lorsque vous arrêtez un Canvas, les règles suivantes s’appliquent :
- Les utilisateurs ne pourront plus entrer dans le Canvas.
- Aucun message supplémentaire ne sera envoyé, quel que soit l’endroit où se trouve un utilisateur dans le flux.
- Exception : les Canvas contenant des e-mails ne s’arrêteront pas immédiatement. Une fois les demandes d’envoi transmises à SendGrid, il n’est plus possible d’empêcher leur distribution à l’utilisateur.
Dois-je créer un seul Canvas ou des Canvas séparés par cycle de vie utilisateur ?
Selon ce que vous souhaitez accomplir avec votre Canvas, vous pourriez avoir besoin d’approches différentes pour construire votre parcours utilisateur. La flexibilité de Canvas vous permet de cartographier les parcours utilisateurs pour n’importe quelle étape du cycle de vie. Consultez nos modèles Braze Canvas pour plusieurs exemples d’approches simplifiées permettant de créer des parcours utilisateurs efficaces.
Messages et distribution
Quand les messages in-app dans Canvas sont-ils envoyés ?
Les messages in-app sont envoyés au prochain démarrage de session. Cela signifie que si l’utilisateur entre dans l’étape du Canvas avant l’arrêt du Canvas, il recevra tout de même le message in-app lors de son prochain démarrage de session, tant que le message in-app n’a pas encore expiré.
Il est possible qu’un utilisateur démarre une session avant l’arrêt du Canvas, mais que le message in-app ne lui soit pas affiché immédiatement. Cela peut se produire si le message in-app est déclenché par un événement personnalisé ou s’il est différé. Cela signifie qu’un utilisateur peut enregistrer une impression de message in-app et « recevoir » le message in-app après l’arrêt du Canvas. Cependant, l’utilisateur aurait dû démarrer la session avant l’arrêt du Canvas, mais après avoir reçu l’étape du Canvas.

Arrêter un Canvas n’entraîne pas la sortie des utilisateurs en attente de réception de messages du parcours utilisateur. Si vous réactivez le Canvas et que des utilisateurs sont toujours en attente du message, ils le recevront (sauf si le moment où le message aurait dû être envoyé est passé, auquel cas ils ne le recevront pas).
Pourquoi un Canvas peut-il afficher zéro envoi alors que des impressions sont enregistrées ?
Si les Messages envoyés sont toujours à zéro pour un Canvas contenant une étape de message in-app, c’est parce que la distribution des messages in-app fonctionne différemment des autres canaux de communication.
Les messages in-app sont « récupérés » par le SDK, plutôt que « poussés » depuis Braze. Les messages in-app destinés aux utilisateurs éligibles sont distribués automatiquement au démarrage de la session et « attendent » l’événement déclencheur avant de s’afficher. Comme les utilisateurs éligibles reçoivent le message lorsqu’ils démarrent une session, Braze ne signale pas cela comme un événement d’envoi. Lorsque les utilisateurs effectuent l’événement déclencheur, le message s’affiche et Braze enregistre une impression et marque l’étape du Canvas (ou la Campaign) comme reçue sur le profil utilisateur. Par conséquent, le total des Envois est à zéro pour les messages in-app.
Pourquoi les utilisateurs n’ont-ils pas reçu mon message in-app après un long délai ou un embranchement ?
Après la fin des étapes de Délai en amont et des vérifications d’audience, les utilisateurs ne deviennent éligibles à un message in-app que lorsqu’ils atteignent l’étape Message. Si le message expire à une date calendaire ou dans une courte fenêtre de durée après la disponibilité de l’étape, les utilisateurs sur des branches plus lentes peuvent arriver après l’expiration et ne jamais voir le message. Alignez l’expiration avec les délais les plus longs réalistes de votre parcours. Pour plus d’informations et d’exemples, consultez Expiration des messages in-app.
Pourquoi le message « Canvas Entry Properties may not be used in In-App Messages. » s’affiche-t-il ?
Ce message apparaît lorsque la personnalisation fait référence à des champs que les messages in-app ne peuvent pas résoudre dans Canvas. Utilisez l’objet context tel que décrit dans Propriétés de contexte et d’événement et Étape Message. L’espace de noms Liquid hérité canvas_entry_properties a des contraintes différentes de context. Si vous avez besoin que des valeurs persistent à travers plusieurs étapes, consultez les propriétés persistantes dans l’éditeur Canvas d’origine avec votre équipe Braze. Les valeurs stockées sont effacées lorsqu’un utilisateur quitte le Canvas avant que l’appareil ne télécharge le payload in-app.
Où puis-je trouver les clics sur les boutons pour les messages in-app par glisser-déposer dans Canvas ?
Les indicateurs au niveau des boutons pour les messages in-app par glisser-déposer apparaissent sur la carte d’analyse de l’étape Message dans les Détails du Canvas, et non uniquement dans le résumé de haut niveau du Canvas. Ouvrez le Canvas, sélectionnez l’étape Message et consultez l’engagement in-app à cet endroit. Pour les concepts de reporting, consultez Mesurer et tester avec l’analyse Canvas.
Puis-je planifier des heures d’envoi différentes pour chaque variante dans la même étape Message d’un Canvas ou un envoi multivarié ?
Non. Les variantes dans la même configuration multivariée ou étape Message partagent une seule planification de distribution. Vous ne pouvez pas attribuer l’envoi d’une variante à 18 h et d’une autre à 19 h pour le même envoi planifié.
Pour échelonner les envois ou utiliser des horaires différents par parcours, essayez les méthodes suivantes :
- Des étapes Message séparées avec des étapes de Délai entre elles afin que chaque message ait sa propre planification.
- Des embranchements ou une étape Chemins d’expérience pour que les utilisateurs suivent des parcours avec des horaires différents.
- Des Campaigns séparées si le cas d’usage n’a pas besoin de rester dans un seul Canvas.
Pour les concepts de tests multivariés et A/B dans les Campaigns, consultez Tests multivariés et A/B.
Que se passe-t-il si un utilisateur est soumis à une limite de fréquence globale à une étape Message d’un Canvas ?
Il ne reçoit pas cet envoi pour le canal limité, mais les étapes Message font tout de même avancer les utilisateurs lorsqu’un message n’est pas envoyé en raison de la limite de fréquence globale. Pour les cas d’avancement étape par étape, consultez Comment les utilisateurs avancent. La limite de fréquence globale seule ne fait pas sortir les utilisateurs d’un Canvas ; ce comportement est distinct des Validations de distribution sur une étape Message. Pour plus de détails, consultez Limitation du débit et limite de fréquence.
Pourquoi les envois sont-ils inférieurs à la taille estimée de l’audience ?
Les envois peuvent être inférieurs à l’Audience estimée pour bon nombre des mêmes raisons que pour les Campaigns, notamment les limites de fréquence, les filtres stricts d’appareil ou de navigateur, les fenêtres de rééligibilité, la limitation du débit et les exclusions au niveau du canal (par exemple, la joignabilité push ou les vérifications d’abonnement et de livrabilité des e-mails).
Des facteurs spécifiques à Canvas s’appliquent également :
- Entrée par événement ou déclenchée par API : les utilisateurs n’entrent (et ne reçoivent les étapes) qu’après avoir effectué le comportement d’entrée, de sorte que les envois réalisés sont en retard par rapport à l’estimation initiale jusqu’à ce que ces actions se produisent.
- Parcours d’audience : les utilisateurs sont dirigés vers la branche de plus haute priorité pour laquelle ils sont éligibles, de sorte que les branches en aval peuvent recevoir moins d’utilisateurs que ne le suggère un simple décompte de Segment.
- Vérifications d’audience et d’heure d’envoi : les étapes complètes réévaluent les filtres au moment de l’envoi, sauf configuration contraire. Les utilisateurs qui étaient éligibles lors de la création du Canvas peuvent être exclus avant l’envoi d’un message.
- Groupes de contrôle : les groupes de contrôle globaux ou de Canvas retiennent une part des entrants de la communication.
- Heures calmes et délais : les messages peuvent être retenus ou replanifiés, décalant les envois hors de la fenêtre de reporting que vous consultez.
- Plafonds d’entrée ou d’audience maximum : les plafonds d’entrée ou d’envoi arrêtent les utilisateurs supplémentaires même lorsque le Segment sous-jacent est plus large.
- Fenêtre de reporting : la plage d’analyse peut ne pas inclure tous les envois que vous comparez à l’estimation.
Pourquoi l’audience estimée et le nombre d’utilisateurs du Canvas ne correspondent-ils pas ?
L’Audience estimée reflète les utilisateurs qui correspondent à votre Segment et à vos filtres d’entrée au moment où l’estimation est exécutée. Après ce moment, les entrées différées ou par événement, la rééligibilité, les déclencheurs API ou le routage par embranchement peuvent augmenter le nombre de profils qui touchent le parcours par rapport à l’instantané. Les utilisateurs peuvent également être exclus lorsque les filtres au moment de l’envoi échouent, ce qui réduit les entrées ou envois réalisés. Comparez le timing, les plafonds et les paramètres d’évaluation en parallèle avec Pourquoi les envois sont-ils inférieurs à la taille estimée de l’audience ?.
Pourquoi les Destinataires uniques sont-ils supérieurs au nombre d’utilisateurs ciblés ?
Les Destinataires uniques peuvent être supérieurs à l’audience attendue car Braze suit les destinataires uniques quotidiens pour le reporting de Canvas et de Campaign. Cela permet une attribution de conversion précise chaque fois qu’un utilisateur reçoit un message dans le parcours.
Par exemple, si un utilisateur reçoit une étape de Canvas le lundi et à nouveau le vendredi et convertit après chaque envoi, Braze peut compter deux lignes de destinataires et deux conversions dans le périmètre. Avec des entrées récurrentes ou la rééligibilité, le même petit ensemble de profils peut produire plusieurs Destinataires uniques sur plusieurs jours.
Pourquoi mon Canvas connaît-il des taux d’envoi plus faibles ?
Si vous constatez que votre Canvas planifié quotidiennement envoie à moins d’utilisateurs au fil du temps, vérifiez les points suivants :
- Vérifiez si la rééligibilité est activée : sans rééligibilité, Braze n’entre chaque utilisateur dans le Canvas qu’une seule fois. Pour les Canvas planifiés quotidiennement, seuls les utilisateurs qui correspondent à l’audience et qui ne sont pas encore entrés dans le Canvas sont éligibles à chaque entrée. À mesure que davantage d’utilisateurs entrent, chaque entrée ultérieure a moins d’utilisateurs éligibles, de sorte que le volume d’entrées diminue.
- Vérifiez si l’audience a une composition fixe : les audiences construites à partir d’une liste d’utilisateurs fixe (comme un import CSV utilisé comme filtre de Segment) ne gagnent pas automatiquement de nouveaux membres. Sans nouveaux entrants, le volume d’entrées ne peut pas remonter à mesure que les utilisateurs entrent dans le Canvas.
Pour les limites de débit de distribution et d’autres facteurs qui réduisent les envois pour une occurrence unique, consultez Pourquoi les envois sont-ils inférieurs à la taille estimée de l’audience ?.
Analyse et conversions
Comment les conversions des utilisateurs sont-elles suivies dans un Canvas ?
Un utilisateur ne peut convertir qu’une seule fois par entrée dans un Canvas. Les conversions sont attribuées au dernier message reçu par l’utilisateur pour cette entrée. Le bloc récapitulatif au début d’un Canvas reflète toutes les conversions effectuées par les utilisateurs dans ce parcours, qu’ils aient reçu un message ou non. Chaque étape suivante n’affichera que les conversions survenues lorsque cette étape était la dernière reçue par l’utilisateur.

Lorsqu’un utilisateur entre à nouveau dans un Canvas, les événements de conversion ne sont suivis que pour l’entrée la plus récente. Les événements de conversion ne sont pas enregistrés pour les entrées précédentes, même si l’événement de conversion est renseigné rétroactivement.
Développer pour voir des exemples
Exemple 1
Il y a un parcours Canvas avec 10 notifications push et l’événement de conversion est « début de session » (« Ouvre l’application ») :
- L’utilisateur A ouvre l’application après être entré dans le Canvas mais avant de recevoir le premier message.
- L’utilisateur B ouvre l’application après chaque notification push.
Résultat : Le récapitulatif affichera deux conversions tandis que les étapes individuelles afficheront une conversion de un à la première étape et zéro pour toutes les étapes suivantes.

Si les heures calmes sont actives lorsque l’événement de conversion se produit, les mêmes règles s’appliquent.
Exemple 2
Il y a un Canvas à une seule étape avec les heures calmes activées :
- L’utilisateur entre dans le Canvas.
- La première étape n’a pas de délai, mais se situe dans la plage des heures calmes configurées, donc le message est supprimé.
- L’utilisateur effectue l’événement de conversion.
Résultat : L’utilisateur sera comptabilisé comme converti dans la variante globale du Canvas, mais pas dans l’étape puisqu’il n’a pas reçu l’étape.
Quelle est la différence entre les différents types de taux de conversion ?
- Le total des conversions du Canvas reflète le nombre d’utilisateurs uniques ayant effectué un événement de conversion, et non le nombre de conversions effectuées par chacun.
- Le taux de conversion de la variante ou le bloc récapitulatif au début d’un Canvas reflète toutes les conversions effectuées par les utilisateurs dans ce parcours, qu’ils aient reçu un message ou non, sous forme de total agrégé.
- Le taux de conversion de l’étape reflète le nombre de personnes ayant reçu cette étape de message et ayant effectué l’un des événements de conversion définis.
Pourquoi le taux de conversion de mon étape Canvas n’est-il pas égal au taux de conversion total de ma variante Canvas ?
Il est courant que le total des conversions d’une variante Canvas soit supérieur à la somme des totaux de ses étapes. Cela se produit parce qu’un utilisateur peut effectuer un événement de conversion pour une variante dès qu’il entre dans celle-ci. Cependant, ce même événement de conversion n’est pas comptabilisé pour une étape Canvas. Ainsi, tout utilisateur qui entre dans le Canvas et effectue l’événement de conversion avant de recevoir la première étape Canvas est comptabilisé dans le total de conversion de la variante mais pas dans le total de l’étape. Il en va de même pour un utilisateur qui entre dans le Canvas mais en sort avant de recevoir une quelconque étape.
Notez qu’il est également possible qu’un utilisateur entre dans une variante, ne reçoive aucun message d’une étape, puis convertisse. Dans ce cas, aucune conversion n’est enregistrée au niveau de l’étape. Cependant, comme l’utilisateur a techniquement converti, une conversion est enregistrée au niveau du Canvas.
Comment puis-je confirmer que mes utilisateurs ont reçu un Canvas déclenché par API ?
Vous pouvez créer un segment en utilisant un filtre Canvas pour confirmer si des utilisateurs sont entrés dans le Canvas ou ont reçu une étape Canvas spécifique. Par exemple, utilisez un filtre d’entrée Canvas si vous souhaitez confirmer que les utilisateurs sont entrés dans le Canvas déclenché par API, ou un filtre d’étape reçue si vous souhaitez confirmer qu’ils ont reçu un message du Canvas. Ensuite, utilisez l’endpoint /users/export/segment pour exporter les utilisateurs de ce segment.
Puis-je supprimer un Canvas ?
Non, mais vous pouvez archiver un Canvas.
Comment reprendre un Canvas ou une campagne archivé(e) ?
Les messages archivés ne sont pas envoyés tant que vous ne les remettez pas dans un état modifiable. Désarchivez la campagne ou le Canvas, définissez le calendrier d’entrée ou l’heure d’envoi sur une fenêtre future (ou dupliquez le parcours si vous avez besoin d’une copie vierge), puis sélectionnez Reprendre ou lancez selon les besoins. Consultez Archiver des campagnes et des Canvas.
Pourquoi mon Canvas ne s’enregistre-t-il pas alors qu’aucune erreur n’apparaît ?
Des filtres Attribut personnalisé vides dans les filtres d’audience ou au niveau des étapes peuvent bloquer l’enregistrement sans message de validation détaillé. Ouvrez chaque carte de filtre, supprimez les règles d’attribut personnalisé incomplètes, ou saisissez à la fois le nom et la valeur de l’attribut, puis sélectionnez Enregistrer à nouveau.
Pourquoi une étiquette a-t-elle disparu de mon Canvas ou de ma campagne ?
Lorsqu’une étiquette est supprimée de votre espace de travail, Braze la retire de chaque campagne et Canvas qui y faisait référence. Ce nettoyage ne génère pas toujours sa propre ligne dans le journal des modifications du Canvas.
Comment puis-je consulter les analyses de chacun de mes composants Canvas ?
Pour consulter les analyses d’un composant Canvas, accédez à votre Canvas et faites défiler la page Détails du Canvas. Vous pourrez y voir les analyses de chaque composant. Consultez Analyses Canvas pour plus de détails.
Quand l’engagement d’une étape Canvas est-il visible sur un profil utilisateur ?
Les filtres tels que Received Message from Canvas Step sont mis à jour après que Braze a enregistré l’événement d’envoi, de réception ou d’engagement correspondant pour cette étape. Les messages in-app peuvent enregistrer les impressions séparément des indicateurs de type envoi. Consultez Pourquoi un Canvas peut-il afficher zéro envoi alors que des impressions sont enregistrées ?. Ces mêmes événements apparaissent dans les indicateurs de l’étape sur la page Détails du Canvas.
En ce qui concerne le nombre d’utilisateurs uniques, les analyses Canvas ou le segmenteur sont-ils plus précis ?
Le segmenteur fournit une statistique plus précise pour les données d’utilisateurs uniques par rapport aux statistiques Canvas ou de campagne. En effet, les statistiques Canvas et de campagne sont des nombres que Braze incrémente lorsqu’un événement se produit, ce qui signifie que des variables peuvent entraîner une différence entre ce nombre et celui du segmenteur. Par exemple, les utilisateurs peuvent convertir plus d’une fois pour un Canvas ou une campagne.
Pourquoi le nombre d’utilisateurs entrant dans un Canvas ne correspond-il pas au nombre attendu ?
Le nombre d’utilisateurs entrant dans un Canvas peut différer du nombre attendu en raison de la manière dont les audiences et les déclencheurs sont évalués. Dans Braze, une audience est évaluée avant le déclencheur (sauf en cas d’utilisation d’un déclencheur de changement d’attribut). Cela entraînera la sortie des utilisateurs du Canvas s’ils ne font pas partie de votre audience sélectionnée avant l’évaluation des actions de déclenchement.
Que se passe-t-il pour les utilisateurs anonymes pendant leur parcours Canvas ?
Bien que les utilisateurs anonymes puissent entrer et sortir des Canvas, leurs actions ne sont pas associées à un profil utilisateur spécifique tant qu’ils ne sont pas identifiés, de sorte que leurs interactions peuvent ne pas être entièrement suivies dans vos analyses. Vous pouvez utiliser le générateur de requêtes pour générer un rapport de ces indicateurs.

Pour obtenir une assistance supplémentaire concernant la résolution des problèmes Canvas, assurez-vous de contacter le support Braze dans les 30 jours suivant la survenue de votre problème, car nous ne disposons que des 30 derniers jours de journaux de diagnostic.
Puis-je exclure les utilisateurs actuellement dans un parcours Canvas d’une campagne ou d’un segment ?
Utilisez les filtres de segmentation tels que Entered Canvas Variation, In Canvas Control Group ou Received Message from Canvas Step pour cibler les utilisateurs en fonction de l’entrée dans le Canvas, de l’affectation à une variante ou de l’engagement avec une étape. Ces filtres évaluent l’historique d’entrée et les interactions — ils n’indiquent pas si un utilisateur progresse encore dans un parcours actif.
Pour inclure ou exclure des utilisateurs en fonction de leur participation active à un Canvas, ajoutez des étapes de mise à jour utilisateur à l’entrée et à la sortie du Canvas pour définir et effacer des attributs personnalisés, puis filtrez sur ces attributs dans les campagnes ou les segments.
Segmentation
Quelle est la différence entre « N’est pas entré dans la variante du Canvas » et « N’est pas dans le groupe de contrôle du Canvas » ?
Consultez les Filtres de segmentation pour les définitions complètes des filtres.
N’est pas entré dans la variante du Canvas
L’utilisateur n’est jamais entré dans un parcours de variante d’un Canvas spécifique. Tous les utilisateurs qui ne font pas partie du groupe de contrôle sont inclus, qu’ils soient entrés ou non dans le Canvas. Cela comprend les utilisateurs qui sont entrés dans une autre variante et ceux qui ne sont entrés dans aucune variante.
N’est pas dans le groupe de contrôle du Canvas
L’utilisateur est entré dans le Canvas, mais ne fait pas partie du groupe de contrôle et a par conséquent reçu une variante. Seuls les utilisateurs qui sont entrés dans le Canvas sont inclus.
Notez que l’attribution de la variante se fait à l’entrée dans le Canvas. Si un utilisateur n’est pas entré dans un Canvas, aucune variante ne lui sera attribuée. Autrement dit, il ne fera partie ni du groupe de contrôle ni d’une variante.
Éditeur Canvas d’origine
Développer pour les FAQ de l’éditeur Canvas d’origine
Comment convertir un Canvas existant de l’éditeur d’origine vers l’éditeur actuel ?
Vous pouvez cloner votre Canvas. Cela crée une copie de votre Canvas d’origine dans le flux de travail Canvas le plus récent.
Quelles sont les principales différences entre les éditeurs Canvas actuel et d’origine ?
Barre d’outils des composants Canvas
Auparavant, avec l’éditeur Canvas d’origine, une étape complète était ajoutée par défaut chaque fois que vous créiez une étape dans votre parcours utilisateur. Ces étapes complètes sont remplacées par différents composants Canvas, ce qui vous offre une meilleure visibilité et une personnalisation accrue pour votre expérience d’édition. Vous pouvez immédiatement voir tous vos composants Canvas depuis la barre d’outils des étapes Canvas.
Comportement des étapes
Auparavant, chaque étape complète incluait des informations telles que les paramètres de délai et de planification, les événements d’exception, les filtres d’audience, la configuration des messages et les options d’avancement des messages, le tout dans un seul composant. Ce sont des paramètres distincts dans l’éditeur actuel pour rendre votre expérience de création de Canvas plus personnalisable, et cela introduit certaines différences de fonctionnalité.
Avancement du composant de message
Les composants de message font avancer tous les utilisateurs qui entrent dans l’étape. Il n’est pas nécessaire de spécifier le comportement d’avancement des messages, ce qui simplifie la configuration globale de l’étape. Si vous souhaitez implémenter l’option Avancer lorsque le message est envoyé, ajoutez un parcours d’audience distinct pour filtrer les utilisateurs qui n’ont pas reçu l’étape précédente.
Comportement du délai « dans »
Les composants de délai attendront la totalité du temps de délai avant de passer à l’étape suivante.
Supposons que le 12 avril, nous ayons un composant de délai configuré pour envoyer votre utilisateur à l’étape suivante dans un jour à 14 h. Un utilisateur entre dans le composant à 14 h 01 le 13 avril.
- Pour le flux de travail d’origine, l’utilisateur passerait à l’étape suivante à 14 h le 14 avril, soit moins d’un jour après l’heure d’entrée.
- Dans l’éditeur actuel, l’utilisateur passerait à l’étape suivante à 14 h le 15 avril. Notez que c’est la même heure, mais plus d’un jour après l’heure d’entrée.
Comportement du timing intelligent
Étant donné que le timing intelligent est stocké dans le composant de message, les délais seront appliqués avant les calculs du timing intelligent. Cela signifie que, selon le moment où un utilisateur entre dans le composant, il peut recevoir le message plus tard qu’il ne l’aurait reçu dans un Canvas construit avec le flux de travail Canvas d’origine.
Supposons que votre délai est défini sur 2 jours, que le timing intelligent est activé et qu’il a déterminé que le meilleur moment pour envoyer votre message est 14 h. Un utilisateur entre dans l’étape de délai à 14 h 01.
- Flux de travail actuel : Il faudra 48 heures pour que le délai s’écoule, donc l’utilisateur reçoit le message le troisième jour à 14 h.
- Flux de travail d’origine : L’utilisateur reçoit le message le deuxième jour à 14 h.
Notez que si le timing intelligent est activé, le message sera envoyé dans les 24 heures suivant l’entrée de l’utilisateur dans le composant de message, à l’heure intelligente identifiée (même si aucun composant de délai n’est impliqué).
Événements d’exception
Heures calmes
L’événement d’exception est appliqué à l’aide de parcours d’action, qui sont distincts des étapes de message. Les heures calmes sont appliquées dans le composant de message. Cela signifie que si un utilisateur a déjà passé le parcours d’action (et n’a pas été exclu par l’événement d’exception), puis rencontre les heures calmes lorsqu’il atteint le composant de message, et que son Canvas est configuré de sorte que le message soit renvoyé après la période d’heures calmes, l’événement d’exception ne sera plus appliqué. Notez que ce cas d’usage n’est pas courant.
Pour les segments et les filtres, l’étape de message dispose de validations de distribution qui permettent aux utilisateurs de configurer des segments et des filtres supplémentaires qui sont validés au moment de l’envoi. Cela empêche le cas limite des heures calmes mentionné ci-dessus.
Paramètre de planification « dans » ou « au prochain »
Les événements d’exception sont créés à l’aide de parcours d’action. Les parcours d’action ne prennent en charge que « après une fenêtre de temps X » et non « dans X temps » ou « au prochain X temps ».
Que dois-je inclure lorsque je soumets un ticket d’assistance pour une erreur « Request Timed Out » ?
Si vous rencontrez une erreur « Request Timed Out » lors de la modification d’un Canvas et que vous devez contacter l’assistance Braze, incluez les informations suivantes pour accélérer la résolution :
- Enregistrement d’écran : Un enregistrement des étapes que vous avez suivies avant de voir l’erreur, y compris les transitions de page.
- Horodatage et fuseau horaire : L’heure exacte à laquelle l’erreur s’est produite et votre fuseau horaire.
- Navigateur et version : Le navigateur que vous utilisez (par exemple, Chrome 120, Safari 17) et si vous avez essayé de reproduire l’erreur dans un autre navigateur.
- Étapes pour reproduire : Une description claire des actions qui déclenchent l’erreur, y compris les étapes du Canvas ou les configurations spécifiques impliquées.
- Journaux réseau (facultatif) : Ouvrez les outils de développement de votre navigateur (onglet Network), reproduisez l’erreur et exportez le journal réseau sous forme de fichier journal HTTP Archive (HAR). Cela aide l’équipe d’assistance à identifier quel appel API est en dépassement de délai.
Distribution et résolution des problèmes de Canvas
Les utilisateurs orphelins sont-ils éligibles pour recevoir des messages Canvas ?
Non. Les utilisateurs orphelins ne sont pas éligibles pour recevoir des messages. Si un profil est orphelin alors qu’un utilisateur se trouve dans un parcours Canvas, il quitte silencieusement le flux. Les analyses ne montrent pas toujours un événement Exited pour cette sortie, et le résumé du workflow peut inclure un partial_update_token sans exited_date ni exit_reason.
Pour plus d’informations sur les fusions et les profils orphelins, consultez Fusionner les utilisateurs en double.
Si j’arrête un Canvas ou une Campaign actif, les messages déjà envoyés au fournisseur de services d’e-mailing sont-ils tout de même distribués ?
Oui. Une fois que Braze a envoyé une requête à votre fournisseur de services d’e-mailing (ESP), Braze ne peut pas rappeler cet envoi. Arrêter un Canvas ou une Campaign empêche les nouvelles requêtes d’envoi, mais les messages déjà transmis à l’ESP peuvent toujours être distribués et peuvent encore incrémenter les compteurs d’envoi au fur et à mesure que l’ESP les traite.
Il s’agit du même comportement décrit pour l’arrêt d’un Canvas : les envois d’e-mails en cours ne sont pas immédiatement interrompus.
Comment puis-je confirmer qu’une étape webhook Canvas s’est déclenchée sans contenu visible pour l’utilisateur ?
Braze suit les envois de webhooks et les résultats de distribution associés pour les étapes Webhook dans les Campaigns et les Canvas. Utilisez les analyses d’étape, les rapports Webhook ou les événements webhook Currents pour confirmer que l’étape s’est exécutée. Les journaux de requêtes de votre endpoint fournissent une confirmation supplémentaire lorsque vous avez besoin d’une preuve de réception côté serveur.
Braze n’inclut pas de pixel de suivi invisible intégré pour les étapes webhook. Appuyez-vous sur les indicateurs webhook de Braze et la journalisation de votre endpoint plutôt que sur des requêtes d’image d’un pixel personnalisées.
Pourquoi un utilisateur est-il entré dans un Canvas moins de fois qu’il n’a effectué l’événement déclencheur ?
Pour les Canvas basés sur une action et déclenchés par API, Braze déduplique les événements déclencheurs afin qu’un utilisateur puisse entrer au maximum environ une fois par seconde pour le même Canvas. Si un utilisateur effectue le même déclencheur plusieurs fois en une seconde, une seule entrée est traitée.
Pour autoriser plusieurs entrées dans la même seconde, espacez les événements déclencheurs d’au moins 1,1 seconde (par exemple, lorsque vous contrôlez le timing des événements depuis votre serveur). Pour un comportement de type Campaign permettant plusieurs déclencheurs dans la même seconde, comparez votre cas d’usage aux Campaigns avec les paramètres de planification et de rééligibilité appropriés.
Quand les utilisateurs sont-ils dédupliqués dans les Canvas déclenchés par API ?
Si un utilisateur entre à nouveau dans un Canvas déclenché par API et atteint une étape de délai où il est déjà en file d’attente suite à une entrée précédente pour un message identique, Braze déduplique l’utilisateur pour éviter les envois en double. La deuxième instance du Canvas se termine, de sorte que le nombre d’entrées peut dépasser le nombre d’envois.
Pourquoi une notification push de test est-elle envoyée à la mauvaise application, alors que les envois en production semblent corrects ?
L’option Test push sur un profil utilisateur envoie la notification à tous les appareils activés pour les notifications push de ce profil. Lorsque plusieurs applications sont installées sur un appareil, le système d’exploitation distribue généralement la notification de test à la première application disponible, qui peut ne pas être celle que vous souhaitez valider.
Pour confirmer le ciblage spécifique à une application, envoyez un message en production ou de test via une Campaign ou un Canvas avec une audience restreinte (par exemple, filtrez sur external_id) au lieu de vous fier uniquement au Test push du profil.
Pour les étapes Message de Canvas avec plusieurs applications, activez Valider l’audience au moment de l’envoi du message sur l’étape Message afin que les vérifications de Segment et de filtre s’exécutent au moment de l’envoi. Pour plus d’informations, consultez Étape Message.
Pour le comportement général des notifications push de test, consultez Envoi de messages de test et FAQ Push.
Comment déboguer les Push Stories sur iOS et Android ?
Commencez par Push Stories pour la configuration et les exigences créatives. Pour l’implémentation et la gestion des notifications enrichies, consultez Notifications enrichies et Push Stories dans le guide du développeur.
Qui reçoit l’e-mail « Canvas Messages Delayed 24+ Hours » ?
Braze envoie cette notification lorsque des messages Canvas sont retardés par la limitation du débit pendant 24 heures ou plus. L’e-mail est envoyé aux utilisateurs du tableau de bord qui ont précédemment apporté des modifications au Canvas concerné (sur la base des journaux de modifications du Canvas). Si Braze ne peut pas déterminer ces destinataires, l’e-mail est envoyé aux administrateurs de l’entreprise pour l’espace de travail.
Quand un utilisateur cesse-t-il de recevoir des messages après un événement d’exception ?
Braze enregistre la sortie dès que l’événement d’exception se produit, mais les utilisateurs peuvent rester dans une étape jusqu’à ce que les minuteries se terminent, ce qui est le plus visible dans les étapes de délai. Le comportement diffère également entre les étapes planifiées et les étapes déclenchées par un événement. Pour les chronologies, les exemples et les nuances analytiques, consultez Critères de sortie.
Pourquoi mon étape Parcours d’action affiche-t-elle une erreur lorsque je sélectionne une interaction d’alias de lien ?
Les groupes d’actions qui utilisent des déclencheurs d’interactivité e-mail (par exemple, Clic sur un alias dans un e-mail ou A cliqué sur un alias dans n’importe quelle Campaign ou étape Canvas) nécessitent une étape Message qui a déjà envoyé le message contenant ce lien. Ajoutez ou réorganisez les étapes pour que l’e-mail soit envoyé avant que l’étape Parcours d’action n’évalue le clic, ou choisissez une interaction correspondant à un message que l’utilisateur a déjà reçu dans ce Canvas. Pour la liste complète des déclencheurs d’interaction, consultez Livraison par événement.
Comment les horodatages historiques d’événements personnalisés affectent-ils les Canvas et les Campaigns basés sur une action ?
Braze évalue les parcours basés sur une action lorsque les événements qualifiants sont ingérés et que l’utilisateur répond à vos règles d’audience. Si un événement arrive sur le profil en dehors de la période pendant laquelle votre Canvas ou Campaign était actif, ou avant que l’utilisateur ne corresponde à votre audience, l’entrée ou les envois en aval peuvent ne pas se produire comme prévu. Comparez les horodatages des événements aux dates de mise en production et à l’appartenance aux Segments en utilisant le journal d’activité du profil utilisateur et les étapes de résolution des problèmes dans Résolution des problèmes liés aux événements personnalisés. Si le comportement ne correspond toujours pas aux attentes, contactez le support Braze.