Questions fréquemment posées

Cet article répond à certaines questions fréquemment posées sur Canvas.

Création et modification d’un Canvas

Combien d’étapes puis-je inclure dans un Canvas ?

Vous pouvez ajouter jusqu’à 200 étapes dans un Canvas.

Y a-t-il des limites de taille pour les propriétés d’entrée du Canvas ?

Oui. L’objet de contexte Canvas (propriétés d’entrée du Canvas) a une taille maximale de 50 Ko. Gardez les payloads aussi légers que possible dans cette limite. Pour comprendre comment les propriétés d’entrée et d’événement fonctionnent dans Canvas, consultez Propriétés de contexte et d’événement.

Pourquoi l’erreur « Too many Canvas branches » s’affiche-t-elle ?

Cette erreur apparaît lorsque la combinaison des embranchements d’étapes et de la taille de l’audience d’entrée risque de créer des problèmes de performance du cluster empêchant l’envoi des messages. Pour les étapes de résolution — y compris l’utilisation des parcours d’audience, la réduction des embranchements ou de la taille de l’audience, et la reconstruction dans Canvas Flow — consultez Erreur « Too many Canvas branches ».

Puis-je utiliser l’optimisation avec BrazeAI^TM avec la rééligibilité dans un Canvas ?

Oui. Les Canvas peuvent utiliser l’optimisation avec BrazeAI^TM lorsque la rééligibilité est activée. Braze ne peut pas garantir la même variante lors d’une nouvelle entrée, car la répartition évolue au fil du temps. Les Campaigns nécessitent une fenêtre de rééligibilité de 24 heures ou plus lorsque l’option Optimize with BrazeAI^TM est activée.

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 correspond au parcours utilisateur personnalisé au sein de vos branches 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 workflow 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 progresser. Cela permet aux utilisateurs d’apporter des modifications aux étapes sans avoir à les connecter directement au reste du Canvas. Cela vous laisse également une marge pour tester avant de passer immédiatement en production, ce qui permet en pratique d’enregistrer un brouillon.

Nous recommandons de vérifier la vue analytique pour les utilisateurs en attente dans une étape du 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 comportant une seule variante, mais plusieurs branches ?

Nous mettons en file d’attente un job pour chaque étape — ils s’exécutent à peu près au même moment, et l’un d’entre eux « l’emporte ». En pratique, la répartition peut être relativement uniforme, mais il y aura probablement au moins un léger biais en faveur de l’étape créée en premier.

De plus, nous ne pouvons donner aucune garantie quant à la distribution exacte. Si vous souhaitez une répartition équitable, 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 la réception d’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 l’événement 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à présents 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 en question.

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 autre message ne sera envoyé, quel que soit l’endroit où se trouve l’utilisateur dans le flux.
• Exception : les Canvas contenant des e-mails ne s’arrêteront pas immédiatement. Une fois que les demandes d’envoi sont 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 pouvez 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 de l’utilisateur. Consultez nos modèles Canvas de Braze pour plusieurs exemples d’approches rationalisé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 retardé. 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.

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 « tirés » par le SDK, plutôt que « poussés » depuis Braze. Les messages in-app pour les utilisateurs éligibles sont distribués automatiquement au démarrage de 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 une branche ?

Une fois les étapes de délai en amont et les vérifications d’audience terminées, les utilisateurs ne deviennent éligibles à un message in-app que lorsqu’ils atteignent l’étape Message. Si le message expire à une date calendaire ou sur 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, examinez 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 pas uniquement dans le résumé général du Canvas. Ouvrez le Canvas, sélectionnez l’étape Message et consultez l’engagement in-app à cet endroit. Pour les concepts de reporting, consultez 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 la même étape Message partagent une seule planification de distribution. Vous ne pouvez pas attribuer un envoi à 18 h pour une variante et à 19 h pour une autre au sein du même envoi planifié.

Pour échelonner les envois ou utiliser des horaires différents par parcours, essayez les méthodes suivantes :

