Die Produktdaten-Schnittstelle

12 min

Allgemeine Informationen

Überblick

Die Produktdaten-Schnittstelle ist eine optionale Funktion, mit der Sie Daten aus externen Quellen im Design-Editor für E-Mails verwenden können. Sie wird hauptsächlich für Informationen zu Produkten und Angeboten aus E-Commerce-Systemen verwendet. Dazu muss Ihr E-Commerce-System Produktdaten in eine Datei exportieren können.

Datenverarbeitung und -formatierung

Produktdaten werden in vier Stufen verarbeitet:

Sie laden Ihre Produktdaten als CSV-Datei über SFTP auf den Server von Optimizely hoch. Optimizely erstellt in Campaign einen Job, der die Daten importiert. Derzeit werden vier CSV-Formate unterstützt: Campaign (siehe CSV-Struktur unten), Oxid, Magento und Shopware. Wenn Sie SFTP nicht verwenden möchten, kann innerhalb von Campaign eine spezielle Upload-Seite bereitgestellt werden.

Die Optimizely-Kundenbetreuung kombiniert Ihre Datei mit einem Mapping. Dadurch wird festgelegt, welche Felder im Design-Editor verfügbar sind. Die Kombination Ihrer Daten mit einem Mapping heißt Produkt-Feed.

Optimizely erstellt ein oder mehrere kundenspezifische Produkt-Layouts, die festlegen, wie die Informationen aus Ihrem Produkt-Feed gestaltet und angezeigt werden.

Sie fügen Produktelemente zu Ihren Nachrichtenentwürfen hinzu, um Produkte aus Ihrem Feed anzuzeigen. In einem Produktelement werden Produktdaten gemäß einem Produktlayout dargestellt.

Sie können Ihre Produktdaten-Datei später selbst über SFTP oder in der Campaign-Benutzeroberfläche aktualisieren, vorausgesetzt dass sich die Datenstruktur nicht ändert, sodass das Mapping weiterhin passt.

Produkt-Layouts

Wie oben unter Datenverarbeitung und -formatierung erläutert, sind für die Verwendung von Produktelementen Produkt-Layouts erforderlich. Diese Produkt-Layouts werden von Optimizely auf Anfrage erstellt. Dieser Service wird pro Layout abgerechnet.

Produktelemente

Daten aus einem Produkt-Feed sind im Design-Editor über Produktelemente verfügbar. Wie alle anderen Elemente können Sie diese hinzufügen, indem Sie sie aus dem Seitenbereich in den Designbereich ziehen. Der Produkt-Feed enthält noch keine Formatierungen, daher müssen Sie beim Hinzufügen eines Produktelements ein Produkt-Layout auswählen.

Nachdem ein Produktelement zu einem Nachrichtenentwurf hinzugefügt wurde, ist sein Inhalt statisch, sodass alle Empfänger denselben Inhalt erhalten. Wenn die Daten aus dem Feed nicht genau dem entsprechen, was Sie an Ihre Empfänger senden möchten, können Sie einzelne Werte innerhalb eines Produktelements überschreiben (siehe Werte in einem Produktelement überschreiben unten).

The settings for a product element in the Design Editor for emails, with a preview for the mobile version.

CSV-Struktur

Für Ihre CSV-Dateien können Sie das Exportformat von Oxid, Magento, Shopware oder das generische CSV-Format von Optimizely Campaign verwenden. Das Campaign-Format verwendet folgende Spaltenüberschriften:

"id";"name";"category";"text1";"text2";"text3";"text4";"text5";"text6";"text7";"text8";"text9";"text10";"link1Text";"link1Url";"link2Text";"link2Url";"link3Text";"link3Url";"image1ImageUrl";"image1AltText";"image1Link";"image2ImageUrl";"image2AltText";"image2Link";"image3ImageUrl";"image3AltText";"image3Link";"image4ImageUrl";"image4AltText";"image4Link";"image5ImageUrl";"image5AltText";"image5Link";"image6ImageUrl";"image6AltText";"image6Link";"additionalData1";"additionalData2";"additionalData3";"additionalData4";"additionalData5";"additionalData6";"additionalData7";"additionalData8";"additionalData9";"additionalData10";"additionalData11";"additionalData12";"additionalData13";"additionalData14";"additionalData15";"additionalData16";"additionalData17";"additionalData18";"additionalData19";"additionalData20";

