Créer une carte de contenu

Cet article explique comment créer une carte de contenu dans Braze lors de la création de Campaigns et de Canvas. Nous vous guiderons dans le choix d’un type de message, la rédaction de votre carte et la planification de la distribution de votre message.

Étape 1 : Choisir où créer votre message

Utilisez les Campaigns pour des communications simples et ponctuelles (comme informer les utilisateurs d’un produit avec un seul message). Utilisez les Canvas pour des parcours utilisateur à plusieurs étapes (comme l’envoi de suggestions de produits personnalisées en fonction du comportement de l’utilisateur au fil du temps).

• campaign
• canvas

Étape 2 : Spécifiez vos types de messages

Sélectionnez l’un des trois types essentiels de Content Cards : Classic, Captioned Image et Image Only.

Pour en savoir plus sur le comportement attendu et l’apparence de chaque type, consultez les Détails créatifs, ou consultez les liens dans le tableau suivant. Ces types de Content Cards sont acceptés par les applications mobiles et les applications web.

Type de message	Exemple	Description
Classic		La carte Classic a une mise en page simple avec un titre en gras, un texte de message et une image facultative qui se positionne au début du titre et du texte. Il est préférable d’utiliser une image carrée ou une icône avec la carte Classic.
Captioned Image		La carte Captioned Image met en valeur votre contenu avec du texte et une image accrocheuse.
Image Only		La carte Image Only attire l’attention avec un espace dédié aux images, GIFs et autres contenus créatifs non textuels.

Étape 3 : Composer une Content Card

Vous pouvez modifier tous les aspects du contenu et du comportement de votre message dans l’onglet Composer de l’éditeur de messages.

Le contenu affiché ici varie en fonction du type de carte choisi à l’étape précédente, mais peut inclure l’une des options suivantes :

Langue

Sélectionnez Ajouter des langues pour ajouter les langues souhaitées à partir de la liste fournie. Cela insère du Liquid dans votre message. Nous vous recommandons de sélectionner vos langues avant de rédiger votre contenu afin de pouvoir remplir votre texte à l’emplacement approprié dans le Liquid. Pour consulter la liste complète des langues disponibles, voir Langues prises en charge.

Créer des messages de droite à gauche

L’apparence finale des messages de droite à gauche dépend en grande partie de la manière dont les fournisseurs de services les affichent. Pour connaître les bonnes pratiques de création de messages de droite à gauche qui s’affichent aussi fidèlement que possible, consultez Créer des messages de droite à gauche.

Titre et message

Rédigez ce que vous souhaitez. Il n’y a pas de limites, mais plus vite vous transmettez votre message et incitez votre client à cliquer, mieux c’est ! Nous recommandons des titres et des contenus de message clairs et concis. Notez que ces champs ne sont pas disponibles pour les cartes de type Image uniquement.

Image

Pour ajouter une image à votre Content Card, vous pouvez sélectionner Ajouter une image ou fournir une URL d’image. En sélectionnant Ajouter une image, vous ouvrez la bibliothèque multimédia, où vous pouvez sélectionner une image déjà téléchargée ou en ajouter une nouvelle.

Chaque type de message et chaque plateforme peut avoir ses propres proportions et exigences recommandées, alors vérifiez-les avant de commander ou de créer une image de zéro. Gardez à l’esprit que les champs de message des Content Cards sont limités à une taille totale de 2 Ko.

Épingler en haut

Braze affiche une carte épinglée en haut du flux d’un utilisateur et celui-ci ne peut pas la rejeter. Si le flux d’un utilisateur contient plusieurs cartes épinglées, Braze les classe par ordre chronologique. Lorsque Braze distribue une Content Card, elle est soit épinglée, soit non épinglée, et ce statut ne change pas pendant toute la durée de vie de la carte. Si vous modifiez le paramètre d’épinglage d’une Campaign, la mise à jour s’applique uniquement aux cartes envoyées après la modification. Elle ne modifie pas le statut épinglé des cartes déjà présentes dans le flux d’un utilisateur.

Comportement au clic

Lorsque votre client clique sur un lien présenté dans la carte, votre lien peut soit l’amener plus profondément dans votre application, soit vers un autre site. Si vous choisissez un comportement au clic pour votre Content Card, n’oubliez pas de mettre à jour votre texte du lien en conséquence.

