Braze

Mit der Braze-App können Marketingfachkräfte genehmigten Content direkt von Contentful in Braze-Kampagnen synchronisieren. Dadurch entfällt die Notwendigkeit, Braze Connected Content manuell zu erstellen, wodurch das Fehlerrisiko reduziert und sichergestellt wird, dass Aktualisierungen des Contents automatisch an Kampagnen weitergegeben werden.

Marketingfachkräfte können Contentblöcke in Braze erstellen, die automatisch mit Contentful Feldaktualisierungen synchronisiert werden, sodass Braze-Nutzer*innen die Contentblöcke in ihre Kampagnen aufnehmen können. Dies optimiert den Content und beschleunigt den Prozess, Kampagnen live zu schalten und an ihre Zielgruppen zu verteilen.

Die App bietet die folgenden Funktionen:

• Eine Seitenleisten-App, um den Connected Content-Aufruf zu generieren, der dann kopiert und in Braze eingefügt werden kann.

• Liquid-Tags, um auf Daten zu verweisen, die durch den Aufruf importiert wurden.

• JSON-Daten für den Aufruf.

• Sie benötigen Space-Admin-Zugriff auf den Contentful Space, in dem Sie die App installieren.

• Der Contentful API-Schlüssel für den Zugriff auf die Content Delivery API.
  
  HINWEIS: Bei Bedarf können Sie auch einen neuen API-Schlüssel über das Menü API-Schlüssel in den Einstellungen erstellen. Sie müssen das Content Delivery API-Zugriffstoken angeben.

• Ein konfiguriertes Braze-Konto.

Schritt 1: Braze-App in der Contentful Web-App installieren

So installieren Sie die Braze-App in der Contentful Web-App:

1. Melden Sie sich bei der Contentful Web-App an.

2. Klicken Sie auf Apps und wählen Sie Marketplace.

3. Navigieren Sie zur Braze-App und wählen Sie sie aus. Das Fenster „App-Details“ wird angezeigt.
   

   

4. Klicken Sie auf Installieren. Das Fenster „App-Zugriff verwalten“ wird angezeigt.
   

   

5. Wählen Sie unter Umgebungen die Umgebungen aus, in denen Sie die App installieren möchten.

6. Klicken Sie auf Zugriff autorisieren. Das Fenster „Konfiguration“ wird angezeigt.

7. Geben Sie unter „Konfiguration“ den Wert in das folgende Feld ein:
   - Contentful API-Schlüssel – Geben Sie den Contentful API-Schlüssel ein, den Braze verwendet, um Ihren Content zum Sendezeitpunkt über die API anzufordern.
   

   

8. Klicken Sie auf In ausgewählten Umgebungen installieren. Die Braze-App ist jetzt in den ausgewählten Umgebungen und Feldern installiert.

HINWEIS: Wenn die folgende Fehlermeldung angezeigt wird, überprüfen Sie, ob Ihr API-Schlüssel Lesezugriff auf die CDA hat: Ein gültiger Contentful API-Schlüssel ist erforderlich.

Schritt 2: Braze zu einem Contenttyp hinzufügen

Sobald Sie die App installiert haben, können Sie Braze zu jedem Contenttyp hinzufügen, solange Sie noch ein Feld zur Verfügung haben: 

1. Öffnen Sie die Contentful Web-App.

2. Navigieren Sie zur Registerkarte „Content-Modell“. 

3. Wählen Sie einen vorhandenen Contenttyp aus oder fügen Sie einen neuen hinzu. Der Contenttyp-Editor wird angezeigt.

4. Scrollen Sie zum Abschnitt „Seitenleiste“ und fügen Sie Braze aus den verfügbaren Elementen hinzu.
   

   

5. Klicken Sie auf Speichern.

Schritt 3: App verwenden

Sobald Sie die App in der Seitenleiste des Contenttyps erfolgreich konfiguriert haben, erstellen Sie einen neuen Eintrag mit dem Contenttyp, den Sie in Schritt 2 konfiguriert haben.

So erstellen Sie einen neuen Eintrag mit dem konfigurierten Contenttyp: 

1. Navigieren Sie zur Registerkarte „Content“. 

2. Klicken Sie auf Eintrag hinzufügen und wählen Sie den Contenttyp aus. Der Eintragseditor wird angezeigt.

3. Füllen Sie die Felder aus und veröffentlichen Sie Ihren Content.

4. Klicken Sie in der Seitenleiste auf Braze Connected Content generieren, um Ihren Content mit Braze zu verbinden. 

