Produktelemente und Produktdaten

Allgemeine Übersicht

Produktelemente sind eine optionale Funktion, mit der Sie Daten aus externen Quellen im Design Editor für E-Mails verwenden können. Sie werden hauptsächlich für Produktinformationen aus E-Commerce-Systemen genutzt. Dafür muss Ihr E-Commerce-System Produktdaten in CSV- oder XML-Dateien exportieren können.

Datenbereitstellung

Übersicht über Datenverarbeitung und -formatierung

Produktdaten werden in fünf Schritten verarbeitet:

• Sie stellen Ihre Produktdaten entweder als CSV-Datei oder als XML-Datei bereit. Wenn Sie CSV-Dateien verwenden, laden Sie diese per SFTP auf den Optimizely-Server hoch. Wenn Sie SFTP für CSV-Uploads nicht verwenden möchten, kann innerhalb von Campaign eine spezielle Upload-Seite bereitgestellt werden. Wenn Sie XML-Dateien verwenden, laden Sie diese auf Ihren eigenen Server hoch.
• Die Optimizely-Kundenbetreuung erstellt einen Job in Campaign, der die Daten importiert.
• Die Optimizely-Kundenbetreuung verknüpft Ihre CSV- oder XML-Datendatei mit einem Mapping. Dieses legt fest, welche Felder im Design Editor für E-Mails verfügbar sind. Die Kombination Ihrer Daten mit einem Mapping wird als Produkt-Feed bezeichnet.
• Die Optimizely-Kundenbetreuung erstellt ein oder mehrere kundenspezifische Produkt-Layouts, die festlegen, wie 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 die Produktdaten gemäß einem Produkt-Layout gerendert.

Es werden vier CSV-Formate für Produktdaten unterstützt:

• das eigene Format von Campaign (siehe CSV-Struktur weiter unten),
• Oxid,
• Magento,
• Shopware.

Sie können Ihre CSV-Produktdatendatei später selbst per SFTP oder über die Campaign-Benutzeroberfläche aktualisieren. Eine XML-Datei, die Sie auf Ihrem eigenen Server hosten, können Sie natürlich jederzeit aktualisieren.

Achten Sie beim Aktualisieren von Produktdaten darauf, dass sich die Struktur der Daten nicht ändert, damit das Mapping weiterhin passt.

Unterstützte Inhalte

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

• die eindeutige ID, den Namen und die Kategorie des Produkts
  Hinweis: Name und Kategorie sind in der CSV-Struktur vordefiniert, nicht jedoch in XML. Sie werden für Drop-down-Felder zur Produktauswahl im Design Editor für E-Mails verwendet, die bei XML-basierten Produkt-Feeds nicht verfügbar sind; siehe XML-Datenabruf und Benutzererfahrung weiter unten.