Beachten Sie bei der Konfiguration des Exports Folgendes:

Die CSV-Datei muss RFC-konform sein. Technische Hinweise finden Sie in RFC 4180.

Stellen Sie die Zeichenkodierung für die CSV-Datei auf UTF-8 ohne BOM ein.

Verwenden Sie das Semikolon (;) als Trennzeichen.

Wenn die Produktdaten obenstehende Anführungszeichen enthalten, müssen Sie diese Anführungszeichen in der CSV-Datei doppelt schreiben, um sie zu maskieren. Der Import der Produktdaten schlägt fehl, wenn Anführungszeichen aus Ihrem Inhalt fälschlicherweise als Code interpretiert werden. Beispiel: Wenn Ihre Daten Wörter in obenstehenden Anführungszeichen enthalten, z. B. "Savoir Vivre.", setzen Sie den zitierten Text in der CSV-Datei in doppelte Anführungszeichen: ""Savoir Vivre"". Das erste Anführungszeichen jedes Paares dient als Maskierungszeichen.

Unterstützte Inhalte

Die Produktdaten-Schnittstelle kann für jedes Produktelement die folgenden Daten laden:

die eindeutige ID, den Namen und die Kategorie des Produkts

bis zu 10 Textelemente pro Produktelement, z. B. für die Überschrift eines Produktelements, eine Produktbeschreibung oder den Preis.

bis zu 3 Text-Links pro Produktelement, beispielsweise Handlungsaufforderungen wie „Jetzt kaufen“.

bis zu 6 Produktbilder pro Produktangebot (als URL)

bis zu 6 Links zu Produktbildern (ein Link pro Bild), die den Empfänger durch Anklicken des Bildes zu weiteren Informationen führen

bis zu 6 alternative Texte für Produktbilder, falls ein Empfänger keine Produktbilder laden kann und um die Barrierefreiheit zu verbessern

Arbeiten mit Produktdaten

Produktelement zu einem Nachrichtenentwurf hinzufügen

Voraussetzungen: Sie sehen einen Nachrichtenentwurf im Design-Editor. Ein Produkt-Feed und ein Produkt-Layout sind in Ihrem Mandanten verfügbar.

Suchen Sie im Seitenbereich auf der Registerkarte Inhalt das Element Produkt.

Ziehen Sie das Element an die gewünschte Position im Designbereich. → Ein neues, leeres Produktelement wird Ihrem Nachrichtenentwurf hinzugefügt.

Klicken Sie im neuen Element auf Bearbeiten... → Sie sehen das Menü Produkte, der Tab Layout und Produktauswahl ist ausgewählt.

Wählen Sie im Feld Feed den Feed aus, der das gewünschte Produkt enthält.

Wählen Sie im Feld Layout-Vorlage das Layout aus, das Sie verwenden möchten.

Wählen Sie im Feld Produktauswahl das Produkt aus, das Sie im Nachrichtenentwurf anzeigen möchten.

Überprüfen Sie, ob die Vorschauen für die Desktop- und Mobilansicht wie erwartet aussehen.

Klicken Sie auf Übernehmen. → Das Produktelement zeigt das Produkt aus dem Produkt-Feed an.

Werte in einem Produktelement überschreiben

Kontext: Wenn der Inhalt aus dem Produkt-Feed für Ihren Nachrichtenentwurf nicht ganz passt, können Sie die Werte einzelner Variablen innerhalb eines Produktelements ersetzen. Dies gilt nur für das aktuelle Produktelement und ändert nichts am Inhalt des Produkt-Feeds. Voraussetzungen: Sie sehen einen Nachrichtenentwurf mit einem Produktelement im Design-Editor.

Wählen Sie das Produktelement aus.

Klicken Sie im Seitenbereich im Abschnitt Inhaltseigenschaften auf Bearbeiten... → Sie sehen das Menü Produkte, der Tab Layout und Produktauswahl ist ausgewählt.

Öffnen Sie die Registerkarte Überschreibung.

Klicken Sie auf + Überschreiben. → Dem Menü wird eine neue Zeile mit zwei Feldern hinzugefügt.

Wählen Sie im Feld CSV-Spalte (Variable) die Variable aus, für die Sie einen neuen Wert definieren möchten.

