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 (par exemple, informer les utilisateurs d’un produit avec un seul message). Utilisez les Canvas pour des parcours utilisateur à plusieurs étapes (par exemple, envoyer des suggestions de produits personnalisées en fonction du comportement de l’utilisateur au fil du temps).

• campaign
• canvas

Étape 2 : Spécifier vos types de messages

Sélectionnez l’un des trois types essentiels de Content Cards : Classique, Image légendée et Image uniquement.

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

Type de message	Exemple	Description
Classique		La carte classique présente une mise en page simple avec un titre en gras, un texte de message et une image facultative placée 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 classique.
Image légendée		La carte image légendée met en valeur votre contenu avec du texte et une image accrocheuse.
Image uniquement		La carte image uniquement attire l’attention avec un espace dédié aux images, aux GIF et à d’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 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 proposée. 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 aux emplacements appropriés 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 largement de la manière dont les fournisseurs de services les rendent. Pour 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

Écrivez 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. Sélectionner Ajouter une image ouvre la bibliothèque multimédia, où vous pouvez sélectionner une image précédemment téléchargée ou en ajouter une nouvelle.

Chaque type de message et plateforme peut avoir ses propres proportions et exigences recommandées, alors assurez-vous de vérifier celles-ci avant de commander ou de créer une image à partir de zéro. Gardez à l’esprit que les champs des messages de Content Cards sont limités à 2 Ko au total.

Épingler en haut

Braze affiche une carte épinglée en haut du flux d’un utilisateur, et l’utilisateur 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 d’épinglage 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 le diriger plus en profondeur 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 dans l’application	Deep link vers un écran existant dans 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 SDK suivantes :

Étape 4 : Configurer les 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 : Vérifier et déployer

Une fois la création de votre Campaign ou Canvas terminée, vérifiez ses détails, testez-la, puis envoyez-la. Pour en savoir plus, consultez Envoyer des messages de test.

Ensuite, consultez les 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 sont soumises à deux contraintes principales : une limite de taille pour le payload de chaque carte et un nombre maximum de cartes pouvant apparaître dans un flux.

Limites de taille des Content Cards

Le payload complet d’une seule Content Card ne peut pas dépasser 2 Ko après le rendu de toute personnalisation Liquid. Cela comprend :

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