5. Wählen Sie die Felder aus, die Sie in Ihren Connected Content-Aufruf aufnehmen möchten. 

6. Klicken Sie auf Weiter.

7. Optional: Wenn Sie mehr als eine Sprache haben, müssen Sie die Sprachen auswählen, auf die Sie in Braze-Nachrichten verweisen möchten, und auf Weiter klicken.

8. Schließlich können Sie Folgendes sehen und kopieren:

   1. Den Braze Connected Content-Aufruf mit den ausgewählten Feldern.

   2. Die Liquid-Tags, um auf diese Felder zu verweisen.

   3. Die JSON-Daten, die in Braze über Connected Content verfügbar sind.
      

Hinweise:

• Wenn der Eintrag leere Felder enthält, generiert die App keine Liquid-Tags für diese Felder.

• Um Content-Informationen anzuzeigen, wenn Sie das Liquid-Tag in Braze verwenden, muss Ihr Eintrag veröffentlicht werden.

Lokalisierung

Eintragsfelder können lokalisiert werden, was bedeutet, dass Sie verschiedene Sprachen haben können. Infolgedessen kann das generierte Liquid-Tag je nach den von Ihnen gewählten Sprachen variieren. 

Angenommen, Sie haben einen Eintrag eines blogPost-Contenttyps mit einem Kurztextfeld mit der Text-ID und zwei verfügbaren Sprachen (en-US und es-AR). Wenn Sie beide in der Braze-App auswählen, werden die folgenden Liquid-Tags generiert:

{{response.data.enUS.body}}

{{response.data.esAR.body}}

Wenn der Eintrag nicht lokalisiert ist (für kein Feld wurde eine Sprache ausgewählt), verwendet die App den Contenttyp zum Erstellen der Liquid-Tags. Zum Beispiel:
{{response.data.blogPost.body}}

Weitere Informationen zur Lokalisierung finden Sie auf der Seite Lokalisierung.

Spezielle Feldtypen

Es gibt verschiedene Möglichkeiten, Listen und einige Contentful Typen mit liquidTags zu verarbeiten. Bei der Generierung wählt die App standardmäßig eine aus, aber es ist wichtig zu beachten, dass dies möglicherweise nicht für alle Nutzer*innen am bequemsten ist. In diesem Abschnitt finden Sie Beispiele für andere Möglichkeiten, mit diesen Fällen umzugehen.

HINWEIS:  Der gesamte unten gezeigte Liquid-Code dient nur zu Beispielzwecken. Sie müssen ihn an Ihren eigenen Kontext anpassen. Darüber hinaus gehen wir davon aus, dass Einträge nicht lokalisiert sind. Informationen zu lokalisierten Einträgen finden Sie im Abschnitt Liquid-Tags und Lokalisierung. 

Weitere Informationen zur Verwendung von Liquid-Tags in Braze finden Sie in der offiziellen Braze-Dokumentation.

Kurzer Text – Liste

Angenommen, Sie haben einen Contenttyp namens Rezept, der ein Kurztextfeld enthält, das als Liste mit der ID Zutaten konfiguriert ist.

1. Standardmäßig werden für diesen Feldtyp die folgenden Liquid-Tags generiert:
   

   Braze liquid tag for special field type

   Copy to clipboard

   
   Bei der Verwendung in Braze zeigt dieses Liquid-Tag jeden Elementwert der Textliste an.

2. Sie können das Liquid-Tag auch in seiner Rohform verwenden:
   

   {{response.data.recipe.ingredients}}

   Diese Option zeigt alle Elemente in der Liste ohne Kommas in Braze an.

3. Schließlich können wir die Liste auch verwenden, um über ihren Index auf ein bestimmtes Element zuzugreifen:
   {{response.data.recipe.ingredients[0]}}
   

   Diese Option zeigt nur das Element an, das durch den Index in Braze angegeben wird.

Standort

Angenommen, Sie haben einen Contenttyp namens Veranstaltungsort, der ein Standortfeld mit der ID Adresse enthält.

Standardmäßig werden für diesen Feldtyp die folgenden Liquid-Tags generiert:

Diese Option zeigt die spezifischen Werte für Breiten- oder Längengrade an.

Sie können das Liquid-Tag auch in seiner Rohform verwenden:
{{response.data.venue.adress}}

Dieses zeigt ein Ruby-Hash-Strukturpaar an, das alle Felder des Standortfelds enthält. Beispielausgabe:

{"lat"=>50, "lon"=>9}

Medien – Eine Datei