Geben Sie im Feld Inhalt den Wert ein, den Sie für dieses Produktelement verwenden möchten. Hinweis: Sie können hier einfache HTML-Tags wie <b> für fett oder <i> für kursiv verwenden.

Klicken Sie auf Übernehmen. → Das Produktelement zeigt den neuen Wert an.

Eine Überschreibung löschen

Voraussetzungen: Sie sehen einen Nachrichtenentwurf mit einem Produktelement im Design-Editor. Das Produktelement enthält mindestens eine Überschreibung.

Wählen Sie das Produktelement aus.

Klicken Sie im Seitenbereich im Abschnitt Inhaltseigenschaften auf Bearbeiten... → Sie sehen das Menü Produkt, die Registerkarte Layout und Produktauswahl ist ausgewählt.

Öffnen Sie die Registerkarte Überschreibungen.

Suchen Sie die Überschreibung, die Sie löschen möchten.

Klicken Sie in der Zeile der Überschreibung auf

(Zeile entfernen).

Klicken Sie auf Übernehmen. → Die Überschreibung wird gelöscht.

Layout eines Produktelements anspassen

Warning

Diese Funktion ist für Experten gedacht. Stellen Sie sicher, dass Ihre Änderungen sicher und responsiv sind.

Kontext: Wenn Sie das Aussehen eines einzelnen Produktelements ändern möchten, können Sie das vordefinierte Layout anpassen. Voraussetzungen: Sie sehen einen Nachrichtenentwurf mit einem Produktelement im Design-Editor.

Wählen Sie das Produktelement aus.

Klicken Sie im Seitenbereich im Abschnitt Inhaltseigenschaften auf Bearbeiten... → Sie sehen das Menü Produkte, die Registerkarte Layout und Produktauswahl ist ausgewählt.

Öffnen Sie die Registerkarte HTML-Layout.

Aktivieren Sie den Schalter Lokales Überschreiben des HTML- und Velocity-Codes.

Passen Sie den Code nach Wunsch an.

Klicken Sie auf Anwenden. → Die Änderungen werden auf das Produktelement angewendet. Das vordefinierte Layout bleibt davon unberührt.

Produktdaten-Datei aktualisieren (UI)

Note

Dieser Vorgang überschreibt Ihre vorhandenen Produktdaten. Achten Sie darauf, dass Sie keine Daten verlieren, die Sie noch benötigen!

Kontext: Wenn dies von Ihrer Kampagnenkonfiguration unterstützt wird, können Sie Ihre Produktdaten aktualisieren, indem Sie eine neue CSV-Datei über die Benutzeroberfläche hochladen. Stellen Sie sicher, dass sich die Struktur Ihrer Daten nicht geändert hat. Der Name der hochgeladenen Datei ist nicht wichtig, er wird automatisch angepasst. Voraussetzungen: Sie sind bei Optimizely Campaign angemeldet. Sie haben die Berechtigung Special Pages. Die Datei mit den aktualisierten Produktdaten ist auf Ihrem lokalen System verfügbar.

Gehen Sie in der Menüleiste zu Mehr... > Datei hochladen. Hinweis: Je nach Ihrer Konfiguration kann der Menüeintrag einen anderen Namen haben.

Klicken Sie auf Datei auswählen.

Wählen Sie die Datei mit den aktualisierten Produktdaten aus.

Klicken Sie auf Hochladen. → Ihre vorhandene Produktdatendatei wird durch die neue Datei ersetzt.

Produktdaten-Datei aktualisieren (SFTP)

Note

Dieser Vorgang überschreibt Ihre vorhandenen Produktdaten. Achten Sie darauf, dass Sie keine Daten verlieren, die Sie noch benötigen!

Kontext: Sie können Ihre Produktdaten aktualisieren, indem Sie eine neue CSV-Datei hochladen, sofern sich die Struktur Ihrer Daten nicht geändert hat. Voraussetzungen: Sie haben SFTP-Zugriff auf Ihren CSV-Importordner. Ein Importauftrag wurde vom Optimizely-Support erstellt.

Starten Sie Ihren FTP-Client.

Stellen Sie eine Verbindung zu Ihrem CSV-Importordner auf dem Optimizely-Server her.

Laden Sie die neue Produktdaten-Datei unter genau demselben Namen hoch und überschreiben Sie dabei die alte Datei. → Ihre vorhandene Produktdaten-Datei wird durch die neue Datei ersetzt.