Skip to content

Contentful

Contentful ist ein Headless-Content-Management-System, mit dem Sie Inhalte erstellen, verwalten und auf jeder Plattform verbreiten können. Im Gegensatz zu einem Content-Management-System (CMS) ermöglicht Contentful Ihnen, Ihr eigenes Inhaltsmodell zu erstellen, sodass Sie entscheiden können, welche Inhalte Sie verwalten möchten.

Auf dieser Seite finden Sie eine schrittweise Anleitung zur Konfiguration von Braze Connected-Content, um Daten von der Contentful Content Delivery API abzurufen.

Nach der Integration können Sie die RESTful APIs von Contentful nutzen, um Ihre Inhalte über verschiedene Kanäle wie Websites, mobile Apps (iOS, Android und Windows) oder viele andere Plattformen zuzustellen. Sie können auch dynamisch Inhalte von Contentful abrufen, um sie in Ihren Braze-Kampagnen zu verwenden.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie Folgendes:

Voraussetzung Beschreibung
Ein Contentful-Konto Sie benötigen ein Contentful-Konto mit Zugriff auf die Content Delivery API.
Ein Braze-Konto Sie benötigen ein Braze-Konto mit Zugriff auf das Connected-Content-Feature.

Integration

1. Schritt: Contentful-API-Zugangsdaten abrufen

  1. Melden Sie sich bei Contentful an, indem Sie Ihre Zugangsdaten eingeben.
  2. Erstellen oder rufen Sie API-Zugangs-Token im Contentful-Dashboard unter Settings > API keys ab. Wenn Sie noch keinen API-Schlüssel haben, erstellen Sie einen neuen:
    2.1 Wählen Sie Add API key aus.
    2.2 Geben Sie die erforderlichen Details ein und wählen Sie die entsprechende Umgebung aus.
    2.3 Wählen Sie Save und notieren Sie sich die Space ID und das Content Delivery API - access token.
  3. Identifizieren Sie das Inhaltsmodell, auf das Sie über die Contentful-API zugreifen möchten.

2. Schritt: Braze Connected-Content konfigurieren

  1. Melden Sie sich bei Braze an, indem Sie Ihre Zugangsdaten eingeben.
  2. Gehen Sie im Braze-Dashboard zu Content > Content Block > Create Content Block > HTML code editor.
  3. Erstellen Sie eine Connected-Content-Anfrage an die Contentful Content Delivery API URL. Ein Beispiel für die Contentful Content Delivery API URL ist https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries.

    Das Abrufen verschiedener Assets erfordert die Einbeziehung bestimmter Variablen. Die beispielhafte Connected-Content-URL-Anfrage zielt auf den Entry-Endpunkt von Contentful ab. Dieser Endpunkt benötigt Variablen wie {space_id} und {environment_id} oder {entry_id} und {access_token}. Diese können von Ihrer Contentful-Instanz übernommen werden. In diesem Beispiel-Content-Block müssen die Variablen durch Ihre Contentful Space ID und Environment ID ersetzt werden.

    Die Beispiel-URL der Content Delivery API verwendet nur einen der verfügbaren Endpunkte von Contentful. Verschiedene Anwendungsfälle können durch die Nutzung verschiedener URLs abgedeckt werden. Die Image API kann zum Beispiel dazu verwendet werden, in Contentful gespeicherte Bilder abzurufen. Weitere Informationen finden Sie unter Content Delivery API.
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. Verwenden Sie „Endpunkt testen“, um zu prüfen, ob Braze sich erfolgreich mit der Contentful-API verbinden und die gewünschten Daten abrufen kann.
  2. Wählen Sie Done, um Ihren Content-Block zu speichern.
  3. Geben Sie Ihrem Content-Block einen beschreibenden Namen, z. B. „Contentful API“, und wählen Sie dann Launch Content Block.

3. Schritt: Connected-Content in Kampagnen und Canvases verwenden

  1. Erstellen Sie in Braze eine neue Kampagne oder bearbeiten Sie eine bestehende.
  2. Verwenden Sie den Connected-Content-Block, um von Contentful abgerufene Daten einzufügen. Nutzen Sie die Datenpfade, die Sie bei der Konfiguration festgelegt haben, um den Inhalt der Kampagne dynamisch zu füllen.

    • Antwortpfad: Nachdem Sie den Content-Block in eine Braze-Kampagne oder ein Canvas eingebunden haben, wird die Antwort verfügbar, wenn Sie die Variable {response} in Ihre Nachricht einfügen.

      Mit der JSON-Punktnotation können Sie angeben, welchen Teil des Antwortkörpers von Contentful Sie in Ihre Nachricht aufnehmen möchten. Dies hängt von Ihrem Anwendungsfall ab. Sie können zum Beispiel den Titelwert (liquid{{response.items[0].fields.title}}) vom Entry-Endpunkt von Contentful verwenden und eine Antwort wie diese erhalten:
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. Erstellen Sie eine Vorschau und testen Sie Ihre Kampagne, um sicherzustellen, dass die Connected-Content-Daten korrekt angezeigt werden.
  2. Wenn Sie mit der Einrichtung zufrieden sind, starten Sie Ihre Kampagne.

Fehlerbehebung

API-Antwort

Vergewissern Sie sich, dass Ihre Contentful-API-Zugangsdaten und die Endpunkt-URL korrekt sind. Suchen Sie in Braze nach Fehlermeldungen, die auf Probleme mit dem API-Aufruf hinweisen könnten.

Datenabbildung

Überprüfen Sie, ob die Abbildungen der Antwortpfade korrekt konfiguriert sind und ob die API-Antwortstruktur Ihren Erwartungen entspricht.

Zusätzliche Ressourcen
New Stuff!