Passer au contenu

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 longueur maximale du nom d’une étape du canvas ?

Le nom d’une étape du canvas peut compter jusqu’à 256 caractères.

Existe-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. Dans cette limite, gardez vos payloads aussi légers que possible. Pour comprendre le fonctionnement des propriétés d’entrée et d’événement 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 qui empêchent l’envoi des messages. Pour connaître les étapes de résolution (notamment 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 Optimize with BrazeAITM avec la rééligibilité dans un Canvas ?

Oui. Les Canvas peuvent utiliser Optimize with BrazeAITM lorsque la rééligibilité est activée. Braze ne peut pas garantir que l’utilisateur recevra la même variante lors de sa ré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 Optimize with BrazeAITM est activé.

Quelle est la différence entre un composant et une étape ?

Un composant est un élément individuel de votre Canvas qui vous permet de déterminer son efficacité. Les composants peuvent inclure des actions comme la division du parcours utilisateur, l’ajout d’un délai, ou même le test de plusieurs parcours Canvas. Une étape dans Canvas désigne le parcours utilisateur personnalisé dans les branches de votre Canvas. En résumé, votre Canvas est constitué de composants individuels qui créent les étapes du parcours de vos utilisateurs.

Puis-je lancer un Canvas comportant des étapes déconnectées ?

Oui. Vous pouvez également enregistrer des Canvas après leur 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 la façon dont il progresse. Ce fonctionnement vous permet de modifier des étapes sans avoir à les connecter directement au reste du Canvas. Vous disposez ainsi d’une certaine marge pour effectuer des tests avant de passer en production, ce qui revient à enregistrer un brouillon.

Nous vous recommandons de consulter la vue analytique pour repérer les utilisateurs en attente dans une étape du canvas avant de déconnecter cette é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 une tâche pour chaque étape : elles s’exécutent à peu près au même moment, et l’une d’elles « l’emporte ». En pratique, la répartition peut être relativement équilibrée, mais elle présentera probablement un léger biais en faveur de l’étape créée en premier.

Par ailleurs, nous ne pouvons offrir aucune garantie sur la forme exacte de cette répartition. Si vous souhaitez une répartition égale, ajoutez un filtre Numéro de compartiment aléatoire.

Comment les audiences de Canvas sont-elles évaluées ?

Par défaut, les filtres et les Segments des é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 ils sont associés. Si un utilisateur effectue une action à l’avance, l’événement d’exception ne se déclenchera pas. Si vous souhaitez exclure les utilisateurs qui ont effectué un certain événement à l’avance, utilisez plutôt des filtres.

Quel est l’impact de la modification d’un Canvas sur les utilisateurs qui s’y trouvent déjà ?

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 ces étapes recevront la version mise à jour du message. Notez que cela ne se produit que s’ils n’ont pas encore été évalués pour l’étape.

Pour en savoir plus 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 peuvent plus entrer dans le Canvas.
  • Aucun autre message n’est envoyé, quelle que soit la position de l’utilisateur dans le flux.
  • Exception : les Canvas contenant des e-mails ne s’arrêtent pas immédiatement. Une fois les demandes d’envoi transmises à SendGrid, nous ne pouvons plus empêcher leur distribution à l’utilisateur.

Dois-je créer un seul Canvas ou des Canvas distincts pour chaque étape du cycle de vie utilisateur ?

Selon ce que vous souhaitez accomplir avec votre Canvas, vous aurez peut-être besoin d’approches différentes pour créer votre parcours utilisateur. La flexibilité de Canvas vous permet de cartographier des parcours utilisateurs pour n’importe quelle étape du cycle de vie. Consultez nos modèles de Canvas Braze pour découvrir plusieurs exemples d’approches simplifiées permettant de créer des parcours utilisateurs efficaces.

Messages et distribution

Quand les messages in-app d’un Canvas sont-ils envoyés ?

Les messages in-app sont envoyés au début de la session suivante. Si l’utilisateur atteint l’étape du Canvas avant l’arrêt du Canvas, il recevra donc quand même le message in-app au début de sa session suivante, tant que le message n’a pas expiré.

Un utilisateur peut démarrer une session avant l’arrêt du Canvas sans voir le message in-app immédiatement. C’est le cas lorsque le message in-app est déclenché par un événement personnalisé ou qu’il est différé. Un utilisateur peut donc enregistrer une impression et « recevoir » le message in-app après l’arrêt du Canvas. Il doit toutefois avoir démarré 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 le nombre de Messages envoyés reste 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 de celle des autres canaux de communication.

Les messages in-app sont « récupérés » par le SDK, au lieu d’être « poussés » par Braze. Les messages in-app destinés aux utilisateurs éligibles sont distribués automatiquement au début de la session, puis « attendent » l’événement déclencheur pour s’afficher. Comme les utilisateurs éligibles reçoivent le message au début de leur session, Braze ne comptabilise pas cela comme un événement d’envoi. Lorsque les utilisateurs effectuent l’événement déclencheur, le message s’affiche : Braze enregistre alors une impression et marque l’étape du Canvas (ou la campagne) comme reçue dans le profil utilisateur. Le total des Envois est donc de 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 Délai et les vérifications d’audience en amont terminées, les utilisateurs ne deviennent éligibles à un message in-app que lorsqu’ils atteignent l’étape Message. Si le message expire à une date précise ou après une courte fenêtre de type durée après la disponibilité de l’étape, les utilisateurs empruntant des branches plus lentes peuvent arriver après l’expiration et ne jamais voir le message. Alignez l’expiration sur les délais réalistes de votre parcours le plus long. 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 un Canvas. Utilisez l’objet context comme décrit dans Contexte et propriétés d’événement et Étape Message. L’ancien espace de noms Liquid canvas_entry_properties est soumis à des contraintes différentes de celles de context. Si vous avez besoin que des valeurs persistent sur 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 du message in-app.

Où trouver les clics sur les boutons des messages in-app par glisser-déposer dans un 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 Détails du Canvas, et pas seulement dans le résumé général du Canvas. Ouvrez le Canvas, sélectionnez l’étape Message et consultez-y l’engagement in-app. Pour en savoir plus sur les concepts de reporting, consultez Analyse des Canvas.

Puis-je planifier des heures d’envoi différentes pour chaque variante d’une même étape Message de Canvas ou d’un même envoi multivarié ?

Non. Les variantes d’une même configuration multivariée ou d’une même étape Message partagent une seule planification d’envoi. Vous ne pouvez pas programmer une variante à 18 h et une autre à 19 h pour ce même envoi planifié.

Pour échelonner les envois ou utiliser des heures différentes selon le chemin, essayez les méthodes suivantes :

  • Séparez les étapes Message en insérant des étapes 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 chemins avec des timings différents.
  • Utilisez des campagnes distinctes si le cas d’usage ne nécessite pas de rester au sein d’un seul Canvas.

Pour les concepts de tests multivariés et A/B dans les campagnes, consultez Tests multivariés et A/B.

Que se passe-t-il si un utilisateur atteint la limite de fréquence globale à une étape Message de Canvas ?

Il ne reçoit pas cet envoi sur le canal concerné, mais les étapes Message font tout de même progresser les utilisateurs lorsqu’un message n’est pas envoyé en raison de la limite de fréquence globale. Pour le détail des cas d’avancement, consultez Comment les utilisateurs progressent. La limite de fréquence globale ne fait pas, à elle seule, sortir les utilisateurs d’un Canvas ; ce comportement est distinct des Validations de livraison d’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 d’audience estimée ?

Les envois peuvent être inférieurs à l’Audience estimée pour bon nombre des mêmes raisons que pour les campagnes : limites de fréquence, filtres stricts sur l’appareil ou le navigateur, fenêtres de rééligibilité, limitation du débit et exclusions au niveau du canal (par exemple, l’accessibilité push ou les vérifications d’abonnement et de livrabilité des e-mails).

Des facteurs propres aux Canvas s’appliquent également :

  • Entrée par événement ou déclenchée par API : Les utilisateurs n’entrent dans le Canvas (et ne reçoivent les étapes) qu’après avoir effectué le comportement d’entrée ; les envois réels restent donc inférieurs à l’estimation initiale tant que ces actions n’ont pas eu lieu.
  • Parcours d’audience : Les utilisateurs sont orientés vers la branche la plus prioritaire pour laquelle ils sont qualifiés ; les branches en aval peuvent donc recevoir moins d’utilisateurs que ne le laisse supposer un simple comptage de segment.
  • Vérifications de l’audience et au moment de l’envoi : Les étapes complètes réévaluent les filtres au moment de l’envoi, sauf configuration contraire. Des utilisateurs qualifiés lors de la création du Canvas peuvent ne plus l’être avant l’envoi d’un message.
  • Groupes de contrôle : Les groupes de contrôle globaux ou de Canvas excluent une partie des participants des envois de messages.
  • Heures calmes et délais : Les messages peuvent être retenus ou reprogrammés, ce qui décale les envois en dehors de la période de reporting que vous consultez.
  • Limites maximales d’entrée ou d’audience : Les limites d’entrée ou d’envoi bloquent des utilisateurs supplémentaires, même lorsque le segment sous-jacent est plus grand.
  • Période 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 du calcul de l’estimation. Ensuite, les entrées différées ou par événement, la rééligibilité, les déclencheurs API ou l’orientation vers les branches peuvent augmenter le nombre de profils qui passent par le parcours par rapport à cet instantané. Des utilisateurs peuvent aussi sortir lorsque les filtres au moment de l’envoi échouent, ce qui réduit les entrées ou envois réels. Comparez le timing, les limites et les paramètres d’évaluation en vous appuyant sur Pourquoi les envois sont-ils inférieurs à la taille d’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 dépasser l’audience attendue, car Braze suit les destinataires uniques quotidiens dans le reporting des Canvas et des campagnes. Cela permet d’attribuer précisément les conversions chaque fois qu’un utilisateur reçoit un message au cours du parcours.

Par exemple, si un utilisateur reçoit une étape du Canvas le lundi puis à nouveau le vendredi, et qu’il convertit après chaque envoi, Braze peut comptabiliser deux lignes de destinataire et deux conversions prises en compte. Avec des entrées récurrentes ou la rééligibilité, un même petit ensemble de profils peut générer plusieurs Destinataires uniques sur plusieurs jours.

Pourquoi mon Canvas enregistre-t-il des taux d’envoi plus faibles ?

Si votre Canvas planifié quotidiennement envoie des messages à de moins en 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 ne fait entrer chaque utilisateur dans le Canvas qu’une seule fois. Pour les Canvas planifiés quotidiennement, seuls les utilisateurs qui correspondent à l’audience et ne sont pas encore entrés dans le Canvas sont éligibles à chaque entrée. Plus les utilisateurs entrent, moins il reste d’utilisateurs éligibles pour les entrées suivantes, et le volume d’entrées diminue.
  • Vérifiez si l’audience a une composition fixe : Les audiences créées à partir d’une liste fixe d’utilisateurs (comme une importation CSV utilisée comme filtre de segment) n’accueillent pas automatiquement de nouveaux membres. Sans nouveaux participants, le volume d’entrées ne peut pas remonter à mesure que les utilisateurs entrent dans le Canvas.

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

Pourquoi un petit segment de groupe de contrôle affiche-t-il des variations dans son historique d’appartenance ?

Les graphiques d’historique d’appartenance reposent sur des échantillons estimés. Les petits segments, y compris les segments du groupe de contrôle global, peuvent donc varier d’un jour à l’autre même lorsque l’audience sous-jacente est stable. Pour comprendre le fonctionnement des estimations et les raisons de ces fluctuations, consultez Afficher l’historique de la taille d’appartenance au segment.

Analyse et conversions

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

Le tableau de bord des conversions attribue les conversions des Canvas selon la méthode d’attribution que vous sélectionnez (par exemple, À la réception, À l’envoi, À l’ouverture ou Au clic). Pour qu’un utilisateur figure dans le rapport, il doit entrer dans le Canvas ou la campagne, enregistrer la méthode d’attribution sélectionnée et réaliser l’événement de conversion dans le cadre des paramètres de votre rapport.

Pour connaître les règles de conversion au niveau des étapes et des variantes dans l’analyse des 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 un Canvas. Les conversions sont attribuées au message le plus récent reçu par l’utilisateur pour cette entrée. Le bloc récapitulatif au début d’un Canvas reflète toutes les conversions réalisé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 lorsqu’il s’agissait de l’étape la plus récente reçue par l’utilisateur.

Développer pour voir des exemples

Exemple 1

Un parcours de Canvas comporte 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é 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 affiche deux conversions, tandis que les étapes individuelles affichent une conversion pour la première étape et zéro pour toutes les étapes suivantes.

Exemple 2

Un Canvas à une seule étape a les heures calmes activées :

  1. L’utilisateur entre dans le Canvas.
  2. La première étape n’a pas de délai, mais elle tombe pendant les heures calmes définies : le message est donc supprimé.
  3. L’utilisateur réalise l’événement de conversion.

Résultat : L’utilisateur est comptabilisé comme converti dans la variante globale du Canvas, mais pas dans l’étape, puisqu’il ne l’a pas reçue.

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 réalisé un événement de conversion, et non le nombre de conversions réalisées par chacun d’eux.
  • Le taux de conversion de la variante, ou bloc récapitulatif au début d’un Canvas, reflète sous forme de total cumulé toutes les conversions réalisées par les utilisateurs dans ce parcours, qu’ils aient reçu un message ou non.
  • Le taux de conversion de l’étape reflète le nombre de personnes ayant reçu cette étape de message et réalisé l’un des événements de conversion définis.

Pourquoi le taux de conversion de mon étape de Canvas n’est-il pas égal au taux de conversion total de ma variante de Canvas ?

Il est courant que le total des conversions d’une variante de Canvas soit supérieur à la somme des totaux de ses étapes. En effet, un utilisateur peut réaliser un événement de conversion pour une variante dès qu’il y entre. Toutefois, ce même événement de conversion n’est pas comptabilisé pour une étape du Canvas. Ainsi, tout utilisateur qui entre dans le Canvas et réalise l’événement de conversion avant de recevoir la première étape est comptabilisé dans le total des conversions 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, puis le quitte avant de recevoir une étape.

Notez qu’un utilisateur peut aussi entrer dans une variante, ne recevoir aucun message d’une étape, puis convertir. Dans ce cas, aucune conversion n’est enregistrée au niveau de l’étape. En revanche, comme l’utilisateur a bien converti, une conversion est enregistrée au niveau du Canvas.

Comment vérifier si mes utilisateurs ont reçu un Canvas déclenché par API ?

Vous pouvez créer un segment à l’aide d’un filtre Canvas pour vérifier si des utilisateurs sont entrés dans le Canvas ou ont reçu une étape spécifique du Canvas. Par exemple, utilisez un filtre d’entrée dans le Canvas pour vérifier que les utilisateurs sont entrés dans le Canvas déclenché par API, ou un filtre d’étape reçue pour vérifier qu’ils ont reçu un message du Canvas. Utilisez ensuite 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é ?

Les messages archivés ne sont pas envoyés tant que vous ne les avez pas rendus à nouveau modifiables. Désarchivez la campagne ou le Canvas, définissez la planification d’entrée ou l’heure d’envoi sur une période future (ou dupliquez le parcours si vous avez besoin d’une copie vierge), puis cliquez sur Reprendre ou lancez-le selon vos besoins. Consultez Archiver des campagnes et des Canvas.

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

Des filtres Attribut personnalisé vides dans les filtres d’audience ou d’étape 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 à nouveau Enregistrer.

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 toutes les campagnes et de tous les Canvas qui y faisaient référence. Ce nettoyage ne génère pas toujours sa propre ligne dans le journal des modifications d’un Canvas.

Comment afficher les analyses de chacun des composants de mon Canvas ?

Pour afficher les analyses d’un composant de Canvas, accédez à votre Canvas et faites défiler la page Détails du Canvas. Vous y trouverez les analyses de chaque composant. Pour en savoir plus, consultez Analyse des Canvas.

Quand l’engagement issu d’une étape de Canvas est-il visible sur un profil utilisateur ?

Les filtres tels que Received Message from Canvas Step se mettent à jour une fois que Braze a enregistré l’événement d’envoi, de réception ou d’engagement correspondant à cette étape. Les messages in-app peuvent enregistrer des impressions indépendamment 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 des étapes sur la page Détails du Canvas.

Pour le nombre d’utilisateurs uniques, l’analyse des Canvas ou le segmenteur est-il le plus précis ?

Le segmenteur fournit une statistique plus précise pour les données d’utilisateurs uniques que les statistiques des Canvas ou des campagnes. En effet, les statistiques des Canvas et des campagnes sont des valeurs que Braze incrémente lorsqu’un événement se produit, ce qui signifie que certaines variables peuvent faire différer ce nombre de 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, l’audience est évaluée avant le déclencheur (sauf si vous utilisez un déclencheur de changement de valeur d’attribut). Les utilisateurs qui ne font pas partie de l’audience sélectionnée sont donc exclus du Canvas avant même l’évaluation des actions de déclenchement.

Que deviennent les utilisateurs anonymes au cours de leur parcours Canvas ?

Les utilisateurs anonymes peuvent entrer dans les Canvas et en sortir, mais leurs actions ne sont associées à un profil utilisateur spécifique qu’une fois qu’ils sont identifiés. Leurs interactions peuvent donc 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 sur ces indicateurs.

Puis-je exclure d’une campagne ou d’un segment les utilisateurs actuellement engagés dans un parcours Canvas ?

Utilisez des 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 leur entrée dans un Canvas, de la variante qui leur a été attribuée ou de leur 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 afin de définir puis d’effacer des attributs personnalisés, puis filtrez sur ces attributs dans vos campagnes ou segments.

Segmentation

Quelle est la différence entre « Has not entered Canvas variation » et « Is not in Canvas control group » ?

Consultez les filtres de segmentation pour obtenir la définition complète de chaque filtre.

Has not entered Canvas variation

L’utilisateur n’est jamais entré dans un chemin de variante d’un Canvas spécifique. Ce filtre inclut tous les utilisateurs qui ne font pas partie du groupe de contrôle, qu’ils soient entrés dans le Canvas ou non. Cela comprend les utilisateurs entrés dans une autre variante ainsi que ceux qui ne sont entrés dans aucune variante.

Is not in Canvas control group

L’utilisateur est entré dans le Canvas, mais ne fait pas partie du groupe de contrôle et a donc reçu une variante. Ce filtre inclut uniquement les utilisateurs entrés dans le Canvas.

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 est attribuée. Autrement dit, il ne fait partie ni du groupe de contrôle ni d’une variante.

Éditeur Canvas original

Développer pour afficher les FAQ sur l’éditeur Canvas original

Comment convertir un Canvas existant de l’éditeur original vers l’éditeur actuel ?

Vous pouvez cloner votre Canvas. Une copie de votre Canvas original est alors créée dans le flux de travail Canvas le plus récent.

Quelles sont les principales différences entre l’éditeur Canvas actuel et l’éditeur original ?

Barre d’outils des composants Canvas

Avec l’éditeur Canvas original, 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 désormais remplacées par différents composants Canvas, ce qui vous offre plus de visibilité et de personnalisation lors de l’édition. Vous voyez immédiatement tous vos composants Canvas dans la barre d’outils des étapes du Canvas.

Comportement des étapes

Auparavant, chaque étape complète regroupait dans un seul composant 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. Dans l’éditeur actuel, ces paramètres sont séparés afin de rendre la création de votre Canvas plus personnalisable, ce qui introduit quelques différences de fonctionnement.

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 des messages, ce qui simplifie la configuration globale de l’étape. Si vous souhaitez mettre en œuvre 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 totalité du délai avant de passer à l’étape suivante.

Supposons que, le 12 avril, vous ayez 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.

  • Avec le flux de travail original, l’utilisateur passerait à l’étape suivante à 14 h le 14 avril, soit moins d’un jour après son entrée.
  • Dans l’éditeur actuel, l’utilisateur passe à l’étape suivante à 14 h le 15 avril. Il s’agit de la même heure, mais plus d’un jour après son entrée.

Comportement du timing intelligent

Comme le timing intelligent est défini dans le composant Message, les délais sont appliqués avant les calculs du timing intelligent. Ainsi, selon le moment où un utilisateur entre dans le composant, il peut recevoir le message plus tard que dans un Canvas créé avec le flux de travail Canvas original.

Supposons que votre délai soit de 2 jours, que le timing intelligent soit activé et qu’il ait déterminé que le meilleur moment pour envoyer votre message est 14 h. Un utilisateur entre dans l’étape Délai à 14 h 01.

  • Flux de travail actuel : il faut 48 heures pour que le délai s’écoule, l’utilisateur reçoit donc le message le troisième jour à 14 h.
  • Flux de travail original : l’utilisateur reçoit le message le deuxième jour à 14 h.

Notez que si le timing intelligent est activé, le message est envoyé dans les 24 heures suivant l’entrée de l’utilisateur dans le composant Message, au moment intelligent identifié (même en l’absence de composant Délai).

Événements d’exception

Heures calmes

L’événement d’exception est appliqué à l’aide des parcours d’action, qui sont distincts des étapes Message. Les heures calmes sont appliquées dans le composant Message. Par conséquent, si un utilisateur a déjà franchi l’étape de parcours d’action (sans être exclu par l’événement d’exception), puis se trouve dans les heures calmes en arrivant au composant Message, et que le Canvas est configuré pour renvoyer le message après la période d’heures calmes, l’événement d’exception ne sera plus appliqué. Notez que ce cas d’usage est peu courant.

Pour les segments et les filtres, l’étape Message dispose de validations de livraison qui permettent de configurer des segments et des filtres supplémentaires, validés au moment de l’envoi. Cela évite le cas particulier des heures calmes mentionné ci-dessus.

Paramètre de planification « Dans » ou « Au prochain »

Les événements d’exception sont créés à l’aide des parcours d’action. Les parcours d’action prennent uniquement en charge « après une fenêtre de X temps », et non « dans X temps » ou « au prochain X temps ».

Que dois-je inclure dans 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 le support de 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 des Canvas

Les utilisateurs orphelins peuvent-ils recevoir des messages Canvas ?

Non. Les utilisateurs orphelins ne peuvent pas recevoir de messages. Si un profil devient orphelin alors que l’utilisateur se trouve dans un parcours Canvas, il quitte le flux sans notification. Les analyses n’affichent pas toujours d’é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 en savoir plus sur les fusions et les profils orphelins, consultez Fusionner des utilisateurs en double.

Si j’arrête un Canvas ou une Campaign actif, les messages déjà transmis à l’ESP 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), cet envoi ne peut plus être annulé. L’arrêt d’un Canvas ou d’une Campaign empêche de nouvelles requêtes d’envoi, mais les messages déjà transmis à l’ESP peuvent encore être distribués et continuer à incrémenter le nombre d’envois au fur et à mesure que l’ESP les traite.