Les actions suivantes sont disponibles pour les liens des Content Cards :

Action	Description
Rediriger vers une URL web	Ouvrir une page web non native.
Deep link vers l’application	Créer un deep link vers un écran existant de votre application.
Enregistrer un événement personnalisé	Choisir un événement personnalisé à déclencher. Peut être utilisé pour afficher une autre Content Card ou déclencher des messages supplémentaires.
Enregistrer un attribut personnalisé	Choisir un attribut personnalisé à définir pour l’utilisateur actuel.

Les options Enregistrer un événement personnalisé et Enregistrer un attribut personnalisé nécessitent la compatibilité avec les versions minimales suivantes du SDK :

Étape 4 : Configurer des paramètres supplémentaires (facultatif)

Vous pouvez utiliser des paires clé-valeur pour créer des catégories pour vos cartes, créer plusieurs flux de Content Cards et personnaliser la façon dont les cartes sont triées.

Pour ajouter des paires clé-valeur à votre message, accédez à l’onglet Paramètres et sélectionnez Ajouter une nouvelle paire.

Étape 5 : Construire le reste de votre campagne ou Canvas

• campaign
• canvas

Étape 6 : Réviser et déployer

Une fois que vous avez terminé de créer votre Campaign ou Canvas, vérifiez ses détails, testez-le, puis envoyez-le. Pour plus d’informations, consultez Envoyer des messages de test.

Ensuite, consultez Rapports sur les Content Cards pour découvrir comment accéder aux résultats de vos campagnes de Content Cards.

Ce qu’il faut savoir

Limites de payload et de flux

Pour garantir les performances, les Content Cards ont deux contraintes clés : une limite de taille du payload pour chaque carte et un nombre maximal de cartes pouvant apparaître dans un flux.

Limites de taille pour les Content Cards

L’ensemble du payload de données d’une seule Content Card ne peut pas dépasser 2 Ko après le rendu de toute personnalisation Liquid. Cela inclut :

• Le titre
• Le message
• L’URL de l’image (la longueur de la chaîne URL elle-même, pas la taille du fichier image)
• Le texte du lien
• Les URLs de lien pour toutes les plateformes spécifiées (des URLs distinctes pour iOS, Android et Web comptent toutes dans le total)
• Les paires clé-valeur (les noms des clés et leurs valeurs)

L’utilisation de Liquid pour intégrer de longues chaînes de texte (comme à partir d’attributs personnalisés) peut vous amener à dépasser la limite.

Le compositeur de Campaign affiche un avertissement si votre contenu statique dépasse la limite. Nous ne prédisons pas la taille du contenu dynamique utilisant Liquid. Si la taille du message dépasse 2 Ko, il est annulé au moment de l’envoi. Vous pouvez consulter ces annulations dans Messaging Observability avec le résultat Content Card invalid.

Voici quelques bonnes pratiques pour gérer la taille du payload des Content Cards :

• Utilisez des raccourcisseurs d’URL pour les liens longs. Les URLs, en particulier celles comportant de nombreux paramètres de suivi, peuvent poser des problèmes de limite de taille. L’utilisation d’un service de raccourcissement d’URL peut considérablement réduire le nombre de caractères et libérer de l’espace dans le payload.
• Tronquez le contenu dynamique avec Liquid. Lorsque vous personnalisez des cartes avec du texte dynamique provenant d’attributs utilisateur ou d’appels API, la longueur du contenu peut être imprévisible. Utilisez de manière proactive des filtres Liquid comme truncate pour limiter la longueur de tout texte dynamique.
• Soyez efficace avec les URLs multi-plateformes. La limite de 2 Ko inclut les URLs pour toutes les plateformes que vous définissez. L’utilisation de longues URLs uniques pour chaque plateforme peut multiplier la taille du payload. Si possible, utilisez un lien unique fonctionnant sur toutes les plateformes, ou utilisez des raccourcisseurs d’URL selon les besoins.
• Envisagez les Banners pour un contenu plus riche. Pour les cas d’usage nécessitant systématiquement de grandes quantités de contenu, les Content Cards ne sont peut-être pas le canal le plus adapté. Les Banners n’ont pas la même limitation de payload de 2 Ko et sont mieux adaptés pour intégrer du contenu plus riche directement dans une expérience d’application ou de site web.

Nombre de cartes dans le flux