Angenommen, Sie haben einen Contenttyp namens blogPost, der ein Medienfeld mit der ID Bild enthält. Standardmäßig werden für diesen Feldtyp die Liquid-Tags title, description und url generiert, und zwar wie folgt:

Sie können aber auch auf andere Felder für Assets zugreifen, wenn Sie diese benötigen. Die Felder, auf die für Assets zugegriffen werden kann, sind:

• title

• description

• url

• contentType

• fileName

• size

• width

• height

Beispiel für alle Felder:

Sie können das Liquid-Tag auch in seiner Rohform verwenden:

{{response.data.blogPost.image}}

Dieses zeigt einen Ruby-Hash an, der alle Felder des Asset-Felds enthält.

Medien – Viele Dateien

Angenommen, Sie haben einen Contenttyp namens blogPost, der ein Medienfeld enthält, das so konfiguriert ist, dass es mehrere Dateien zulässt. Dies wird auch als Liste der Assets bezeichnet. Die Feld-ID ist images.

1. Standardmäßig werden für diesen Feldtyp die folgenden Liquid-Tags generiert:
   

   Liquid tag for images

   Copy to clipboard

   
   Bei der Verwendung in Braze zeigt dieses Liquid-Tag für jedes Element die Werte für Titel, URL und Größe an.
   HINWEIS: Wenn der Wert leer ist, wird in Braze nichts angezeigt.

2. Sie können das Liquid-Tag auch in seiner Rohform verwenden:{{response.data.blogPost.imagesCollection.items}}.
   Diese Option zeigt eine Ruby-Hash-Struktur an, die alle Werte dieses Asset-Listenfelds enthält. Beispiel:
   

   Ruby hash - liquid tag

   Copy to clipboard

3. Schließlich können wir die Liste auch verwenden, um über ihren Index auf ein bestimmtes Element und Feld zuzugreifen:
   

   Liquid tag for Braze: list to access all files

   Copy to clipboard

   
   Diese Option zeigt nur das Element an, das durch den Index in Braze angegeben wird.

Die Braze-App generiert Liquid-Tags für Titel, Beschreibung und URL, aber Sie können auch auf Folgendes zugreifen:

• contentType

• fileName

• size

• Breite

• height
  

Referenzen – Viele

Angenommen, Sie haben einen Contenttyp namens Ereignis, der ein Referenzfeld enthält, das so konfiguriert ist, dass es mehrere Referenzen zulässt. Die Feld-ID ist contactList. 

1. Standardmäßig werden für diesen Feldtyp die folgenden Liquid-Tags generiert:
   Diese Option zeigt den Wert der angegebenen Element-Eigenschaft basierend auf dem Index an.

   
   HINWEIS: Jedes Element aus der Referenzliste kann unterschiedliche Contenttypen haben. Dies bedeutet, dass sie unterschiedliche Felder pro Element haben können.
   

   Liquid tag for References - Many

   Copy to clipboard

2. Eine weitere Möglichkeit besteht darin, das Liquid-Tag direkt zu verarbeiten, zum Beispiel:{{response.data.event.contactListCollection}}.
   Wenn Sie das Liquid-Tag auf diese Weise verwenden, zeigt Braze eine Ruby-Hash-Struktur an, die alle Elemente der Liste enthält. Dies kann nützlich sein, wenn Sie alle Elemente und Werte sehen möchten, die in der Referenzliste verfügbar sind.
   Beispiel:
   {"items"=>[{"name"=>"laura", "phone"=>"123567456"}, {"name"=>"charlie", "age"=>"23"}]}

3. Sie können auch Liquid-Tags für jedes Element der Referenzliste generieren und in ihrer Rohform zurückgeben:
   

   Liquid tags for each event

   Copy to clipboard

   Diese Option zeigt eine Ruby-Hash-Struktur für jede Referenz an, die alle Felder dieses bestimmten Elements enthält.
   Beispiel:
   {"name"=>"laura", "phone"=>"123567456"} {"name"=>"charlie", "age"=>"23"}

4. Wenn Sie sicher sind, dass alle Elemente aus der Referenzliste den gleichen Contenttyp haben, können Sie die for verwenden, um auch die Felder innerhalb der Referenz zu verarbeiten:
   

   Liquid tag: all elements of the content type

   Copy to clipboard

   Diese Option zeigt den Namen und den Telefonwert jedes Elements der Referenzliste an.
   

HINWEIS: Wenn ein Element aus der Referenzliste nicht den gleichen Contenttyp hat, kann dies zu Fehlern oder leeren Werten in Braze führen.