Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.
Contentful
Contentful est un système de gestion de contenu headless qui permet aux équipes de créer, gérer et distribuer du contenu structuré sur n’importe quel canal. L’application Braze pour Contentful connecte ce contenu directement à vos communications Braze : vous pouvez récupérer dynamiquement des entrées Contentful dans vos messages au moment de l’envoi grâce au contenu connecté, ou synchroniser des champs sélectionnés dans des Content Blocks Braze pour les réutiliser dans vos Campaigns et Canvas.
Cette intégration est maintenue par Contentful.
À propos de cette intégration
Cette page explique comment configurer l’application Braze dans Contentful et comment utiliser les ressources Contentful dans Braze. Avec cette intégration, vous pouvez :
- Générer un appel de contenu connecté Braze prêt à coller pour une entrée publiée, ainsi que les balises Liquid nécessaires pour référencer chaque champ dans un message Braze.
- Synchroniser les champs sélectionnés d’une entrée dans un bloc de contenu Braze, avec une locale choisie, afin que le contenu soit disponible nativement dans le tableau de bord de Braze.
Le résultat est une source unique de vérité pour le contenu. Les éditeurs de contenu continuent de travailler dans Contentful avec leurs flux de révision et de localisation existants, et les marketeurs créent des Campaigns dans Braze à partir de contenu déjà approuvé et à jour.
Prérequis
Avant de commencer, vous avez besoin des éléments suivants :
| Condition | Description |
|---|---|
| Un compte Contentful | Un compte Contentful avec un accès Space Admin à l’espace où vous installez l’application. |
| Une clé API Contentful | Une clé API Contentful Content Delivery (CDA) avec un accès en lecture. Créez-la dans Contentful depuis Paramètres > Clés API. |
| Une clé API REST Braze | Une clé API REST Braze avec les permissions content_blocks.create, content_blocks.update, content_blocks.info et content_blocks.list. Créez cette clé dans le tableau de bord de Braze depuis Paramètres > Clés API. Requise uniquement pour la synchronisation des Content Blocks. |
| Un endpoint REST Braze | L’URL de votre endpoint REST Braze. Votre endpoint dépend de l’URL Braze de votre instance. Requis uniquement pour la synchronisation des Content Blocks. |
Intégration
Étape 1 : Installer l’application Braze dans Contentful
- Connectez-vous à l’application web Contentful.
- Sélectionnez Apps > Marketplace.
- Localisez l’application Braze et sélectionnez-la.
- Sélectionnez Install. La fenêtre Manage app access apparaît.
- Sous Environments, sélectionnez les environnements dans lesquels vous souhaitez installer l’application.
- Sélectionnez Authorize access. L’écran de configuration de l’application apparaît.
- Dans Contentful API key, saisissez votre clé API Content Delivery.
- Pour activer la synchronisation des Content Blocks, saisissez votre clé REST API Braze et sélectionnez votre endpoint REST Braze.
- Sélectionnez Install to selected environments.
Remarque
Si une erreur indiquant qu’une clé API Contentful valide est requise s’affiche, vérifiez que la clé dispose d’un accès en lecture à l’API Content Delivery (CDA).
Étape 2 : Ajouter l’application Braze à un type de contenu
- Dans l’application web Contentful, accédez à l’onglet Content model.
- Sélectionnez un type de contenu existant ou créez-en un nouveau.
- Faites défiler jusqu’à la section Sidebar.
- Ajoutez Braze à partir de la liste des éléments disponibles.
- Sélectionnez Save.
Répétez cette opération pour chaque type de contenu que vous souhaitez rendre disponible dans Braze.
Étape 3 : Connecter une entrée à Braze
- Accédez à l’onglet Content et sélectionnez Add entry, en choisissant un type de contenu dont la barre latérale contient l’application Braze. Vous pouvez également ouvrir une entrée existante.
- Remplissez les champs de l’entrée et publiez l’entrée. Braze ne peut récupérer que le contenu publié.
- Dans la barre latérale de l’entrée, sélectionnez Generate Braze Connected Content pour générer un appel de contenu connecté et des balises Liquid à coller dans un message Braze, ou Create Content Block pour envoyer les champs sélectionnés vers Braze en tant que Content Block.
Synchroniser les Content Blocks
Étape 1 : Synchroniser une entrée avec un Content Block Braze
- Ouvrez une entrée publiée dont la barre latérale contient l’application Braze.
- Dans la barre latérale, sélectionnez Create Content Block.
- Sélectionnez la locale à utiliser. Un Content Block est créé par locale sélectionnée.
- Sélectionnez les champs à inclure dans le Content Block.
- Sélectionnez Send to Braze. Le Content Block est créé dans votre espace de travail Braze et est disponible sous Content > Content Block.
Étape 2 : Maintenir le contenu synchronisé à jour
Choisissez la méthode qui correspond à la fréquence de modification du contenu :
- La synchronisation des Content Blocks convient au contenu qui est stable au moment de l’envoi et réutilisé dans de nombreux messages. Il est rendu sans appel externe.
- Le contenu connecté convient au contenu susceptible de changer entre le moment où une Campaign est créée et le moment où elle est distribuée, car le contenu est récupéré à la réception.
Pour en savoir plus sur le fonctionnement de l’application Braze dans Contentful, consultez la documentation de l’application Braze de Contentful.
Utiliser le contenu connecté
Étape 1 : Ajouter l’appel de contenu connecté à un message Braze
- Dans Contentful, ouvrez une entrée publiée et sélectionnez Generate Braze Connected Content dans la barre latérale.
- Sélectionnez les champs à inclure, puis sélectionnez Next.
- Si l’entrée comporte plusieurs locales, sélectionnez les locales à inclure, puis sélectionnez Next.
- Copiez l’appel de contenu connecté généré.
- Dans Braze, créez ou ouvrez une Campaign ou un message Canvas.
- Collez l’appel de contenu connecté en haut du corps du message.
- Collez les étiquettes Liquid à l’endroit où le contenu doit apparaître.
Étape 2 : Référencer les champs avec Liquid
La notation par points JSON vous permet de spécifier quelle partie du corps de la réponse de Contentful inclure dans votre message. Cela varie en fonction de votre cas d’usage. L’application génère l’étiquette Liquid appropriée pour chaque champ. Les étiquettes sont préfixées par la locale lorsque l’entrée est localisée, et par le type de contenu lorsqu’elle ne l’est pas.
| Scénario | Exemple d’étiquette Liquid |
|---|---|
| Entrée localisée (en-US) | {{response.data.enUS.body}} |
| Entrée localisée (es-AR) | {{response.data.esAR.body}} |
| Entrée non localisée | {{response.data.blogPost.body}} |
| Liste de texte court, concaténée | {{response.data.recipe.ingredients | join: ', '}} |
| Liste de texte court, élément unique | {{response.data.recipe.ingredients[0]}} |
| Champ d’emplacement | {{response.data.venue.address.lat}} et {{response.data.venue.address.lon}} |
| Fichier média unique | {{response.data.blogPost.image.url}} |
| Collection de ressources, élément unique | {{response.data.blogPost.imagesCollection.items[0].url}} |
| Références multiples, élément unique | {{response.data.event.contactList[0].name}} |
| Références multiples, en boucle | {% for contact in response.data.event.contactList %} {{contact.name}} {% endfor %} |
Les champs média exposent également title, description, contentType, fileName, size, width et height en plus de url.
Étape 3 : Prévisualiser et envoyer
- Utilisez l’onglet Preview & Test de Braze pour confirmer que l’appel de contenu connecté se résout correctement et que les étiquettes Liquid affichent les valeurs attendues.
- Envoyez un message de test à vous-même ou à un utilisateur test.
- Lancez la Campaign ou le Canvas une fois que le contenu s’affiche correctement.
Considérations
- Les entrées doivent être publiées. Braze récupère le contenu via l’API Content Delivery, qui ne renvoie que les entrées publiées. Les brouillons ou les entrées modifiées mais non publiées ne s’affichent pas.
- Le contenu connecté ajoute une requête au moment de l’envoi. Le contenu est récupéré lors de la distribution de chaque message. Suivez les recommandations de la section Contenu connecté concernant la mise en cache, les délais d’expiration et l’abandon des messages en cas d’échec de la requête, et assurez-vous que les limites de débit de l’API de votre forfait Contentful peuvent absorber votre volume d’envoi. Pour les limites de débit de Contentful, consultez les limites techniques de Contentful.
- Les Content Blocks sont spécifiques à un espace de travail. Les Content Blocks synchronisés depuis Contentful sont créés dans l’espace de travail Braze associé à la clé API REST que vous avez configurée. Pour utiliser le même contenu dans un autre espace de travail, configurez également l’application pour cet espace de travail.
- Les paramètres régionaux créent des sorties distinctes. La sélection de plusieurs paramètres régionaux génère des étiquettes Liquid distinctes (contenu connecté) ou des Content Blocks distincts (synchronisation), un par paramètre régional.
Résolution des problèmes
| Problème | Résolution |
|---|---|
| « A valid Contentful API key is required » lors de l’installation | Confirmez que la clé est une clé Content Delivery API (CDA) avec un accès en lecture, et qu’elle appartient à l’espace dans lequel vous effectuez l’installation. |
| Les étiquettes Liquid s’affichent vides dans un aperçu Braze | Vérifiez que l’entrée est publiée, que le champ contient du contenu et que la locale dans l’étiquette correspond à une locale configurée sur l’entrée. |
| L’appel de contenu connecté renvoie une erreur dans Braze | Vérifiez le Space ID, l’environnement et le jeton d’accès dans l’appel généré, puis testez directement l’endpoint. Braze enregistre les erreurs de contenu connecté dans le journal d’activité des messages. |
| Le bloc de contenu n’apparaît pas dans Braze | Confirmez que la clé API REST de Braze dispose des autorisations requises pour les Content Blocks et que l’endpoint REST correspond à votre instance Braze. |
| Les champs d’une liste de références renvoient des valeurs vides | Vérifiez si la liste contient plusieurs types de contenu ; parcourez la liste en boucle plutôt que d’accéder par index. |
Ressources supplémentaires
New Stuff!