Skip to content

Katalog erstellen

Um einen Katalog zu erstellen, importieren Sie eine CSV-Datei mit Nicht-Nutzerdaten in Braze. Anschließend können Sie auf diese Informationen zugreifen, um Ihre Nachrichten anzureichern. Sie können jede Art von Daten in einen Katalog einbringen. Bei diesen Daten handelt es sich in der Regel um Metadaten Ihres Unternehmens, z. B. Produktinformationen für ein E-Commerce-Unternehmen oder Kursinformationen für einen Bildungsanbieter.

Anwendungsfälle

Häufige Anwendungsfälle für Kataloge sind unter anderem:

  • Produkte
  • Serviceleistungen
  • Lebensmittel
  • Bevorstehende Events
  • Musik
  • Pakete

Nachdem diese Informationen importiert wurden, können Sie in Ihren Nachrichten auf sie zugreifen – ähnlich wie Sie über Liquid auf angepasste Attribute oder Event-Eigenschaften zugreifen.

Unterstützte Datentypen

Die folgende Tabelle listet die unterstützten Katalogdatentypen auf und zeigt, wie sie erstellt oder aktualisiert werden können.

Einen Katalog erstellen

Um einen Katalog zu erstellen, gehen Sie zu Dateneinstellungen > Kataloge und wählen Sie dann Neuen Katalog erstellen. Wählen Sie anschließend eine der folgenden Optionen:

Schritt 1: Überprüfen Sie Ihre CSV-Datei

Bevor Sie Ihre CSV-Datei hochladen, stellen Sie sicher, dass Ihre CSV-Datei die folgenden Anforderungen erfüllt:

Schritt 2: CSV hochladen

Ziehen Sie Ihre Datei per Drag-and-Drop in den Upload-Bereich oder wählen Sie CSV hochladen und wählen Sie Ihre Datei aus.

Ziehen Sie Ihre Datei per Drag-and-Drop in den Upload-Bereich oder wählen Sie „CSV hochladen“ und wählen Sie Ihre Datei aus.

Wählen Sie einen Datentyp für jede Spalte aus.

Dieser Datentyp kann nach der Einrichtung Ihres Katalogs nicht mehr bearbeitet werden. Außerdem wird ein NULL-Wert beim CSV-Upload nicht unterstützt und als String behandelt.

Geben Sie einen Namen und eine optionale Beschreibung für Ihren Katalog ein. Beachten Sie beim Benennen Ihres Katalogs die folgenden Anforderungen:

  • Muss eindeutig sein
  • Maximal 250 Zeichen
  • Darf nur Zahlen, Buchstaben, Bindestriche und Unterstriche enthalten

Ein Katalog mit dem Namen „my_catalog“.

Wählen Sie Katalog verarbeiten, um den Katalog zu erstellen.

Tutorial: Einen Katalog aus einer CSV-Datei erstellen

Für dieses Tutorial verwenden wir einen Katalog, der zwei Spiele, deren Preis und einen Bildlink auflistet.

id title price image_link
1234 Tales 7.49 https://picsum.photos/200
1235 Regeneration 22.49 https://picsum.photos/200

Wir erstellen den Katalog, indem wir eine CSV-Datei hochladen. Die Datentypen für id, title, price und image_link sind jeweils String, String, Zahl und String.

Vier Katalogspaltennamen: „id“, „title“, „price“, „image_link“.

Als Nächstes benennen wir diesen Katalog „games_catalog“ und wählen den Button Katalog verarbeiten. Braze überprüft dann den Katalog auf Fehler, bevor der Katalog erstellt wird.

Ein Katalog mit dem Namen „games_catalog“.

Beachten Sie, dass Sie diesen Namen nach der Erstellung des Katalogs nicht mehr bearbeiten können. Sie können einen Katalog löschen und eine aktualisierte Version mit demselben Katalognamen erneut hochladen.

Nach der Erstellung des Katalogs können Sie beginnen, den Katalog in einer Campaign zu referenzieren.

Voraussetzungen

Bevor Sie Kataloge im Browser bearbeiten oder erstellen können, benötigen Sie die folgenden Nutzer:innenberechtigungen für Ihren Workspace:

  • Kataloge anzeigen
  • Kataloge bearbeiten
  • Kataloge exportieren
  • Kataloge löschen

Schritt 1: Katalogdetails eingeben

