Übersicht
In diesem Artikel erfahren Sie, wie Sie in Gelato personalisierte Produkte für Ihre Kunden erstellen und diese bei Bestellungen über die Gelato-API nutzen können. Mit personalisierten Produkten können Sie die Produktkonfigurationen individuell auf verschiedene Kunden abstimmen und deren spezifische Datenformate mit einem Standard-Produktmodell verknüpfen.
Ein Produktmodell beschreibt Ihr Produkt intern, zum Beispiel seine Bestandteile, Eigenschaften und abgeleitete Merkmale. Ein Kundenprodukt hingegen gibt Ihnen die Möglichkeit, individuell zu gestalten, wie Kundinnen und Kunden beim Bestellen Daten übermitteln und mit Ihrem Produkt interagieren.
So erstellen Sie personalisierte Produkte für Ihre Kundinnen und Kunden
1. Richten Sie das Produktmodell ein
Bevor Sie ein personalisiertes Produkt erstellen, stellen Sie sicher, dass Sie bereits ein Produktmodell eingerichtet haben. Nehmen wir zum Beispiel an, das Produktmodell heißt Poster Product und verfügt über 9 Attribute sowie mehrere abgeleitete Attribute. (Weitere Informationen finden Sie im Leitfaden „Erstellen eines Produktmodells“.)
2. Das Kundenprodukt erstellen
Ein Kundenprodukt ist eine personalisierte Version Ihres Produktmodells, die zeigt, wie Ihr Kunde seine Daten am liebsten übermittelt (z. B. Größe, Farbe usw.). So richten Sie ein Kundenprodukt ein:
Schritt 1: Gehen Sie zum Bereich Kundenprodukte.
Schritt 2: Wählen Sie das Produktmodell aus (z. B. Poster-Produkt) und geben Sie Ihrem Kundenprodukt einen Namen. Dieser Name ist besonders wichtig, da er bei der Bestellung über die API verwendet wird.
Zum Beispiel nennen wir dieses Produkt für den Kunden Sandbox Customer einfach Poster SP.
Hinweis: Der Name des Kundenprodukts kann direkt in Bestellanfragen verwendet werden, die über die API von Gelato gesendet werden.
Schritt 3: Legen Sie Basisattribute und Varianten fest:
Basisattribute sind feste Eigenschaften, die bei allen Produktvarianten gleich bleiben.
Varianten sind die personalisierbaren Optionen wie Größe, Farbe oder Papiersorte, aus denen Ihre Kundinnen und Kunden wählen können.
3. Grundattribute festlegen
Basisattribute haben bei allen Varianten einen festen, unveränderlichen Wert. Zum Beispiel:
Ausrichtung: Immer vertikal
Beschichtung: Keine Beschichtung
Diese Grundeigenschaften unterscheiden sich nicht von Variante zu Variante.
4. Varianten festlegen
Varianten sind die Produktoptionen, die Ihre Kundinnen und Kunden auswählen können, zum Beispiel Größe oder Farbe. So richten Sie sie ein:
Schritt 1: Fügen Sie die Optionen des Kunden hinzu (z. B. Größe und Farbe) und verknüpfen Sie diese mit den Attributen des Produktmodells.
Beispiel: Die Kundin oder der Kunde möchte Attribute mit den Namen Größe, Papiersorte und Farbe übermitteln.
Schritt 2: Ordnen Sie die vom Kunden bereitgestellten Werte den internen Produkteigenschaften zu:
Farbe: Kundinnen und Kunden könnten ihre Farboption als „Schwarz-Weiß“ für schwarz-weiße Drucke und „Vollfarbe“ für Farbdrucke bezeichnen. Sie können diese Optionen den internen Gelato-Werten „1/1“ für Schwarz-Weiß und „4/4“ für Vollfarbe zuordnen.
Größe: Kundinnen und Kunden geben manchmal Maße in Zoll an, während Sie diese Werte ins metrische System umrechnen müssen (zum Beispiel 20x28 Zoll = 508x711 mm).
Schritt 3: Legen Sie bei Bedarf einen Standardwert für Attribute fest. Zum Beispiel:
Wenn der Kunde keine Farbauswahl angibt, können Sie standardmäßig Vollfarbe (4/4) einstellen.
Schritt 4: Mehrere Optionswerte festlegen:
Sie können mehrere Kundenwerte einem internen Wert zuordnen. Zum Beispiel kann ein Kunde „Black White“ oder „BW“ verwenden, um denselben Schwarz-Weiß-Druck zu meinen. Sie können beide Begriffe auf Ihren internen Wert „1/1“ abbilden.
5. Das Kundenprodukt speichern
Sobald alle Attribute und Varianten eingerichtet sind, speichern Sie das personalisierte Produkt. Sie haben jetzt ein personalisiertes Produkt, das mit dem internen Produktmodell verknüpft ist. So können Sie Bestellungen im bevorzugten Format Ihrer Kundinnen und Kunden empfangen und bearbeiten.
So bestellen Sie mit eigenen Produkten über die API
Sobald das Kundenprodukt eingerichtet ist, kann der Kunde Bestellungen über die Gelato API aufgeben. So funktioniert es:
1. Die Struktur einer API-Anfrage
Wenn Sie eine Bestellung aufgeben, wird der Kundenproduktname (z. B. Poster SP) zusammen mit den gewählten Optionen in der API-Anfrage verwendet. Hier sehen Sie ein Beispiel für eine API-Anfrage:
{ "items": [ { "productName": "Poster SP", "productVariant": { "color": "schwarz-weiß", "paper-size": "20x28 Zoll" } } ]}
In diesem Beispiel:
Das productName ist auf Poster SP eingestellt.
Die Produktvariante enthält die ausgewählten Variantenoptionen, zum Beispiel "schwarz-weiß" für die Farbe und "20x28 Zoll" für das Papierformat.
2. Umgang mit mehreren Kundenprodukten
Sie können für verschiedene Kunden jeweils eigene Kundenprodukte einrichten, die alle auf dasselbe Produktmodell verweisen, aber unterschiedliche Einstellungen haben. Zum Beispiel:
Kunde A könnte zum Beispiel „Papierformat“ und „Farbe“ als Optionen angeben.
Kunde B könnte stattdessen "Papiersorte" und "Größe" angeben.
Trotz dieser Unterschiede verweisen beide Kundenprodukte auf die gleiche interne Product UID im Gelato-System. So bleibt der Produktionsprozess im Hintergrund immer gleich.
3. Rückwärtskompatibilität
Das System von Gelato ist mit bestehenden Arbeitsabläufen rückwärtskompatibel. Das bedeutet, Sie können weiterhin Product UIDs aus älteren Konfigurationen nutzen und gleichzeitig neue, personalisierte Produkt-Setups im Flow-Konfigurator einführen.