Il s’agit du même comportement que celui décrit pour l’arrêt d’un Canvas : les envois d’e-mails en cours ne sont pas interrompus immédiatement.

Comment vérifier qu’une étape webhook d’un Canvas s’est déclenchée sans contenu visible par 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 sur les webhooks ou les événements webhook de Currents pour confirmer que l’étape s’est exécutée. Les journaux de requêtes de votre endpoint offrent une confirmation supplémentaire lorsque vous avez besoin d’une preuve de réception côté serveur.

Braze ne propose pas de pixel de suivi invisible intégré pour les étapes webhook. Appuyez-vous sur les indicateurs de webhook de Braze et sur la journalisation de votre endpoint plutôt que sur des requêtes d’image personnalisées d’un pixel.

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

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 de corps, car les requêtes GET ne prennent pas en charge de corps de requête. Revenez à une méthode compatible si vous devez envoyer du JSON ou des données de formulaire. Pour en savoir plus sur les méthodes, consultez Créer un webhook.

Comment utiliser spacer.gif dans une étape webhook ?

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

Pourquoi mon Canvas ne se charge-t-il pas et affiche-t-il 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 celles qui n’ont plus de chemin en aval valide. Si le Canvas ne se charge toujours pas, contactez le support de Braze en indiquant l’ID du Canvas et en joignant 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 aussi agréger les conversions par rapport à l’entrée dans le Canvas, au sein de la fenêtre de conversion. Pour rapprocher vos exportations, comparez le champ time de Currents à l’horodatage de l’événement de conversion et aux paramètres de fenêtre de conversion de votre Canvas.