L’utilisation de Liquid pour extraire de longues chaînes de texte (par exemple à 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 abandonné au moment de l’envoi. Vous pouvez consulter ces abandons dans le journal d’activité des messages avec la raison Content card maximum size exceeded.

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

• Utilisez des raccourcisseurs d’URL pour les liens longs. Les URL, en particulier celles comportant de nombreux paramètres de suivi, peuvent poser des problèmes de taille. L’utilisation d’un service de raccourcissement d’URL peut réduire considérablement 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 les filtres Liquid comme truncate pour limiter la longueur de tout texte dynamique.
• Soyez efficace avec les URL multi-plateformes. La limite de 2 Ko inclut les URL de toutes les plateformes que vous définissez. L’utilisation d’URL longues et 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 si nécessaire.
• Envisagez les Banners pour du contenu plus riche. Pour les cas d’usage nécessitant régulièrement de grandes quantités de contenu, les Content Cards ne sont peut-être pas le bon canal. 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 l’expérience d’une application ou d’un site web.

Nombre de cartes dans le flux

Chaque utilisateur peut disposer de 250 Content Cards non expirées au maximum dans son flux à tout moment. Lorsque cette limite est dépassée, Braze cesse de renvoyer 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 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 facteur temps (comme une promotion de week-end), définissez une date d’expiration précise. De cette façon, les cartes sont automatiquement retirées du flux et ne comptent plus dans la limite une fois qu’elles ne sont plus pertinentes.
• Tirez parti de la suppression par événement : configurez des événements de suppression pour les cartes transactionnelles ou basées sur des objectifs. Par exemple, une carte invitant un utilisateur à compléter son profil doit être supprimée dès qu’un événement profile_completed est enregistré.
• Auditez les Campaigns de longue durée : passez en revue les Campaigns récurrentes ou continues pour vous assurer qu’elles ne dégradent pas l’expérience de 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 ce fonctionnement est essentiel pour gérer les Campaigns récurrentes et s’assurer que les utilisateurs ne reçoivent pas de messages en double ou obsolètes.

Comment la rééligibilité est calculée

Si vous activez la rééligibilité, le compte à rebours avant 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ébute dépend de vos paramètres de création de carte :

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

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

Une source fréquente de confusion 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 leur 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 à nouveau la même carte après 30 jours. Lorsque la carte d’origine est purgée, le système ne voit plus de trace de la réception de cette Campaign par l’utilisateur, ce qui le rend à nouveau éligible lors de sa prochaine session.

Pour que les utilisateurs ne reçoivent un message d’une Campaign spécifique qu’une seule fois, 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’éviter les envois en double des Campaigns de longue durée.

Gérer les Content Cards en cours

Après l’envoi des Content Cards, elles restent en attente dans une « boîte de réception » prêtes à être délivré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 seulement ê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 d’origine 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 de la nouvelle version. Utilisez des 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 ceux 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 ayant reçu la carte précédente doivent être rééligibles dans X jours, vous pouvez définir le filtre Last Received Message from specific campaign sur plus de X jours OU Received Message from Campaign avec la condition Has Not.

Impact

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

Supposons que vous ayez défini une Campaign déclenchée par le démarrage d’une session, avec une rééligibilité fixée à 30 jours. Un utilisateur a reçu la Campaign il y a deux jours et vous souhaitez modifier le texte. Commencez par archiver la Campaign et supprimer les cartes du flux. Ensuite, dupliquez la Campaign et relancez-la avec le nouveau texte. Si l’utilisateur démarre une autre session, il reçoit immédiatement la nouvelle carte.

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

Cette approche conserve toutes vos analyses unifiées dans une seule Campaign. Les utilisateurs nouvellement éligibles reçoivent la nouvelle carte, mais la mise à jour est retardée 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 sont 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 pour les versions de cartes lancées. Braze ne différencie pas les versions lancées.

Supposons que vous ayez une Campaign déclenchée par le démarrage d’une session avec une rééligibilité fixée à 30 jours. Un utilisateur a reçu la Campaign il y a deux jours et vous souhaitez modifier le texte. Commencez par arrêter la Campaign et supprimer la carte du flux. Ensuite, republiez la Campaign avec le nouveau texte. Si l’utilisateur démarre une autre session, il reçoit la nouvelle carte dans 28 jours.

Supprimer et faire expirer des 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 automatique 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 déclenche cet événement, la carte est retirée de son flux lors d’un rafraîchissement ultérieur, après que Braze a traité l’événement.

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 de ses systèmes.

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émarrage de la 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 sont rafraîchies au démarrage de la session. 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 supprime 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 générer d’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 se produit car :

• L’événement déclencheur est envoyé 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
• Le SDK se synchronise et récupère toutes les cartes disponibles sur l’appareil

Si la synchronisation du SDK a lieu avant que l’éligibilité de l’utilisateur ne soit enregistrée, l’utilisateur ne reçoit pas la carte.

Pour les nouveaux utilisateurs lors de leur première session, ce délai est inévitable. Pour les utilisateurs existants qui ont besoin d’une disponibilité instantanée, envisagez d’utiliser la distribution planifiée à la place.

Si vous devez minimiser les délais pour les nouveaux utilisateurs 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éclenchement 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 afin d’améliorer la latence, consultez Améliorer la faible latence pour les Content Cards.

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

Les horodatages d’impression et de rejet dans les analyses et Currents reflètent le moment où un utilisateur consulte ou rejette 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 rejet 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 par rapport au fuseau horaire de l’utilisateur dans Currents.
• Vérifiez que l’utilisateur a effectivement consulté ou rejeté 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 des Content Cards.

Erreur « Toutes les valeurs d’expiration d’une Campaign doivent correspondre »

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 horaire spécifique) sur 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 de distribution ou un déclencheur.