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.

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

Oui. L’objet de contexte Canvas (propriétés d’entrée Canvas) a une taille maximale de 50 Ko. Gardez les payloads aussi compacts que possible dans cette limite. 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 au niveau du cluster, empêchant l’envoi des messages. Pour 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 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 l’allocation é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 diviser le parcours utilisateur, ajouter un délai, ou même tester 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 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 avancer. 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 en production immédiatement, permettant en effet d’enregistrer un brouillon.

Nous vous recommandons de vérifier la vue analytique des 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 un traitement pour chaque étape — ils s’exécutent à peu près en même temps, et l’un d’entre eux « gagne ». En pratique, cela peut être réparti de manière relativement équitable, 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 précisément à 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 les 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 effectué un certain événement à l’avance, 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 des étapes d’un Canvas multi-étapes, les utilisateurs qui faisaient déjà partie de l’audience mais qui 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 points suivants s’appliquent :

• Les utilisateurs ne pourront plus entrer dans le Canvas.
• Plus aucun message 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 de différentes approches pour construire votre parcours utilisateur. La flexibilité de Canvas vous permet de cartographier les parcours utilisateurs pour toute étape du cycle de vie utilisateur. Consultez nos modèles Canvas de Braze pour plusieurs exemples d’approches simplifiées afin 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 début de la session suivante. Cela signifie que si l’utilisateur entre dans l’étape du Canvas avant que le Canvas ne soit arrêté, il recevra quand même le message in-app au début de sa prochaine 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.

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 qu’« envoyés » (push) par Braze. Les messages in-app pour les utilisateurs éligibles sont automatiquement distribués au début 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 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 ?

Après les étapes de délai en amont et les vérifications d’audience, les utilisateurs deviennent éligibles à un message in-app uniquement lorsqu’ils atteignent l’étape de 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. » apparaî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 de 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 du message 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é de haut niveau du Canvas. Ouvrez le Canvas, sélectionnez l’étape de message et consultez l’engagement in-app à cet endroit. Pour les concepts de reporting, consultez Analyse Canvas.

Puis-je planifier des horaires d’envoi différents pour chaque variante dans la même étape de message Canvas ou le même envoi multivarié ?

Non. Les variantes dans la même configuration multivariée ou étape de message partagent un même calendrier de distribution. Vous ne pouvez pas attribuer l’envoi d’une variante à 18 h et celui 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 :

• Séparez les étapes de message avec des étapes de délai entre elles afin que chaque message ait sa propre planification.
• Utilisez des branches ou une étape de chemin d’expérience pour que les utilisateurs suivent des parcours avec des horaires différents.
• Utilisez des Campaigns séparées si le cas d’usage ne nécessite pas 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 à la limite de fréquence globale lors d’une étape de message Canvas ?

Il ne reçoit pas cet envoi pour le canal limité, mais les étapes de message font quand 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 de 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 les Campaigns, notamment les limites de fréquence, les filtres stricts d’appareils ou de navigateurs, les fenêtres de rééligibilité, la limitation du débit et les exclusions au niveau du canal (par exemple, l’accessibilité push ou les vérifications d’abonnement et de livrabilité e-mail).

Des facteurs spécifiques au 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 retrait 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 hors de la communication.
• Heures calmes et délais : les messages peuvent être retenus ou reprogrammés, décalant les envois hors de la fenêtre de reporting que vous consultez.
• Limites d’entrée maximale ou de plafond 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 analytique 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 de branches peuvent augmenter le nombre de profils touchant le parcours par rapport à cet 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 d’audience estimée ?.

Pourquoi les Destinataires uniques sont-ils supérieurs au nombre d’utilisateurs que j’ai ciblés ?

Les Destinataires uniques peuvent être supérieurs à l’audience attendue, car Braze suit les destinataires uniques quotidiens pour le reporting des Canvas et des Campaigns. 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 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 produire plusieurs Destinataires uniques sur plusieurs jours.

Pourquoi mon Canvas connaît-il des taux d’envoi en baisse ?

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 un nombre de membres 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 vitesse de distribution et d’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 l’historique d’appartenance ?

Les graphiques d’historique d’appartenance utilisent des échantillons estimés, de sorte que les petits Segments — y compris les Segments de groupe de contrôle global — peuvent afficher des variations quotidiennes même lorsque l’audience sous-jacente est stable. Pour comprendre le fonctionnement des estimations et les raisons des fluctuations des graphiques, consultez Consulter l’historique de la taille d’appartenance à un Segment.

Analyse et conversions

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

