Zum Inhalt springen

Contentful

Contentful ist ein Headless-Content-Management-System, mit dem Teams strukturierte Inhalte erstellen, verwalten und auf jedem Kanal verbreiten können. Die Braze-App für Contentful verbindet diese Inhalte direkt mit Ihrem Braze-Messaging: Sie können Contentful-Einträge zum Sendezeitpunkt dynamisch über Connected-Content in Nachrichten abrufen oder ausgewählte Felder als Braze Content Blocks synchronisieren, um sie in Campaigns und Canvases wiederzuverwenden.

Diese Integration wird von Contentful gepflegt.

Über diese Integration

Auf dieser Seite erfahren Sie, wie Sie die Braze-App in Contentful konfigurieren und wie Sie Contentful-Assets in Braze nutzen können. Mit dieser Integration können Sie:

  • Einen einsatzbereiten Braze-Connected-Content-Aufruf für einen veröffentlichten Eintrag generieren, zusammen mit den Liquid-Tags, die benötigt werden, um auf jedes Feld in einer Braze-Nachricht zu verweisen.
  • Ausgewählte Felder eines Eintrags in einen Braze-Content-Block synchronisieren – mit einem gewählten Gebietsschema –, sodass der Inhalt nativ im Braze-Dashboard verfügbar ist.

Das Ergebnis ist eine einzige Quelle der Wahrheit für Inhalte. Content-Redakteur:innen arbeiten weiterhin in Contentful mit ihren bestehenden Prüf- und Lokalisierungs-Workflows, und Marketer erstellen Campaigns in Braze auf Basis von Inhalten, die bereits genehmigt und aktuell sind.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie Folgendes:

Voraussetzung Beschreibung
Ein Contentful-Konto Ein Contentful-Konto mit Space-Admin-Zugriff auf den Space, in dem Sie die App installieren.
Ein Contentful-API-Schlüssel Ein Contentful Content Delivery API (CDA)-Schlüssel mit Lesezugriff. Erstellen Sie diesen in Contentful unter Einstellungen > API-Schlüssel.
Ein Braze-REST-API-Schlüssel Ein Braze-REST-API-Schlüssel mit den Berechtigungen content_blocks.create, content_blocks.update, content_blocks.info und content_blocks.list. Erstellen Sie diesen Schlüssel im Braze-Dashboard unter Einstellungen > API Keys. Nur für die Content-Block-Synchronisierung erforderlich.
Ein Braze-REST-Endpunkt Ihre Braze-REST-Endpunkt-URL. Ihr Endpunkt hängt von der Braze-URL für Ihre Instanz ab. Nur für die Content-Block-Synchronisierung erforderlich.

Integration

1. Schritt: Braze-App in Contentful installieren

  1. Melden Sie sich bei der Contentful-Webanwendung an.
  2. Wählen Sie Apps > Marketplace aus.
  3. Suchen Sie die Braze-App und wählen Sie sie aus.
  4. Wählen Sie Install aus. Das Fenster Manage app access wird angezeigt.
  5. Wählen Sie unter Environments die Umgebungen aus, in denen die App installiert werden soll.
  6. Wählen Sie Authorize access aus. Der App-Konfigurationsbildschirm wird angezeigt.
  7. Geben Sie unter Contentful API key Ihren Content-Delivery-API-Schlüssel ein.
  8. Um die Content-Block-Synchronisierung zu aktivieren, geben Sie Ihren Braze-REST-API-Schlüssel ein und wählen Sie Ihren Braze-REST-Endpunkt aus.
  9. Wählen Sie Install to selected environments aus.

2. Schritt: Braze-App zu einem Inhaltstyp hinzufügen

  1. Gehen Sie in der Contentful-Webanwendung zum Tab Content model.
  2. Wählen Sie einen vorhandenen Inhaltstyp aus oder erstellen Sie einen neuen.
  3. Scrollen Sie zum Abschnitt Sidebar.
  4. Fügen Sie Braze aus der Liste der verfügbaren Elemente hinzu.
  5. Wählen Sie Save aus.

Wiederholen Sie diesen Vorgang für jeden Inhaltstyp, den Sie Braze zur Verfügung stellen möchten.