Geben Sie einen Namen und eine optionale Beschreibung für Ihren Katalog ein. Beachten Sie beim Benennen Ihres Katalogs die folgenden Anforderungen:

  • Muss eindeutig sein
  • Maximal 250 Zeichen
  • Darf nur Zahlen, Buchstaben, Bindestriche und Unterstriche enthalten

Ein Katalog mit dem Namen „my_catalog“.

Schritt 2: Ihren Katalog erstellen

Wählen Sie Ihren Katalog aus der Liste aus und wählen Sie dann Katalog aktualisieren > Felder hinzufügen. Geben Sie den Feldnamen ein und verwenden Sie das Dropdown-Menü, um den Datentyp auszuwählen. Wiederholen Sie dies bei Bedarf.

Zwei Beispielfelder „rating“ und „name“.

Wählen Sie Katalog aktualisieren > Artikel hinzufügen, um einen Artikel zu Ihrem Katalog hinzuzufügen, indem Sie die Informationen basierend auf den zuvor hinzugefügten Feldern eingeben. Wählen Sie dann Artikel speichern oder Speichern und weiteren hinzufügen, um weitere Artikel hinzuzufügen.

Einen Katalogartikel hinzufügen.

Katalog-Datentypen

Kataloge unterstützen verschiedene Datentypen, die Ihnen helfen, Ihre Daten effektiv zu organisieren und zu strukturieren. Die folgende Tabelle beschreibt jeden unterstützten Datentyp und wie er CSV- und API-Typnamen zugeordnet wird:

Verwendung von Templates in Katalognamen

Bei der Benennung Ihres Katalogs können Sie auch Templates in einem Katalognamen verwenden. Auf diese Weise können Sie Katalognamen dynamisch auf der Grundlage von Variablen wie Sprache oder Campaign generieren. Sie können zum Beispiel Folgendes verwenden:

1
2
3
4

{% assign language = "content_spanish" %}

{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}

Kataloge verwalten

Im Dashboard

Um Ihren Katalog nach dem Hochladen einer CSV-Datei oder dem Erstellen eines Katalogs im Browser zu aktualisieren, wählen Sie Katalog aktualisieren > CSV hochladen und dann, ob Sie Artikel in Ihrem Katalog aktualisieren, hinzufügen oder löschen möchten.

Mit der REST API

Wenn Sie mehr Kataloge erstellen, können Sie auch den Endpunkt „Kataloge auflisten“ verwenden, um eine Liste der Kataloge in einem Workspace zurückzugeben.

Die REST API unterstützt alle Katalog-Datentypen, einschließlich JSON-Objekte und String-Arrays. JSON-Objekte und String-Arrays können nur über die REST API erstellt oder aktualisiert werden.

Mit Cloud Data Ingestion

Sie können Kataloge über Cloud Data Ingestion pflegen, indem Sie Katalogdaten direkt aus Ihrem Data Warehouse (z. B. Snowflake, Redshift, BigQuery, Databricks, Microsoft Fabric oder S3) planmäßig synchronisieren.

Katalogartikel verwalten

Zusätzlich zur Verwaltung Ihrer Kataloge können Sie auch asynchrone und synchrone Endpunkte verwenden, um die Katalogartikel zu verwalten. Dazu gehört die Möglichkeit, Katalogartikel zu bearbeiten und zu löschen sowie Details zu Katalogartikeln aufzulisten.

Wenn Sie beispielsweise einen einzelnen Katalogartikel bearbeiten möchten, können Sie den /catalogs/catalog_name/items/item_id-Endpunkt verwenden.

Katalogspeicher

Die kostenlose Version von Catalogs unterstützt CSV-Dateien mit einer Gesamtgröße von bis zu 500 MB für alle CSV-Dateien in Ihrem Unternehmen, während die Catalogs-Pro-Version CSV-Dateien mit einer Größe von bis zu 2 GB für eine einzelne CSV-Datei unterstützt.

Kostenlose Version

Die Speichergröße der kostenlosen Version von Catalogs beträgt bis zu 500 MB. Sie können eine unbegrenzte Anzahl von Artikeln haben, solange sie unter 500 MB bleiben.

Catalogs Pro

Auf Unternehmensebene richtet sich der maximale Speicherplatz für Catalogs Pro nach der Größe der Katalogdaten. Die verfügbaren Speichergrößen sind: 5 GB, 10 GB oder 15 GB. Beachten Sie, dass der Speicherplatz der kostenlosen Version (500 MB) in jedem dieser Tarife enthalten ist.

Spezifikationen

Die folgende Tabelle fasst die Spezifikationen zusammen, die Sie in Katalogen verwenden können.
New Stuff!