• Séparez les étapes Message avec des étapes de délai entre elles afin que chaque message ait sa propre planification.
• Utilisez des branches ou une étape Chemins d’expérience pour que les utilisateurs suivent des parcours avec des timings différents.
• Utilisez des Campaigns séparées si le cas d’usage n’a pas besoin de rester dans un seul Canvas.

Pour les concepts de test multivarié et A/B dans les Campaigns, consultez Test multivarié et A/B.

Que se passe-t-il si un utilisateur est soumis à la limite de fréquence globale lors d’une étape Message du Canvas ?

Il ne reçoit pas l’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 de l’audience estimée ?

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 l’API : les utilisateurs n’entrent (et ne reçoivent les étapes) qu’après avoir effectué le comportement d’entrée. Les envois réalisés sont donc 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 la plus prioritaire pour laquelle ils sont éligibles. Les branches en aval peuvent donc recevoir moins d’utilisateurs que ne le suggère un comptage de Segment à plat.
• 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 éligibles lors de la création du Canvas peuvent sortir avant l’envoi d’un message.
• Groupes de contrôle : les groupes de contrôle globaux ou du Canvas retiennent une partie des entrants et les excluent de la communication.
• Heures calmes et délais : les messages peuvent être retenus ou replanifiés, décalant les envois en dehors de la fenêtre de reporting que vous consultez.
• Limites d’entrée maximale ou d’audience : les limites d’entrée ou d’envoi arrêtent les utilisateurs supplémentaires même lorsque le Segment sous-jacent est plus grand.
• 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 correspondant à votre Segment et à vos filtres d’entrée au moment de l’exécution de l’estimation. Après cet instant, les entrées retardées ou par événement, la rééligibilité, les déclenchements par l’API ou le routage par branches peuvent augmenter le nombre de profils touchant le parcours par rapport à l’instantané. Les utilisateurs peuvent également sortir 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 limites et les paramètres d’évaluation en parallèle avec Pourquoi les envois sont-ils inférieurs à la taille de l’audience estimée ?.

Pourquoi le nombre de Destinataires uniques est-il supérieur au nombre d’utilisateurs ciblés ?

Le nombre de Destinataires uniques peut être supérieur à l’audience attendue car Braze suit les destinataires uniques quotidiens pour le reporting de Canvas et des Campaigns. Cela permet une attribution précise des conversions à chaque fois qu’un utilisateur reçoit un message dans le parcours.

Par exemple, si un utilisateur reçoit une étape du Canvas le lundi et à nouveau le vendredi, et qu’il convertit après chaque envoi, Braze peut compter deux lignes de destinataires et deux conversions dans le périmètre. Avec les entrées récurrentes ou la rééligibilité, le même petit ensemble de profils peut générer 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é quotidien 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’autorise chaque utilisateur à entrer dans le Canvas qu’une seule fois. Pour les Canvas planifiés quotidiennement, seuls les utilisateurs correspondant à l’audience et n’étant 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ée 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ée ne peut pas rebondir à mesure que les utilisateurs entrent dans le Canvas.

Pour les limites de débit de distribution et d’autres facteurs réduisant les envois pour une occurrence donnée, consultez Pourquoi les envois sont-ils inférieurs à la taille de l’audience estimée ?.

Pourquoi un petit Segment de groupe de contrôle affiche-t-il des changements d’effectifs historiques ?

Les graphiques d’effectifs historiques utilisent des échantillons estimés. Les petits Segments — y compris les Segments du groupe de contrôle global — peuvent donc afficher des variations au jour le jour même lorsque l’audience sous-jacente est stable. Pour comprendre le fonctionnement des estimations et les raisons des fluctuations des graphiques, consultez Consultation de la taille historique d’effectifs d’un Segment.

Analyse et conversions

Comment le tableau de bord Conversions attribue-t-il les conversions Canvas ?

Le tableau de bord Conversions attribue les conversions Canvas en fonction de la méthode d’attribution que vous sélectionnez (par exemple, Upon Receipt, Upon Send, Upon Open ou Upon Click). Pour qu’un utilisateur apparaisse dans le rapport, il doit entrer dans le Canvas ou la Campaign, enregistrer la méthode d’attribution sélectionnée et effectuer l’événement de conversion dans les paramètres de votre rapport.