3. Schritt: Einen Entry mit Braze verbinden

  1. Gehen Sie zum Tab Content und wählen Sie Add entry aus. Wählen Sie dabei einen Inhaltstyp, bei dem die Braze-App in der Seitenleiste vorhanden ist. Sie können auch einen vorhandenen Entry öffnen.
  2. Füllen Sie die Entry-Felder aus und veröffentlichen Sie den Entry. Braze kann nur veröffentlichte Inhalte abrufen.
  3. Wählen Sie in der Entry-Seitenleiste Generate Braze Connected Content aus, um einen Connected-Content-Aufruf und Liquid-Tags zu erstellen, die Sie in eine Braze-Nachricht einfügen können, oder wählen Sie Create Content Block, um ausgewählte Felder als Content-Block an Braze zu übertragen.

Content Blocks synchronisieren

Schritt 1: Einen Eintrag mit einem Braze Content Block synchronisieren

  1. Öffnen Sie einen veröffentlichten Eintrag, der die Braze-App in seiner Seitenleiste hat.
  2. Wählen Sie in der Seitenleiste Create Content Block aus.
  3. Wählen Sie das Gebietsschema aus, das verwendet werden soll. Pro ausgewähltem Gebietsschema wird ein Content Block erstellt.
  4. Wählen Sie die Felder aus, die in den Content Block aufgenommen werden sollen.
  5. Wählen Sie Send to Braze aus. Der Content Block wird in Ihrem Braze-Workspace erstellt und ist unter Content > Content Block verfügbar.

Schritt 2: Synchronisierte Inhalte aktuell halten

Wählen Sie die Methode, die zur Änderungshäufigkeit Ihrer Inhalte passt:

  • Die Content-Block-Synchronisierung eignet sich für Inhalte, die zum Sendezeitpunkt stabil sind und in vielen Nachrichten wiederverwendet werden. Sie werden ohne einen externen Aufruf gerendert.
  • Connected-Content eignet sich für Inhalte, die sich zwischen dem Zeitpunkt der Campaign-Erstellung und der Zustellung ändern können, da die Inhalte bei der Zustellung abgerufen werden.

Weitere Informationen zur Funktionsweise der Braze-App in Contentful finden Sie in der Braze-App-Dokumentation von Contentful.

Connected Content verwenden

Schritt 1: Den Connected-Content-Aufruf zu einer Braze-Nachricht hinzufügen

  1. Öffnen Sie in Contentful einen veröffentlichten Eintrag und wählen Sie in der Seitenleiste Generate Braze Connected Content aus.
  2. Wählen Sie die einzuschließenden Felder aus und wählen Sie dann Next.
  3. Wenn der Eintrag mehrere Sprachen enthält, wählen Sie die einzuschließenden Sprachen aus und wählen Sie dann Next.
  4. Kopieren Sie den generierten Connected-Content-Aufruf.
  5. Erstellen oder öffnen Sie in Braze eine Campaign oder eine Canvas-Nachricht.
  6. Fügen Sie den Connected-Content-Aufruf am Anfang des Nachrichtentexts ein.
  7. Fügen Sie die Liquid-Tags dort ein, wo der Inhalt erscheinen soll.

Schritt 2: Felder mit Liquid referenzieren

Die JSON-Punktnotation ermöglicht es Ihnen, festzulegen, welcher Teil des Antworttexts von Contentful in Ihre Nachricht aufgenommen werden soll. Dies variiert je nach Anwendungsfall. Die App generiert den korrekten Liquid-Tag für jedes Feld. Tags werden nach Sprache namensräumlich getrennt, wenn der Eintrag lokalisiert ist, und nach Inhaltstyp, wenn er es nicht ist.

