Skip to content

Contentful

Contentful est un système de gestion de contenu headless qui vous permet de créer, gérer et distribuer du contenu sur n’importe quelle plateforme. Contrairement à un système de gestion de contenu (CMS) classique, Contentful vous permet de créer votre propre modèle de contenu afin de décider précisément quel contenu vous souhaitez gérer.

Cette page fournit un guide étape par étape pour configurer le contenu connecté de Braze afin de récupérer des données à partir de l’API de distribution de contenu de Contentful.

Une fois l’intégration effectuée, vous pouvez utiliser les API RESTful de Contentful pour diffuser votre contenu sur plusieurs canaux, tels que les sites web, les applications mobiles (iOS, Android et Windows) ou de nombreuses autres plateformes. Vous pouvez également extraire dynamiquement du contenu de Contentful pour l’utiliser dans vos campagnes Braze.

Conditions préalables

Avant de commencer, vous aurez besoin des éléments suivants :

Intégration

Étape 1 : Obtenir vos identifiants API Contentful

  1. Connectez-vous à Contentful avec vos identifiants.
  2. Créez ou récupérez les jetons d’accès à l’API dans le tableau de bord de Contentful en allant dans Paramètres > Clés API. Si vous n’avez pas encore de clé API, créez-en une nouvelle :
    2.1 Sélectionnez Add API key.
    2.2 Saisissez les informations requises et sélectionnez l’environnement approprié.
    2.3 Sélectionnez Save et notez le Space ID et le Content Delivery API - access token.
  3. Identifiez le modèle de contenu auquel vous souhaitez accéder via l’API Contentful.

Étape 2 : Configurer le contenu connecté de Braze

  1. Connectez-vous à Braze avec vos identifiants.
  2. Dans le tableau de bord de Braze, allez dans Modèles > Blocs de contenu > Créer un bloc de contenu > Éditeur de code HTML.
  3. Créez une requête de contenu connecté vers l’URL de l’API de distribution de contenu de Contentful. Voici un exemple d’URL de l’API de distribution de contenu de Contentful : https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries.

    L’extraction de différentes ressources nécessite l’inclusion de variables spécifiques. L’exemple de requête d’URL de contenu connecté cible l’endpoint Entry de Contentful. Cet endpoint a besoin de variables telles que {space_id} et {environment_id}, ou {entry_id} et {access_token}. Vous pouvez les récupérer depuis votre instance Contentful. Dans cet exemple de bloc de contenu, les variables doivent être remplacées par votre Space ID et votre Environment ID Contentful.

    L’exemple d’URL de l’API de distribution de contenu n’utilise qu’un seul des endpoints disponibles de Contentful. Différents cas d’utilisation peuvent être couverts en exploitant d’autres URL. Par exemple, l’API Image peut être utilisée pour récupérer des images stockées dans Contentful. Pour en savoir plus, consultez la documentation de l’API de distribution de contenu.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

        {% assign space_id = "YOUR-CONTENTFUL-SPACE-ID"}
        {% assign environment_id = "YOUR-CONTENTFUL-ENVIRONMENT-ID"}
        {% assign entry_id = "YOUR-CONTENTFUL-ENTRY-ID"}
        {% assign access_token = "YOUR-CONTENTFUL-ACCESS-TOKEN"}
         {% assign space_id = "YOUR-CONTENTFUL-SPACE-ID"}
        {% assign environment_id = "YOUR-CONTENTFUL-ENVIRONMENT-ID"}
        {% assign entry_id = "YOUR-CONTENTFUL-ENTRY-ID"}
        {% assign access_token = "YOUR-CONTENTFUL-ACCESS-TOKEN"}
         {% connected_content https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}?access_token={access_token}
         :method get
         :headers {
             "Authorization": "YOUR_CONTENTFUL_ACCESS_TOKEN"
                 }
               :content_type application/json
               :save response %}
  1. Utilisez « Test Endpoint » pour vérifier que Braze peut se connecter à l’API Contentful et récupérer les données souhaitées.
  2. Sélectionnez Done pour enregistrer votre bloc de contenu.
  3. Donnez à votre bloc de contenu un nom descriptif, tel que « Contentful API », puis sélectionnez Launch Content Block.

Étape 3 : Utiliser le contenu connecté dans les campagnes et les Canvas

  1. Dans Braze, créez une nouvelle campagne ou modifiez une campagne existante.
  2. Utilisez le bloc de contenu connecté pour insérer des données extraites de Contentful. Utilisez les chemins de données que vous avez définis lors de la configuration pour alimenter dynamiquement le contenu de la campagne.

    • Chemin de réponse : Après avoir inclus le bloc de contenu dans une campagne ou un Canvas Braze, la réponse devient disponible lorsque vous insérez la variable {response} dans votre message.

      La notation JSON par points vous permet de spécifier quelle partie du corps de la réponse de Contentful vous souhaitez inclure dans votre message. Cela variera en fonction de votre cas d’utilisation. Par exemple, vous pouvez utiliser la valeur du titre (liquid{{response.items[0].fields.title}}) de l’endpoint Entry de Contentful et recevoir une réponse comme celle-ci :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

   {
  "fields": {
    "title": {
      "en-US": "Hello!"
    },
    "body": {
      "en-US": "This is a sample message!"
    }
  },
  "metadata": {
    "tags": [
      {
        "sys": {
          "type": "Link",
          "linkType": "Tag",
          "id": "nyCampaign"
        }
      }
    ]
  },
  "sys": {
    "id": "5KsDBWseXY6QegucYAoacS",
    "type": "Entry",
    "version": 1,
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "yadj1kx9rmg0"
      }
    },
    "contentType": {
      "sys": {
        "type": "Link",
        "linkType": "ContentType",
        "id": "hfM9RCJIk0wIm06WkEOQY"
      }
    },
    "createdAt": "2016-12-20T10:43:35.772Z",
    "updatedAt": "2016-12-20T10:43:35.772Z",
    "revision": 1
  }
}
  1. Prévisualisez et testez votre campagne pour confirmer que les données du contenu connecté s’affichent correctement.
  2. Une fois la configuration validée, lancez votre campagne.

Résolution des problèmes

Réponse de l’API

Assurez-vous que vos identifiants API Contentful et l’URL de votre endpoint sont corrects. Vérifiez l’existence d’éventuels messages d’erreur dans Braze qui pourraient indiquer des problèmes avec l’appel API.

Mappage des données

Vérifiez que les mappages des chemins de réponse sont correctement configurés et que la structure de la réponse de l’API correspond à vos attentes.

Ressources complémentaires
Github   Modifier cette page sur GitHub
New Stuff!