Pour les règles de conversion au niveau des étapes et des variantes dans l’analyse Canvas, consultez Comment les conversions des utilisateurs sont-elles suivies dans un Canvas ?.

Comment les conversions des utilisateurs sont-elles suivies dans un Canvas ?

Un utilisateur ne peut convertir qu’une seule fois par entrée dans le Canvas. Les conversions sont attribuées au dernier message reçu par l’utilisateur pour cette entrée. Le bloc de résumé 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’affiche que les conversions survenues lorsque cette étape était la dernière étape reçue par l’utilisateur.

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émarrage de session » (« Ouvre l’application ») :

• L’utilisateur A ouvre l’application après être entré mais avant de recevoir le premier message.
• L’utilisateur B ouvre l’application après chaque notification push.

Résultat : le résumé affichera deux conversions tandis que les étapes individuelles afficheront une conversion d’une pour la première étape et zéro pour toutes les étapes suivantes.

Remarque

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 :

1. L’utilisateur entre dans le Canvas.
2. La première étape n’a pas de délai, mais se situe dans les heures calmes définies, donc le message est supprimé.
3. 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 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 de résumé 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 de conversion d’une variante Canvas soit supérieur à la somme de ses totaux d’étapes. Cela se produit car un utilisateur peut effectuer un événement de conversion pour une variante dès qu’il entre dans la variante. Cependant, ce même événement de conversion ne compte pas 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 et non 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 é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 si 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 les 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 Campaign archivé(e) ?

Les messages archivés ne sont pas envoyés tant que vous ne les avez pas remis dans un état modifiable. Désarchivez la Campaign 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 propre), puis sélectionnez Reprendre ou lancez selon les besoins. Consultez Archiver les Campaigns et les Canvas.

Pourquoi mon Canvas ne s’enregistre-t-il pas alors qu’aucune erreur n’apparaît ?

Des filtres Attribut personnalisé vides dans l’audience ou les filtres au niveau de l’étape peuvent empêcher l’enregistrement sans afficher de message de validation détaillé. Ouvrez chaque carte de filtre, supprimez les règles d’attribut personnalisé incomplètes ou saisissez 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 Campaign ?

Lorsqu’une étiquette est supprimée de votre espace de travail, Braze la retire de chaque Campaign et Canvas qui la référençait. Ce nettoyage ne génère pas toujours sa propre ligne dans le journal des modifications du Canvas.

Comment puis-je consulter les analyses pour chacun de mes composants Canvas ?

Pour consulter les analyses d’un composant Canvas, accédez à votre Canvas et faites défiler la page Canvas Details. Ici, vous pouvez consulter les analyses de chaque composant. Consultez Analyse 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 se mettent à 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 Canvas Details.

En ce qui concerne le nombre d’utilisateurs uniques, l’analyse Canvas ou le segmenteur est-il plus précis ?

Le segmenteur est une statistique plus précise pour les données d’utilisateurs uniques par rapport aux statistiques Canvas ou Campaign. En effet, les statistiques Canvas et Campaign sont des nombres que Braze incrémente lorsqu’un événement se produit, ce qui signifie qu’il existe des variables pouvant 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 Campaign.

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 si vous utilisez un déclencheur de changement d’attribut). Cela entraîne la sortie des utilisateurs du Canvas s’ils ne font pas partie de votre audience sélectionnée avant que les actions de déclenchement ne soient évaluées.

Que se passe-t-il pour les utilisateurs anonymes au cours de 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.

Puis-je exclure les utilisateurs actuellement dans un parcours Canvas d’une Campaign 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 des entrées 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 Mise à jour de l’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 Campaigns 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 ainsi que 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 donc reçu une variante. Seuls les utilisateurs qui sont entrés dans le Canvas sont inclus.

Notez que l’attribution des variantes a lieu à 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 sera ni dans le groupe de contrôle ni dans une variante.

Éditeur Canvas d’origine