Chaque utilisateur peut avoir jusqu’à 250 Content Cards non expirées dans son flux à tout moment. Lorsque cette limite est dépassée, Braze cesse de retourner les cartes les plus anciennes, même si elles n’ont pas été lues. Les cartes rejetées comptent également dans cette limite, ce qui signifie qu’un nombre élevé de cartes rejetées peut réduire l’espace disponible pour les cartes plus anciennes.

Pour éviter les problèmes liés à la limite de cartes, nous recommandons les bonnes pratiques suivantes :

• Utilisez des dates d’expiration plus courtes : pour les Campaigns sensibles au temps (comme une vente de fin de semaine), définissez une date d’expiration spécifique. Ainsi, les cartes sont automatiquement retirées du flux et ne comptent plus dans la limite une fois qu’elles ne sont plus pertinentes.
• Exploitez la suppression par événement : configurez des événements de suppression pour les cartes transactionnelles ou basées sur un objectif. Par exemple, une carte invitant un utilisateur à compléter son profil devrait être supprimée dès qu’un événement profile_completed est enregistré.
• Auditez les Campaigns de longue durée : examinez les Campaigns récurrentes ou en cours pour vous assurer qu’elles ne créent pas une mauvaise expérience pour vos utilisateurs en remplissant le flux avec trop de cartes au fil du temps.

Comprendre la rééligibilité pour les Content Cards

La rééligibilité détermine si et quand un utilisateur peut recevoir un message de la même Campaign plus d’une fois. Pour les Content Cards, comprendre comment cela fonctionne est essentiel pour gérer les Campaigns récurrentes et s’assurer que les utilisateurs ne reçoivent pas de messages dupliqués ou obsolètes.

Comment la rééligibilité est calculée

Si vous activez la rééligibilité, le compte à rebours pour qu’un utilisateur puisse « réintégrer » une Campaign commence après l’envoi du message. Le moment précis où ce compte à rebours démarre dépend de vos paramètres de création de carte :

• Les Content Cards utilisant à la première impression utilisent le moment de l’impression pour calculer la rééligibilité.
• Les Content Cards créées au lancement de la Campaign, dans des Campaigns multicanales, ou à l’entrée d’une étape du Canvas utilisent le moment d’envoi ou le moment d’impression le plus récent.

L’expiration de 30 jours et la rééligibilité

Une source de confusion courante est l’interaction entre la rééligibilité de la Campaign et l’expiration automatique de 30 jours de toutes les Content Cards.

Toutes les Content Cards sont automatiquement purgées des systèmes de Braze 30 jours après leur envoi ou suppression. Si vous avez une Campaign récurrente de longue durée avec la rééligibilité désactivée, un utilisateur peut tout de même recevoir la même carte après 30 jours. Lorsque la carte originale est purgée, le système ne voit plus de trace indiquant que cet utilisateur a reçu la Campaign, ce qui le rend à nouveau éligible lors de sa prochaine session.

Pour que les utilisateurs ne reçoivent qu’un seul message d’une Campaign spécifique, ajoutez un filtre d’audience à votre Campaign ou étape du Canvas pour les utilisateurs qui n’ont pas reçu de message de cette Campaign. Ce filtre est le moyen le plus fiable d’empêcher les envois dupliqués dans les Campaigns de longue durée.

Gérer les Content Cards en direct

Une fois les Content Cards envoyées, elles restent en attente dans une « boîte de réception » prêtes à être distribuées à l’utilisateur (de manière similaire à ce qui se passe pour les e-mails). Une fois que le contenu est intégré dans la Content Card (au moment de l’affichage), il ne peut plus être modifié pendant sa durée de vie. Cela s’applique même si vous appelez une API via le contenu connecté et que les données de l’endpoint changent. Ces données ne sont pas mises à jour. L’envoi peut uniquement être arrêté pour les nouveaux utilisateurs et les cartes peuvent être retirées des flux des utilisateurs. Si vous modifiez une Campaign, seules les cartes envoyées après la modification incluent la mise à jour.

Mettre à jour les cartes lancées

Pour modifier une carte pour les utilisateurs qui l’ont déjà reçue, vous devez utiliser l’une des méthodes suivantes :

Option 1 : Dupliquer la Campaign (recommandé pour les modifications immédiates)

La première approche consiste à archiver la Campaign et à lancer une nouvelle Campaign dupliquée :