Pourquoi canvas_step_name est-il nul dans Currents ?

Les champs de nom de Campaign et de Canvas, comme canvas_step_name, peuvent être null lorsqu’un événement Currents est envoyé avant que Braze n’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 en savoir plus, consultez Pourquoi le nom de la campagne ou le nom de l’étape du Canvas est-il NULL dans mes données Currents ?.

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

Vérifiez le JSON de 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, comme l’ID externe de l’utilisateur. Utilisez l’onglet Aperçu et test de l’étape pour vérifier 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 à l’aide d’un braze_id ou d’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 une entrée par événement ou déclenchée par API. Le ciblage standard des Canvas nécessite toujours un profil utilisateur Braze : vous ne pouvez pas envoyer de messages Canvas à une simple adresse e-mail 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édoublonne les événements déclencheurs : un utilisateur peut entrer au maximum environ une fois par seconde dans un 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). Si vous avez besoin d’un comportement autorisant plusieurs déclenchements dans la même seconde, comparez votre cas d’usage aux Campaigns avec des paramètres de planification et de rééligibilité adaptés.

Quand les utilisateurs sont-ils dédoublonné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 dans laquelle il est déjà en file d’attente depuis une entrée précédente pour un message identique, Braze le dédoublonne afin d’éviter les envois en double. La seconde instance du Canvas se termine, si bien 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 ?