Développez pour consulter 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 workflow 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 davantage de personnalisation pour votre expérience d’édition. Vous pouvez immédiatement voir tous vos composants Canvas depuis la barre d’outils des étapes du 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 du message et les options d’avancement du message, le tout dans un seul composant. Ce sont désormais des paramètres distincts dans l’éditeur actuel, ce qui rend votre expérience de création de Canvas plus personnalisable et introduit certaines différences de fonctionnalité.

Avancement du composant message

Les composants message font avancer tous les utilisateurs qui entrent dans l’étape. Il n’est pas nécessaire de spécifier le comportement d’avancement du message, 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 délai attendent la durée complète du délai avant de passer à l’étape suivante.

Supposons que le 12 avril, nous ayons un composant 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 workflow 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

Comme le timing intelligent est stocké dans le composant message, les délais sont 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 que dans un Canvas construit avec le workflow Canvas d’origine.

Supposons que votre délai est défini à 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.

• Workflow 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.
• Workflow 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 message, à l’heure intelligente identifiée (même si aucun composant 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 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 arrive au composant 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 validés au moment de l’envoi. Cela évite le cas limite lié aux 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 liés aux Canvas

Les utilisateurs orphelins peuvent-ils recevoir des messages Canvas ?

Non. Les utilisateurs orphelins ne sont pas éligibles à la réception de messages. Si un profil devient orphelin alors qu’un utilisateur se trouve dans un parcours Canvas, il quitte le flux silencieusement. Les analyses ne montrent pas toujours un événement Exited pour cette sortie, et le résumé du flux de travail 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(ve), les messages déjà envoyés au fournisseur de services d’e-mailing sont-ils quand 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 annuler cet envoi. L’arrêt d’un Canvas ou d’une Campaign empêche les nouvelles requêtes d’envoi, mais les messages déjà transmis à l’ESP peuvent encore être distribués et incrémenter les compteurs d’envoi au fur et à mesure que l’ESP les traite.

C’est le même comportement que celui 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 de l’é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’images d’un pixel personnalisées.

Pourquoi mon étape webhook n’a-t-elle pas de champ body ?

Les étapes webhook utilisent un corps de requête pour POST, PUT, PATCH et DELETE. Si vous passez à la méthode GET, Braze supprime le champ body car les requêtes GET ne prennent pas en charge un corps de requête. Repassez à une méthode prenant en charge un corps si vous devez envoyer du JSON ou des données de formulaire. Pour plus de détails sur les méthodes, consultez Créer un webhook.

Comment utiliser spacer.gif dans une étape webhook ?

Braze héberge une image de remplissage spacer.gif sur cdn.braze.com et braze-images.com. Certaines équipes pointent l’URL d’un webhook vers cette image lorsqu’une étape doit se déclencher sans appeler un endpoint externe. Les étapes webhook standard doivent appeler un véritable endpoint. Utilisez les rapports webhook et les journaux de votre endpoint pour confirmer la distribution, comme décrit dans Comment puis-je confirmer qu’une étape webhook Canvas s’est déclenchée sans contenu visible pour l’utilisateur ?.

Pourquoi mon Canvas ne se charge-t-il pas avec une erreur « invalid next-step-id » ?

Cette erreur de console signifie qu’au moins une étape pointe vers une étape suivante manquante ou invalide, par exemple après une suppression partielle, un clonage ou une importation. Ouvrez le Canvas dans l’éditeur, reconnectez les étapes orphelines ou supprimez les étapes qui n’ont plus de chemin aval valide. Si le Canvas ne se charge toujours pas, contactez le support Braze en fournissant l’ID du Canvas et une capture d’écran de l’erreur de console.

Pourquoi l’horodatage d’une conversion Canvas dans Currents diffère-t-il de mes analyses Canvas ?

Currents enregistre les conversions Canvas sous forme d’événements users.canvas.Conversion. Le champ time de l’événement correspond au moment où l’événement de conversion s’est produit. Le champ conversion_behavior de cet événement décrit la définition de la conversion (type et fenêtre). Les analyses Canvas peuvent également agréger les conversions par rapport à l’entrée dans le Canvas dans la fenêtre de conversion. Lors du rapprochement des exportations, comparez le champ time de Currents avec l’horodatage de l’événement de conversion et les paramètres de votre fenêtre de conversion Canvas.

Pourquoi canvas_step_name est-il nul dans Currents ?

Les champs de nom de Campaign et Canvas tels que canvas_step_name peuvent être null lorsqu’un événement Currents est envoyé avant que Braze ait fini de propager les métadonnées de l’étape, par exemple après la création ou le renommage d’une étape. Pour plus de détails, consultez Pourquoi le nom de la campagne ou le nom de l’étape Canvas est-il NULL dans mes données Currents ?.

Pourquoi mon tableau ne se met-il pas à jour dans une étape Mise à jour de l’utilisateur ?

Vérifiez le JSON dans votre étape Mise à jour de l’utilisateur. Les mises à jour de tableaux et d’attributs imbriqués nécessitent des chemins et des valeurs valides pour l’attribut que vous modifiez. N’incluez pas les champs que l’étape fournit automatiquement, tels que l’identifiant utilisateur externe. Utilisez l’onglet Aperçu et test de l’étape pour confirmer le payload avant le lancement.

Puis-je envoyer des messages Canvas à des utilisateurs sans external_id ?

Oui, si un profil utilisateur Braze existe déjà. Les utilisateurs sans external_id sont des utilisateurs anonymes et peuvent être référencés avec un braze_id ou un alias d’utilisateur. Créez ou mettez à jour le profil avec l’endpoint /users/track ou votre SDK avant l’entrée dans le Canvas, puis utilisez l’entrée par événement ou déclenchée par API. Le ciblage standard du Canvas nécessite toujours un profil utilisateur Braze : vous ne pouvez pas envoyer de messages Canvas à une adresse e-mail seule sans profil.

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 par événement et déclenchés par API, Braze déduplique les événements déclencheurs de sorte 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 dans la même seconde, seule une entrée est traitée.

Pour autoriser des entrées multiples 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 autorisant 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 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 seconde 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 réels semblent corrects ?

La fonctionnalité Test push sur un profil utilisateur envoie la notification à chaque appareil activé pour les notifications push pour ce profil. Lorsque plusieurs applications sont installées sur un appareil, le système d’exploitation délivre 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 réel ou de test via une Campaign ou un Canvas avec une audience restreinte (par exemple, filtrer sur external_id) plutôt que de vous fier uniquement au Test push du profil.

Pour les étapes Message d’un Canvas avec plusieurs applications, activez Valider l’audience à l’envoi du message sur l’étape Message afin que les vérifications de Segments et de filtres 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 de 24 heures ou plus en raison de la limitation du débit. L’e-mail est envoyé aux utilisateurs du tableau de bord qui ont précédemment apporté des modifications au Canvas concerné (d’après les journaux de modifications du Canvas). Si Braze ne peut pas déterminer ces destinataires, l’e-mail est envoyé aux administrateurs de l’entreprise de 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 à l’intérieur d’une étape jusqu’à ce que les minuteurs soient terminés, ce qui est le plus visible dans les étapes Délai. Le comportement diffère également entre les étapes planifiées et les étapes déclenchées par un événement. Pour les délais, des exemples et les nuances d’analyse, 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 par événement ?

Braze évalue les parcours par événement lorsque les événements qualifiants sont ingérés et que l’utilisateur satisfait vos règles d’audience. Des événements personnalisés antidatés peuvent déclencher l’entrée dans un Canvas si l’horodatage de l’événement se situe dans la fenêtre d’entrée du Canvas. L’entrée ou les envois en aval peuvent ne pas se produire comme prévu si l’horodatage est en dehors de cette fenêtre, si le Canvas ou la Campaign n’était pas actif(ve), ou si l’utilisateur ne correspondait pas encore à votre audience.

Comparez les horodatages des événements avec les dates de mise en production, les paramètres de fenêtre d’entrée 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.