1. Arrêtez la Campaign originale et, lorsque vous y êtes invité, sélectionnez Remove card after the next sync.
2. Dupliquez la Campaign, effectuez vos modifications et lancez la nouvelle version.

Lorsque vous dupliquez la Campaign, vous devez définir l’audience pour la nouvelle version. Utilisez les filtres de segmentation pour contrôler qui reçoit la carte mise à jour :

• Si les utilisateurs ne doivent jamais être rééligibles pour une Content Card, vous pouvez filtrer les utilisateurs qui n’ont pas reçu la version précédente de la Content Card en définissant le filtre Received Message from Campaign sur la condition Has Not.
• Si les utilisateurs qui ont reçu la carte précédente doivent être rééligibles dans X jours, vous pouvez définir le filtre pour Last Received Message from specific campaign à plus de X jours OU Received Message from Campaign avec la condition Has Not.

Impact

• Destinataires existants : les destinataires nouveaux et existants voient la carte mise à jour lors du prochain rafraîchissement du flux s’ils sont éligibles.
• Reporting : chaque version de la carte dispose d’analyses séparées.

Supposons que vous configurez une Campaign déclenchée par un début de session, avec une rééligibilité définie à 30 jours. Un utilisateur a reçu la Campaign il y a deux jours et vous souhaitez modifier le texte. Premièrement, archivez la Campaign et retirez les cartes du flux. Deuxièmement, dupliquez la Campaign et relancez-la avec le nouveau texte. Si l’utilisateur a une autre session, il reçoit immédiatement la nouvelle carte.

Option 2 : Arrêter et relancer la même Campaign

Cette approche maintient toutes vos analyses unifiées dans une seule Campaign. Les utilisateurs nouvellement éligibles reçoivent la nouvelle carte, mais cela retarde la mise à jour pour les destinataires existants jusqu’à ce qu’ils soient rééligibles :

1. Arrêtez votre Campaign et, lorsque vous y êtes invité, sélectionnez Remove card after the next sync.
2. Modifiez votre Campaign selon vos besoins.
3. Redémarrez votre Campaign.

Impact

• Destinataires existants : les utilisateurs qui ont déjà reçu la carte ne reçoivent pas les cartes mises à jour tant qu’ils ne deviennent pas rééligibles. Si la rééligibilité est désactivée, ils ne reçoivent jamais la nouvelle carte.
• Reporting : une seule Campaign contient toutes les analyses de reporting pour les versions de cartes lancées. Braze ne différencie pas les versions lancées.

Supposons que vous avez une Campaign déclenchée par un début de session avec une rééligibilité définie à 30 jours. Un utilisateur a reçu la Campaign il y a deux jours et vous souhaitez modifier le texte. Premièrement, arrêtez la Campaign et retirez la carte du flux. Deuxièmement, republiez la Campaign avec le nouveau texte. Si l’utilisateur a une autre session, il reçoit la nouvelle carte dans 28 jours.

Retirer et expirer les cartes

Suppression manuelle des cartes

Vous pouvez supprimer manuellement les cartes des flux de tous les utilisateurs à tout moment en arrêtant la Campaign.

1. Ouvrez la Campaign de Content Cards et sélectionnez Stop Campaign.
2. Lorsque vous y êtes invité, sélectionnez Remove card after the next sync. La carte est supprimée lors du prochain rafraîchissement du flux.

Suppression automatisée des cartes

Vous pouvez supprimer automatiquement une carte lorsqu’un utilisateur effectue une action spécifique, comme finaliser un achat ou activer une fonctionnalité.

Dans votre Campaign ou étape du Canvas, spécifiez un événement de suppression. Lorsqu’un utilisateur effectue cet événement, Braze traite l’événement puis supprime la carte de son flux.

Expiration des cartes

Les Content Cards restent disponibles jusqu’à 30 jours après leur envoi ; après 30 jours, Braze les retire des flux des utilisateurs et les purge des systèmes de Braze.

Faire durer les cartes au-delà de 30 jours

Si vous souhaitez qu’une carte semble toujours disponible, vous pouvez créer une Campaign récurrente qui remplace effectivement la carte tous les 30 jours :

1. Définissez la durée de la Content Card à 30 jours.
2. Définissez la rééligibilité de la Campaign à 30 jours.
3. Configurez la Campaign pour se déclencher au « Début de session ».

