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
  • Dienste
  • Lebensmittel
  • Anstehende Ereignisse
  • Musik
  • Pakete

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

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, navigieren Sie zu Dateneinstellungen > Kataloge, wählen Sie Neuen Katalog erstellen und wählen Sie eine der folgenden Optionen:

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

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

2. Schritt: CSV hochladen

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

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

Geben Sie einen Namen und optional eine Beschreibung für Ihren Katalog ein. Beachten Sie bei der Benennung 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.

Anleitung: Erstellen eines Katalogs aus einer CSV-Datei

In dieser Anleitung verwenden wir einen Katalog, der zwei Spiele mit Preisangaben und einem Bildlink enthält.

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 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. Anschließend prüft Braze den Katalog vor der Erstellung auf eventuelle Fehler.

Ein Katalog mit dem Namen „games_catalog“.

Beachten Sie, dass Sie diesen Namen nicht mehr ändern können, nachdem der Katalog erstellt wurde. Sie können einen Katalog löschen und eine aktualisierte Version unter demselben Katalognamen erneut hochladen.

Nachdem Sie den Katalog erstellt haben, können Sie damit beginnen, den Katalog in einer Campaign zu referenzieren.

Voraussetzungen

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

  • View Catalogs
  • Edit Catalogs
  • Export Catalogs
  • Delete Catalogs

1. Schritt: Katalogdetails eingeben

Geben Sie einen Namen und optional eine Beschreibung für Ihren Katalog ein. Beachten Sie bei der Benennung 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“.

2. Schritt: Ihren Katalog erstellen

Wählen Sie Ihren Katalog aus der Liste aus und wählen Sie anschließend Katalog aktualisieren > Felder hinzufügen. Geben Sie den Feldnamen ein und wählen Sie den Datentyp aus dem Dropdown-Menü aus. Wiederholen Sie den Vorgang nach 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 auf der Grundlage der zuvor hinzugefügten Felder eingeben. Wählen Sie dann Artikel speichern oder Speichern und weiteren hinzufügen, um mit dem Hinzufügen Ihrer Artikel fortzufahren.

Einen Katalogartikel hinzufügen.

Katalogdatentypen

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 auf CSV- und API-Typnamen abgebildet 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 }}

Verwaltung von Katalogen

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 legen Sie anschließend fest, ob Sie Artikel in Ihrem Katalog aktualisieren, hinzufügen oder löschen möchten.

Verwendung 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 abzurufen.

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

Nutzung der Cloud-Datenaufnahme

Sie können Kataloge über die Cloud-Datenaufnahme verwalten, indem Sie Katalogdaten direkt aus Ihrem Data Warehouse (wie Snowflake, Redshift, BigQuery, Databricks, Microsoft Fabric oder S3) nach einem festgelegten Zeitplan synchronisieren.

Katalogartikel verwalten

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

Wenn Sie zum Beispiel 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 100 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 100 MB. Sie können eine unbegrenzte Anzahl von Artikeln haben, solange sie unter 100 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 (100 MB) in jedem dieser Tarife enthalten ist.

Spezifikationen

Die folgende Tabelle fasst die Spezifikationen zusammen, die für Kataloge gelten.
New Stuff!