Produktdaten als XML bereitstellen
Mittels HTTP-Request werden Ihre Produktdaten bei Ihrem Webspace oder Server abgefragt und ins Template-Kit geladen sowie in Optimizely Campaign importiert.
Zum Zeitpunkt der Abfrage müssen Ihre Produktdaten:
- bereits auf Ihrem Webspace oder Server als XML-Datei vorliegen (statische Produktdaten) oder
- sie werden durch den HTTP-Request von Ihrem Server als XML generiert und als Antwort zurückgegeben (dynamische Produktdaten).
Tip
Für welche Variante Sie sich entscheiden, hängt von der Systemumgebung in Ihrem Unternehmen ab. Wenden Sie sich an Ihren Systemadministrator, um die entsprechende technische Umsetzung festzulegen.
Statische Produktdaten auf dem Server hinterlegen
Wenn Sie Ihre Produktdaten statisch als XML-Dateien auf Ihrem Webspace oder Server hinterlegen möchten, müssen Sie jedes Produkt in einer gesonderten XML-Datei ablegen. Mehrere Produkte in einer einzigen XML-Datei zusammenzufassen, ist nicht möglich. Um ein Produkt als XML-Datei aufzubereiten, führen Sie die folgenden Schritte aus:
- Öffnen Sie einen Text-Editor, zum Beispiel Notepad (Windows) oder Textedit (macOS/OS X).
- Legen Sie im Texteditor ein neues Dokument an.
Warning
Stellen Sie Ihr Textdokument auf die Zeichenkodierung UTF-8 ein. Wenn Sie das Textdokument mit einer anderen Zeichenkodierung erstellen, kann es zu einer fehlerhaften Darstellung von Text kommen.
- Kopieren Sie den folgenden Code in Ihr Textdokument: Zu kopierender Code
<element><property name="id"><![CDATA[12345]]></property> <property name="name"><![CDATA[Name]]></property> <property name="category"><![CDATA[Kategorie]]></property> <property name="manufacturer"><![CDATA[Autor / Interpret / Hersteller]]></property> <property name="text"><![CDATA[Beschreibung des Produkts]]></property> <property name="oldPrice"><![CDATA[<s>29,99 EUR</s>]]></property> <property name="currentPrice"><![CDATA[<b>19,99 EUR</b>]]></property> <property name="linkText"><![CDATA[In den Warenkorb]]></property> <property name="linkUrl"><![CDATA[http://www.example.com/product/123456]]></property> <property name="imageUrl"><![CDATA[http://img.example.com/product/123456.jpg]]></property> </element>Tip
Die nachfolgenden Schritte führen Sie beispielhaft durch den kompletten Code. Pflichtangaben sind jedoch nur die Produkt-ID (im Code die Property id) und der Produkt-Name (im Code die Property name). Alle anderen Werte sind optional. Wenn Sie einzelne Werte nicht benötigen, überspringen Sie den jeweiligen Schritt und löschen Sie in Ihrem Textdokument die entsprechende Code-Zeile.
Beispiel: Wenn Sie den Produkthersteller nicht angeben möchten, löschen Sie folgende Zeile komplett:
<property name="manufacturer"><![CDATA[Autor / Interpret / Hersteller]]></property>Alternativ können Sie auch die nicht benötigten Code-Zeilen mit leerem Wert stehen lassen – zum Beispiel weil Sie die Angaben zu einem späteren Zeitpunkt nachholen möchten. Wenn Sie beispielsweise den Produkthersteller nicht angeben und die Code-Zeile mit leerem Wert stehen lassen möchten, sieht die Code-Zeile folgendermaßen aus:
<property name="manufacturer"><![CDATA[]]></property>Tip
Wenn Sie mit HTML vertraut sind, können Sie in die Propertys name, category, manufacturer, text, oldPrice, currentPrice HTML-Quelltext einsetzen. Beispiel: Sie möchten in die Produktbeschreibung Links einfügen.
- Tragen Sie in die erste Property-Zeile die Produkt-ID zwischen die eckigen Klammern nach CDATA ein. Beispiel: Ihr Produkt hat die Produkt-ID ReiseParis01.
<property name="id"><![CDATA[ReiseParis01]]></property>Note
Verwenden Sie für Ihre Produkt-ID nur alphanumerische Zeichen (Buchstaben und Ziffern). Wenn Sie Sonderzeichen verwenden, kann es später zu Problemen beim Import Ihrer Produktdaten kommen.
- Tragen Sie in die zweite Property-Zeile den Produktnamen zwischen die eckigen Klammern nach CDATA ein.
<property name="name"><![CDATA[Entspannen in Paris]]></property>- Tragen Sie in die dritte Property-Zeile die Produktkategorie zwischen die eckigen Klammern nach CDATA ein.
<property name="category"><![CDATA[Städtereisen]]></property>- Tragen Sie in die vierte Property-Zeile den Hersteller Ihres Produkts (oder je nach Produkt den Autoren, den Interpreten, den Veranstalter, den Anbieter und so weiter) zwischen die eckigen Klammern nach CDATA ein.
<property name="manufacturer"><![CDATA[sonnenhungrig Reisen]]></property>- Tragen Sie in die fünfte Property-Zeile die Beschreibung Ihres Produkts ein. Hier können Sie Text und einen Link zu einer Webseite mit weiterführenden Informationen zu Ihrem Produkt hinterlegen. Sie müssen die Beschreibung und den Link zwischen die eckigen Klammern nach CDATA eintragen.
<property name="text"><![CDATA[Eiffelturm, Champs-Élysées, Louvre: Gönnen Sie sich eine Auszeit in Paris!]]></property>- Tragen Sie in die sechste Property-Zeile den alten Preis Ihres Produkts zwischen <s> und </s> ein.
<property name="oldPrice"><![CDATA[<s>399 EUR</s>]]></property>Note
Standardmäßig wird der alte Preis durchgestrichen. Wenn Sie den alten Preis später nicht durchgestrichen in Ihren Nachrichten anzeigen möchten, löschen Sie <s> und </s> aus der Code-Zeile.
- Tragen Sie in die siebte Property-Zeile den aktuellen Preis Ihres Produkts zwischen <b> und </b> ein.
<property name="currentPrice"><![CDATA[<b>299 EUR</b>]]></property>Note
Standardmäßig wird der aktuelle Preis in fetter Schrift ausgegeben. Wenn Sie den aktuellen Preis später nicht in fetter Schrift in Ihren Nachrichten anzeigen möchten, löschen Sie <b> und </b> aus der Code-Zeile.
- Tragen Sie in die achte Property-Zeile einen Text für den Link zu Ihrem Produkt zwischen die eckigen Klammern nach CDATA ein.
<property name="linkText"><![CDATA[Jetzt buchen]]></property>- Tragen Sie in die neunte Property-Zeile die Link-URL zu Ihrem Produkt zwischen die eckigen Klammern nach CDATA ein.
<property name="linkUrl"><![CDATA[http://www.sonnenhungrig.com/paris]]></property>- Tragen Sie in die zehnte Property-Zeile die URL zu dem Bild Ihres Produkts zwischen die eckigen Klammern nach CDATA ein.
<property name="imageUrl"><![CDATA[http://www.sonnenhungrig.com/eiffelturm.jpg]]></property>- Speichern Sie Ihr Textdokument. Vergeben Sie als Dateinamen die Produkt-ID, also den Wert, den Sie im Code in die Property-Zeile id eingetragen haben.
- Entfernen Sie nach dem Speichern die Dateiendung Ihres Textdokuments. Wenn Ihr Textdokument beispielsweise ReiseParis01.xml heißt, benennen Sie die Datei in ReiseParis01 um.
Warning
Wenn Sie die Dateiendung nicht entfernen, können Ihre Produktdaten nicht über die Content-Schnittstelle geladen werden.
- Speichern Sie das Textdokument in Ihrem Webspace oder auf Ihrem Server in das Verzeichnis, das Sie bei Einrichtung des Produkt-Paragraphen mit Content-Schnittstelle angegeben haben.
Warning
Verändern Sie nicht den Speicherort Ihrer Textdokumente mit den Produktbeschreibungen ohne vorherige Rücksprache mit der Kundenbetreuung. Wenn Sie Ihre Textdokumente ohne Rücksprache mit der Kundenbetreuung in ein anderes Verzeichnis legen, können Ihre Produktdaten nicht mehr über die Content-Schnittstelle geladen werden.
Wenn Sie Ihr Textdokument erfolgreich in Ihrem Webspace oder auf Ihrem Server gespeichert haben, können Sie im Template-Kit auf Ihr Produktangebot zugreifen. Folgen Sie im Abschnitt Produktdaten laden und bearbeiten den einzelnen Schritten, um Ihre Produktangebote über die Content-Schnittstelle ins Template-Kit zu übertragen.
Dynamische Produktdaten auf dem Server generieren
XML-Dateien werden nicht manuell vorbereitet, sondern per HTTP-Request über die Content-Schnittstelle aus einer Datenbank geladen und automatisch als XML bereitgestellt. Wenden Sie sich an Ihren System-Administrator, wenn Sie dynamische Produktdaten generieren möchten.