Synchronisation et rafraîchissement des Content Cards

Les Content Cards se synchronisent selon un calendrier et lorsque votre application rafraîchit le flux. Le comportement de synchronisation diffère entre les synchronisations complètes et partielles, et votre intégration SDK affecte le moment où les cartes se rafraîchissent au début de session. Sur les versions du SDK prises en charge, Braze distribue également les envois et les suppressions pendant une session active grâce à la distribution en temps réel. Pour les détails d’implémentation, consultez Personnaliser le flux de Content Cards et Créer des Content Cards.

Impact de l’arrêt des Campaigns de Content Cards

Lorsque vous arrêtez une Campaign et sélectionnez Remove card after the next sync, Braze retire la carte des flux des utilisateurs lors du prochain rafraîchissement. Le nombre d’impressions peut être inférieur au nombre d’envois car les utilisateurs ne peuvent pas enregistrer des impressions sur des cartes supprimées avant qu’ils ne les aient consultées.

Résolution des problèmes

Pourquoi les Content Cards n’apparaissent-elles pas immédiatement après un événement déclencheur ?

Pour les Campaigns à livraison par événement (comme le démarrage de session), il y a un court délai attendu entre l’événement déclencheur et la disponibilité de la carte. Ce délai s’explique par les étapes suivantes :

• L’événement déclencheur est transmis aux serveurs de Braze
• La Campaign est déclenchée et l’éligibilité de l’utilisateur est enregistrée
• La Content Card est créée dans la base de données pour cet utilisateur
• La carte parvient à l’appareil

Sur les versions du SDK compatibles, la distribution en temps réel envoie la carte à l’appareil dès que Braze la crée, de sorte qu’elle arrive pendant la session en cours. Sur les versions antérieures, le SDK récupère la carte lors de sa prochaine synchronisation, et une synchronisation effectuée avant l’enregistrement de l’éligibilité de l’utilisateur ne renvoie rien.

Pour les nouveaux utilisateurs lors de leur première session, ce délai de traitement est inévitable. Pour les utilisateurs existants nécessitant une disponibilité immédiate, envisagez d’utiliser une distribution planifiée à la place.

Si vous devez minimiser les délais pour les nouveaux comme pour les utilisateurs existants, vous pouvez créer deux Campaigns :

• Utilisateurs existants avec un nombre de sessions supérieur à 0 : Utilisez une Campaign à distribution planifiée. Les cartes sont pré-créées et immédiatement disponibles.
• Nouveaux utilisateurs avec un nombre de sessions égal à 0 : Utilisez une Campaign déclenchée par une action. Les cartes sont créées après le premier déclencheur de session.

Cette approche garantit que les utilisateurs existants voient les cartes instantanément, tout en atteignant les nouveaux utilisateurs après un bref délai lors de leur première session. Pour des stratégies supplémentaires visant à améliorer la latence, consultez Améliorer la faible latence pour les Content Cards.

Pourquoi les horodatages d’impression ou de fermeture se situent-ils en dehors de la planification de la Campaign ?

Les horodatages d’impression et de fermeture dans les analyses et Currents reflètent le moment où un utilisateur consulte ou ferme une Content Card, et non le moment où Braze crée ou envoie la carte. Une carte peut rester dans le flux d’un utilisateur jusqu’à ce que les Content Cards soient actualisées, de sorte que les horodatages d’impression et de fermeture peuvent se situer après la fenêtre d’envoi de la Campaign.

Si les horaires semblent toujours inattendus :

• Vérifiez si vous consultez les analyses dans le fuseau horaire de votre entreprise ou dans celui de l’utilisateur dans Currents.
• Assurez-vous que l’utilisateur a effectivement consulté ou fermé la carte après l’avoir reçue, plutôt que de comparer uniquement avec l’heure d’envoi.

Pour en savoir plus sur les indicateurs des Content Cards, consultez Rapports sur les Content Cards.

Erreur « All expiration values for a campaign must match »

Cette erreur apparaît lorsqu’une Campaign de Content Cards multivariée utilise des paramètres d’expiration différents selon les variantes. Définissez la même expiration (durée ou moment précis) pour chaque variante, ou réduisez la Campaign à une seule variante, puis enregistrez à nouveau. Pour savoir comment définir l’expiration lors de la création d’une Campaign, consultez Choisir une planification ou un déclencheur de distribution.