Szenario Beispiel-Liquid-Tag
Lokalisierter Eintrag (en-US) {{response.data.enUS.body}}
Lokalisierter Eintrag (es-AR) {{response.data.esAR.body}}
Nicht lokalisierter Eintrag {{response.data.blogPost.body}}
Kurztextliste, verbunden {{response.data.recipe.ingredients | join: ', '}}
Kurztextliste, einzelnes Element {{response.data.recipe.ingredients[0]}}
Standortfeld {{response.data.venue.address.lat}} und {{response.data.venue.address.lon}}
Einzelne Mediendatei {{response.data.blogPost.image.url}}
Asset-Sammlung, einzelnes Element {{response.data.blogPost.imagesCollection.items[0].url}}
Mehrere Referenzen, einzelnes Element {{response.data.event.contactList[0].name}}
Mehrere Referenzen, Schleife {% for contact in response.data.event.contactList %} {{contact.name}} {% endfor %}

Medienfelder stellen zusätzlich zu url auch title, description, contentType, fileName, size, width und height bereit.

Schritt 3: Vorschau anzeigen und senden

  1. Verwenden Sie den Tab Preview & Test in Braze, um zu bestätigen, dass der Connected-Content-Aufruf aufgelöst wird und die Liquid-Tags die erwarteten Werte rendern.
  2. Senden Sie eine Testnachricht an sich selbst oder eine Testnutzer:in.
  3. Starten Sie die Campaign oder den Canvas, nachdem der Inhalt korrekt gerendert wird.

Überlegungen

  • Einträge müssen veröffentlicht sein. Braze ruft Inhalte über die Content Delivery API ab, die nur veröffentlichte Einträge zurückgibt. Entwürfe oder geänderte, aber nicht veröffentlichte Einträge werden nicht gerendert.
  • Connected-Content fügt zum Sendezeitpunkt eine Anfrage hinzu. Inhalte werden abgerufen, wenn jede Nachricht zugestellt wird. Befolgen Sie die Hinweise unter Connected-Content zu Caching, Timeouts und dem Abbrechen von Nachrichten, falls die Anfrage fehlschlägt, und stellen Sie sicher, dass die API-Rate-Limits Ihres Contentful-Plans Ihr Sendevolumen bewältigen können. Informationen zu den Rate-Limits von Contentful finden Sie unter Technische Limits von Contentful.
  • Content Blocks sind Workspace-spezifisch. Content Blocks, die von Contentful synchronisiert werden, werden in dem Braze-Workspace erstellt, der mit dem von Ihnen konfigurierten REST-API-Schlüssel verknüpft ist. Um denselben Inhalt in einem anderen Workspace zu verwenden, konfigurieren Sie die App auch für diesen Workspace.
  • Locales erzeugen separate Ausgaben. Die Auswahl mehrerer Locales generiert separate Liquid-Tags (Connected-Content) oder separate Content Blocks (Synchronisierung), jeweils eines pro Locale.

Fehlerbehebung

Problem Lösung
„A valid Contentful API key is required“ während der Installation Bestätigen Sie, dass der Schlüssel ein Content Delivery API (CDA)-Schlüssel mit Lesezugriff ist und dass er zu dem Space gehört, in den Sie installieren.
Liquid-Tags werden in einer Braze-Vorschau leer dargestellt Überprüfen Sie, ob der Entry veröffentlicht ist, ob das Feld Inhalte enthält und ob die Sprache im Tag mit einer für den Entry konfigurierten Sprache übereinstimmt.
Connected-Content-Aufruf gibt einen Fehler in Braze zurück Überprüfen Sie die Space-ID, die Umgebung und das Zugriffstoken im generierten Aufruf und testen Sie den Endpunkt direkt. Braze protokolliert Connected-Content-Fehler im Nachrichtenaktivitätsprotokoll.
Content-Block wird in Braze nicht angezeigt Bestätigen Sie, dass der Braze-REST-API-Schlüssel die erforderlichen Content-Block-Berechtigungen hat und dass der REST-Endpunkt mit Ihrer Braze-Instanz übereinstimmt.
Felder in einer Referenzliste geben leere Werte zurück Überprüfen Sie, ob die Liste mehrere Content-Typen enthält; iterieren Sie über die Liste, anstatt per Index darauf zuzugreifen.

Zusätzliche Ressourcen

Dokumentation für die Braze-Kundenengagement-Plattform.

Ressourcen
Rechtliches
Unternehmen
© 2026 Braze, Inc. Alle Rechte vorbehalten.
Braze-Status wird geprüft
New Stuff!