• bis zu 10 Zeichenketten, z. B. eine Überschrift, eine Produktbeschreibung oder einen Preis
• bis zu 3 Text-Links, z. B. Handlungsaufforderungen (z. B. „Jetzt kaufen")
• bis zu 6 Bilder (angegeben als URL einer Bilddatei), einschließlich Alt-Texten
• bis zu 6 Bild-Links, die beim Klicken auf ein Bild zu weiterführenden Informationen führen
• bis zu 20 Zeichenketten mit zusätzlichen Daten

Produkt-Layouts und Produktelemente

Wie unter Übersicht über Datenverarbeitung und -formatierung erwähnt, sind Produkt-Layouts für die Verwendung von Produktelementen erforderlich. Produkt-Layouts werden von Optimizely auf Anfrage erstellt. Dieser Service wird pro Layout berechnet.

Ein Layout kann auf einen Produkt-Feed angewendet werden, wenn die Datenfelder übereinstimmen. Dasselbe Layout kann auf Daten aus CSV-Dateien und auch auf Daten aus XML-Dateien angewendet werden, wenn die Daten aus beiden Quellen so gemappt werden, dass der resultierende Produkt-Feed zum Layout passt.

Daten aus einem Produkt-Feed sind im Design Editor für E-Mails über Produktelemente verfügbar. Wie alle anderen Elemente fügen Sie diese hinzu, indem Sie sie aus dem Seitenbereich in den Design-Bereich ziehen. Der Produkt-Feed enthält 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 Ihren Empfängern senden möchten, können Sie einzelne Werte innerhalb eines Produktelements überschreiben (siehe Werte in einem Produktelement überschreiben weiter unten).

CSV-Struktur

Für Ihre CSV-Dateien können Sie Formate verschiedener Systeme verwenden; siehe Datenverarbeitung und -formatierung oben. Das eigene Format von Optimizely Campaign 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 beim Konfigurieren des CSV-Exports Folgendes:

• Die CSV-Datei muss RFC-konform sein. Technische Hinweise finden Sie in RFC 4180.
• Verwenden Sie UTF-8 ohne BOM.
• Verwenden Sie das Semikolon (;) als Trennzeichen.
• Wenn die Produktdaten Anführungszeichen enthalten, maskieren Sie diese in der CSV-Datei durch doppelte Anführungszeichen. Der Produktdatenimport schlägt fehl, wenn Anführungszeichen aus Ihrem Inhalt als Code fehlinterpretiert werden.
  Beispiel: Wenn Ihre Daten Wörter in Anführungszeichen enthalten, z. B. „Savoir Vivre.", setzen Sie den Text in der CSV-Datei in doppelte Anführungszeichen: ""Savoir Vivre"". Das jeweils erste Anführungszeichen eines Paares dient dabei als Escape-Zeichen.

XML-Struktur und -Datei

Ihre XML-Dateien müssen auf folgender Struktur basieren. Sie dürfen keine Zeilen hinzufügen, können jedoch Zeilen, die Sie nicht benötigen, weglassen.

<?xml version="1.0" encoding="UTF-8"?>

<element>
<property name="id">123456</property>

<property name="text1"><![CDATA[<b>Textfeld 1</b>]]></property>
<property name="text2"><![CDATA[Textfeld 2]]></property>
<property name="text3"><![CDATA[Textfeld 3]]></property>
<property name="text4"><![CDATA[Textfeld 4]]></property>
<property name="text5"><![CDATA[Textfeld 5]]></property>
<property name="text6"><![CDATA[Textfeld 6]]></property>
<property name="text7"><![CDATA[Textfeld 7]]></property>
<property name="text8"><![CDATA[Textfeld 8]]></property>
<property name="text9"><![CDATA[Textfeld 9]]></property>
<property name="text10"><![CDATA[Textfeld 10]]></property>

<property name="link1Text"><![CDATA[Text für Link 1]]></property>
<property name="link1Url"><![CDATA[URL für Link 1]]></property>
<property name="link2Text"><![CDATA[Text für Link 2]]></property>
<property name="link2Url"><![CDATA[URL für Link 2]]></property>
<property name="link3Text"><![CDATA[Text für Link 3]]></property>
<property name="link3Url"><![CDATA[URL für Link 3]]></property>

<property name="image1ImageUrl"><![CDATA[Bild-URL für Bild 1]]></property>
<property name="image1AltText"><![CDATA[Alt-Text für Bild 1]]></property>
<property name="image1Link"><![CDATA[Link für Bild 1]]></property>
<property name="image2ImageUrl"><![CDATA[Bild-URL für Bild 2]]></property>
<property name="image2AltText"><![CDATA[Alt-Text für Bild 2]]></property>
<property name="image2Link"><![CDATA[Link für Bild 2]]></property>
<property name="image3ImageUrl"><![CDATA[Bild-URL für Bild 3]]></property>
<property name="image3AltText"><![CDATA[Alt-Text für Bild 3]]></property>
<property name="image3Link"><![CDATA[Link für Bild 3]]></property>
<property name="image4ImageUrl"><![CDATA[Bild-URL für Bild 4]]></property>
<property name="image4AltText"><![CDATA[Alt-Text für Bild 4]]></property>
<property name="image4Link"><![CDATA[Link für Bild 4]]></property>
<property name="image5ImageUrl"><![CDATA[Bild-URL für Bild 5]]></property>
<property name="image5AltText"><![CDATA[Alt-Text für Bild 5]]></property>
<property name="image5Link"><![CDATA[Link für Bild 5]]></property>
<property name="image6ImageUrl"><![CDATA[Bild-URL für Bild 6]]></property>
<property name="image6AltText"><![CDATA[Alt-Text für Bild 6]]></property>
<property name="image6Link"><![CDATA[Link für Bild 6]]></property>

<property name="additionalData1"><![CDATA[Zusätzliche Information 1]]></property>
<property name="additionalData2"><![CDATA[Zusätzliche Information 2]]></property>
<property name="additionalData3"><![CDATA[Zusätzliche Information 3]]></property>
<property name="additionalData4"><![CDATA[Zusätzliche Information 4]]></property>
<property name="additionalData5"><![CDATA[Zusätzliche Information 5]]></property>
<property name="additionalData6"><![CDATA[Zusätzliche Information 6]]></property>
<property name="additionalData7"><![CDATA[Zusätzliche Information 7]]></property>
<property name="additionalData8"><![CDATA[Zusätzliche Information 8]]></property>
<property name="additionalData9"><![CDATA[Zusätzliche Information 9]]></property>
<property name="additionalData10"><![CDATA[Zusätzliche Information 10]]></property>
<property name="additionalData11"><![CDATA[Zusätzliche Information 11]]></property>
<property name="additionalData12"><![CDATA[Zusätzliche Information 12]]></property>
<property name="additionalData13"><![CDATA[Zusätzliche Information 13]]></property>
<property name="additionalData14"><![CDATA[Zusätzliche Information 14]]></property>
<property name="additionalData15"><![CDATA[Zusätzliche Information 15]]></property>
<property name="additionalData16"><![CDATA[Zusätzliche Information 16]]></property>
<property name="additionalData17"><![CDATA[Zusätzliche Information 17]]></property>
<property name="additionalData18"><![CDATA[Zusätzliche Information 18]]></property>
<property name="additionalData19"><![CDATA[Zusätzliche Information 19]]></property>
<property name="additionalData20"><![CDATA[Zusätzliche Information 20]]></property>

</element>

Beachten Sie beim Erstellen von XML-Dateien Folgendes:

• Verwenden Sie als Dateinamen die Produkt-ID (denselben Wert wie in der Datei, siehe unten).
• Verwenden Sie als Dateityp XML, aber verwenden Sie keine Dateinamenerweiterung.
  Beispiel: Verwenden Sie nicht wellness.xml als Dateinamen, sondern nur wellness. mit dem Punkt am Ende.
• Verwenden Sie die Zeichenkodierung UTF-8.

Beachten Sie für den Inhalt der Datei Folgendes:

• Geben Sie in der ersten property-Zeile die Produkt-ID zwischen den <property>-Tags ein.
  Hinweis: Verwenden Sie für die Produkt-ID ausschließlich Buchstaben und Zahlen.
  Beispiel:  <property name="id">123456</property>
• Fügen Sie in allen übrigen Zeilen den Wert in eckigen  Klammern nach CDATA ein.
• Geben Sie in den Zeilen text1 bis text10 bis zu zehn Zeichenketten für Ihr Produktangebot ein. Textfeld 1, Textfeld 2 usw. sind Platzhalter. Diese Zeichenketten können eine Überschrift für das Produktangebot, den Produktnamen, die Produktbeschreibung, den Preis, den Hersteller und weitere Angaben enthalten. Passen Sie den Inhalt an Ihre Bedürfnisse an.
  Beispiel: <property name="text1"><![CDATA[Wellness-Wochenende]]></property>
• Geben Sie in den link-bezogenen Zeilen Link-Texte und Link-Ziele (URLs) für bis zu drei Links ein.
  Beispiel:
  <property name="link1Text"><![CDATA[Jetzt buchen]]></property>
  <property name="link1Url"><![CDATA[http://www.example.com/wellness]]></property>
• Geben Sie in den bild-bezogenen Zeilen bis zu sechs Sätze von Bildquellen (URLs), Alt-Texten und Link-Zielen ein.
  Beispiel:
  <property name="image1ImageUrl"><![CDATA[http://www.example.com/pool.jpg]]></property>
  <property name="image1AltText"><![CDATA[Ein Hallenbad]]></property>
  <property name="image1Link"><![CDATA[http://www.example.com/wellness]]></property>
• Geben Sie in den Zeilen für zusätzliche Daten beliebige weitere Werte ein, die Sie verwenden möchten, z. B. Metadaten für die Programmlogik der HTML-Layouts.

XML-Datenabruf und Benutzererfahrung

Um Produktdaten im Design Editor für E-Mails verfügbar zu machen, stellen Sie die XML-Dateien auf Ihrem Server an dem genauen Speicherort bereit, den Sie mit der Optimizely-Kundenbetreuung vereinbart haben.

Die URL zum Abrufen von XML-Dateien muss eine der folgenden Strukturen aufweisen:

• [Basis-URL]?id=[Produkt-ID]
• [Basis-URL]/[Produkt-ID]

Die Daten aus XML-Dateien werden nicht wie Daten aus CSV-Dateien in Ihrem Campaign-Mandanten gespeichert, sondern bei Bedarf direkt von Ihren eigenen Servern abgerufen. Dies führt zu einem Unterschied in der Benutzererfahrung: Bei der Produktauswahl im Design Editor für E-Mails ist das Formularfeld für Produkt-IDs kein Drop-down-Feld, sondern ein einfaches Textfeld, da das Abrufen aller möglichen IDs von einem externen Server die Performance beeinträchtigen würde. Benutzer müssen daher beim Bearbeiten eines Nachrichtenentwurfs die ID des gewünschten Produkts kennen.

CSV-Produktdatendatei aktualisieren (Benutzeroberfläche)

Durch diesen Vorgang wird Ihre bestehende Produktdatendatei überschrieben. Achten Sie darauf, keine Daten zu verlieren, die Sie noch benötigen!

Kontext: Wenn Ihre Campaign-Konfiguration dies unterstützt, können Sie Ihre Produktdaten aktualisieren, indem Sie eine neue CSV-Datei über die Benutzeroberfläche hochladen. Achten Sie darauf, dass sich die Struktur Ihrer Daten nicht ändert. Der Name der hochgeladenen Datei ist nicht relevant; er wird automatisch angepasst.
Voraussetzungen: Sie sind in Optimizely Campaign angemeldet. Sie verfügen über die Berechtigung Spezialseiten. Die Datei mit den aktualisierten Produktdaten ist auf Ihrem lokalen System verfügbar.

1. Gehen Sie in der Navigationsleiste zu Mehr... > Datei hochladen.
   Hinweis: Je nach Konfiguration kann der Menüeintrag einen anderen Namen haben.
2. Klicken Sie auf Datei auswählen.
3. Wählen Sie die Datei mit den aktualisierten Produktdaten aus.
4. Klicken Sie auf Hochladen.
   → Ihre bestehende Produktdatendatei wird durch die neue Datei ersetzt.

CSV-Produktdatendatei aktualisieren (SFTP)

Durch diesen Vorgang werden Ihre bestehenden Daten überschrieben. Achten Sie darauf, keine Daten zu 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 ändert.
Voraussetzungen: Sie haben SFTP-Zugriff auf Ihren CSV-Importordner. Ein Importjob wurde von der Optimizely-Kundenbetreuung erstellt.

1. Starten Sie Ihren FTP-Client.
2. Stellen Sie eine Verbindung zu Ihrem CSV-Importordner auf dem Optimizely-Server her.
3. Laden Sie die neue Produktdatendatei unter exakt demselben Namen hoch und überschreiben Sie dabei die alte Datei.
   → Ihre bestehende Produktdatendatei wird durch die neue Datei ersetzt.

Mit Produktdaten arbeiten

Produktelement zu einem Nachrichtenentwurf hinzufügen

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

1. Suchen Sie im Seitenbereich im Tab Inhalt das Element Produkt.
2. Ziehen Sie das Element an die gewünschte Position im Design-Bereich.
   → Ein neues, leeres Produktelement wird zu Ihrem Nachrichtenentwurf hinzugefügt.
3. Klicken Sie im neuen Element auf Bearbeiten...
   → Das Menü Produkt wird angezeigt; der Tab Layout- und Produktauswahl ist ausgewählt.
4. Wählen Sie im Feld Feed den Feed aus, der das gewünschte Produkt enthält.
5. Wählen Sie im Feld Produkt-Layout das gewünschte Layout aus.
6. Wählen Sie im Feld Produktauswahl das Produkt aus, das im Nachrichtenentwurf angezeigt werden soll.
   Hinweis: Wenn Ihr Produkt-Feed auf XML-Dateien basiert, müssen Sie die Produkt-ID hier manuell eingeben.
7. Prüfen Sie, ob die Vorschauen für Desktop- und mobile Ansicht wie erwartet aussehen.
8. 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 passend ist, können Sie die Werte einzelner Variablen innerhalb eines Produktelements ersetzen. Dies gilt nur für das jeweilige Produktelement und ändert nicht den Inhalt des Produkt-Feeds.
Voraussetzungen: Sie sehen einen Nachrichtenentwurf mit einem Produktelement im Design Editor für E-Mails.

1. Wählen Sie das Produktelement aus.
2. Klicken Sie im Seitenbereich im Abschnitt Inhaltseigenschaften auf Bearbeiten...
   → Das Menü Produkt wird angezeigt; der Tab Layout- und Produktauswahl ist ausgewählt.
3. Öffnen Sie den Tab Überschreibungen.
4. Klicken Sie auf + Überschreiben.
   → Eine neue Zeile mit zwei Feldern wird dem Menü hinzugefügt.
5. Wählen Sie im Feld Spalte (Variable) die Variable aus, für die Sie einen neuen Wert festlegen möchten.
6. 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.
7. Klicken Sie auf Übernehmen.
   → Das Produktelement zeigt den neuen Wert an.

Überschreibung löschen

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

1. Wählen Sie das Produktelement aus.
2. Klicken Sie im Seitenbereich im Abschnitt Inhaltseigenschaften auf Bearbeiten...
   → Das Menü Produkt wird angezeigt; der Tab Layout- und Produktauswahl ist ausgewählt.
3. Öffnen Sie den Tab Überschreibung.
4. Suchen Sie die Überschreibung, die Sie löschen möchten.
5. Klicken Sie in der Zeile der Überschreibung auf (Zeile entfernen).
6. Klicken Sie auf Übernehmen.
   → Die Überschreibung wird gelöscht.

Layout eines Produktelements anpassen

Diese Funktion richtet sich an erfahrene Benutzer. Stellen Sie sicher, dass Ihre Änderungen sicher und responsiv sind.

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

1. Wählen Sie das Produktelement aus.
2. Klicken Sie im Seitenbereich im Abschnitt Inhaltseigenschaften auf Bearbeiten...
   → Das Menü Produkt wird angezeigt; der Tab Layout- und Produktauswahl ist ausgewählt.
3. Öffnen Sie den Tab HTML-Layout.
4. Aktivieren Sie den Umschalter Lokales Überschreiben von HTML- und Velocity-Code.
5. Passen Sie den Code nach Bedarf an.
6. Klicken Sie auf Übernehmen.
   → Die Änderungen werden auf das Produktelement angewendet. Das vordefinierte Layout bleibt davon unberührt.