Le Test push d’un profil utilisateur est distribué à tous les appareils de ce profil sur lesquels les notifications push sont activées. 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 n’est pas forcément celle que vous souhaitez valider.

Pour vérifier le ciblage propre à une application, envoyez un message réel ou de test via une Campaign ou un Canvas avec une audience restreinte (par exemple, en filtrant sur external_id) au lieu de vous fier uniquement au Test push du profil.

Pour les étapes Message des Canvas associées à plusieurs applications, activez Valider l’audience à l’envoi du message dans l’étape Message afin que les vérifications de segment et de filtre s’exécutent au moment de l’envoi. Pour en savoir plus, consultez Étape Message.

Pour le comportement général des notifications push de test, consultez Envoi de messages de test et la FAQ sur les notifications 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 adressé aux utilisateurs du tableau de bord qui ont précédemment modifié le Canvas concerné (d’après les journaux de modifications du Canvas). Si Braze ne parvient 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 dans une étape jusqu’à l’expiration des minuteurs, ce qui est particulièrement 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 subtilités d’analyse, consultez Critères de sortie.

Les groupes d’actions qui utilisent des déclencheurs d’interactivité par e-mail (par exemple, Cliquer sur l’alias dans l’e-mail ou A cliqué sur l’alias dans une Campaign ou une étape de Canvas) nécessitent une étape Message ayant déjà envoyé le message contenant ce lien. Ajoutez ou réorganisez des étapes afin 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.

Quel est l’impact des horodatages historiques d’événements personnalisés sur les Canvas et Campaigns par événement ?

Braze évalue les parcours par événement lorsque les événements qualifiants sont ingérés et que l’utilisateur répond à vos règles d’audience. Des événements personnalisés antidatés peuvent déclencher l’entrée dans un Canvas si leur horodatage 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 se situe en dehors de cette fenêtre, si le Canvas ou la Campaign n’était pas actif, ou si l’utilisateur ne correspondait pas encore à votre audience.

Comparez les horodatages des événements aux heures de mise en production, aux paramètres de fenêtre d’entrée et à l’appartenance aux segments à l’aide du journal d’activité du profil utilisateur et des étapes décrites dans Résolution des problèmes liés aux événements personnalisés. Si le comportement ne correspond toujours pas à vos attentes, contactez le support de Braze.

New Stuff!