Le tableau de bord des 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 selon 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 un 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’affichera que les conversions survenues lorsque cette étape était la dernière reçue par l’utilisateur.

Développer pour voir les 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ésumé 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.

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 car 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 que chacun a réalisées.
• 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 par étape reflète le nombre d’individus 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 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 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 é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 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 remettez pas 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 vierge), puis sélectionnez Reprendre ou lancez selon vos besoins. Consultez Archiver des Campaigns 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 Campaign ?

Lorsqu’une étiquette est supprimée de votre espace de travail, Braze la retire de chaque Campaign et Canvas qui y faisait référence. Ce nettoyage ne génère pas toujours sa propre ligne dans le journal des modifications d’un 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 Canvas Details. Vous pouvez y 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 sont mis à jour après que Braze enregistre 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 d’é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 que les statistiques Canvas ou Campaign. En effet, les statistiques Canvas et Campaign sont des nombres que Braze incrémente lorsque quelque chose 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 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 en cas d’utilisation d’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 l’évaluation des actions de déclenchement.

Que se passe-t-il avec 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.

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 à 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 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 obtenir 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 ou non entrés dans le Canvas. Cela inclut 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 sera ni dans le groupe de contrôle ni dans une variante.

Éditeur de Canvas original

Développer pour voir les FAQ de l’éditeur de Canvas original

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

Vous pouvez cloner votre Canvas. Cela crée une copie de votre Canvas original dans le workflow Canvas le plus récent.

Quelles sont les principales différences entre les éditeurs de Canvas actuel et original ?

Barre d’outils des composants Canvas

Auparavant, avec l’éditeur de 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 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 voir immédiatement 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. Ces paramètres sont séparés dans l’éditeur actuel afin de rendre votre expérience de création de Canvas plus personnalisable et d’introduire 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 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 séparé pour filtrer les utilisateurs qui n’ont pas reçu l’étape précédente.

Comportement du délai « dans »

Les composants 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 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 original, 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

Puisque le timing intelligent est intégré au composant 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 créé avec le workflow Canvas original.

Supposons que votre délai est configuré 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 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 original : 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 séparés des étapes Message. Les heures calmes sont appliquées dans le composant Message. Cela signifie que si un utilisateur a déjà passé l’étape des 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 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 Message dispose de validations de livraison 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 lors de la soumission d’un ticket de support 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 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 est 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 actifs, les messages déjà envoyés au fournisseur de services d’e-mailing sont-ils tout de même distribués ?

Oui. Après que Braze a envoyé une requête à votre fournisseur de services d’e-mailing (ESP), Braze ne peut pas annuler cet envoi. Arrêter un Canvas ou une Campaign empêche de nouvelles requêtes d’envoi, mais les messages déjà transmis à l’ESP peuvent encore ê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 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 a été 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 de 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 sur la journalisation de votre endpoint plutôt que sur des requêtes d’image 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 changez la méthode en 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 supportant un body 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 marque substitutive 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 devraient appeler un endpoint réel. 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 a été 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 en aval valide. Si le Canvas ne se charge toujours pas, contactez le support Braze avec l’ID du Canvas et une capture d’écran de l’erreur de console.

Pourquoi l’horodatage de 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 à l’horodatage de l’événement de conversion et aux paramètres de votre fenêtre de conversion Canvas.

Pourquoi canvas_step_name est-il null dans Currents ?

Les champs de nom de Campaign et de Canvas tels que 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 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’ID 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 une entrée par événement ou déclenchée par API. Le ciblage Canvas standard 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 réalisé 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, une seule entrée est traitée.

Pour permettre 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 similaire à celui des Campaigns qui permet plusieurs déclencheurs dans la même seconde, comparez votre cas d’usage aux Campaigns avec des 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 arrive-t-elle sur la mauvaise application, alors que les envois en production semblent corrects ?

La fonction Test push sur un profil utilisateur envoie la notification à chaque appareil activé 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 n’est pas nécessairement 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 appuyer uniquement sur le Test push du profil.

Pour les étapes Message d’un Canvas avec plusieurs applications, activez Valider l’audience au moment de l’envoi 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 la 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 identifier 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 minuteries se terminent, notamment dans les étapes Délai. Le comportement diffère également entre les étapes planifiées et les étapes déclenchées par événement. Pour les chronologies, les 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 de sorte 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 aux 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, ou si l’utilisateur ne correspondait pas encore à votre audience.

Comparez les horodatages des événements aux dates de mise en production, aux paramètres de la 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 à vos attentes, contactez le support Braze.