XML verwenden

Sie können für den Content-Schnittstellen-Paragraphen das XML Steht für „Extensible Markup Language“: Ein offener internationaler Standard für die Strukturierung und Übertragung von Daten zwischen Systemen.-Format verwenden. Falls Sie sich für XML entscheiden, legen Sie Ihre Produktdaten nicht wie bei der CSV-Lösung auf dem Optimizely Server ab. Stattdessen holt Optimizely Campaign Ihre Produktdaten bei Ihrem Webspace oder Ihrem Server ab – per sogenanntem HTTP-Request.

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).

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:

1. Öffnen Sie einen Text-Editor, zum Beispiel Notepad (Windows) oder Textedit (macOS/OS X).
2. Legen Sie im Text-Editor ein neues Dokument an.

   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.

3. Kopieren Sie folgenden Code in Ihr Dokument:
   Zu kopierender Code

   <?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[Alternativtext 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[Alternativtext 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[Alternativtext 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[Alternativtext 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[Alternativtext 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[Alternativtext für Bild 6]]></property>
   		<property name="image6Link"><![CDATA[Link für Bild 6]]></property>
   		<property name="additionalData1"><![CDATA[Zusatzinformation 1]]></property>
   		<property name="additionalData2"><![CDATA[Zusatzinformation 2]]></property>
   		<property name="additionalData3"><![CDATA[Zusatzinformation 3]]></property>
   		<property name="additionalData4"><![CDATA[Zusatzinformation 4]]></property>
   		<property name="additionalData5"><![CDATA[Zusatzinformation 5]]></property>
   		<property name="additionalData6"><![CDATA[Zusatzinformation 6]]></property>
   		<property name="additionalData7"><![CDATA[Zusatzinformation 7]]></property>
   		<property name="additionalData8"><![CDATA[Zusatzinformation 8]]></property>
   		<property name="additionalData9"><![CDATA[Zusatzinformation 9]]></property>
   		<property name="additionalData10"><![CDATA[Zusatzinformation 10]]></property>
   		<property name="additionalData11"><![CDATA[Zusatzinformation 11]]></property>
   		<property name="additionalData12"><![CDATA[Zusatzinformation 12]]></property>
   		<property name="additionalData13"><![CDATA[Zusatzinformation 13]]></property>
   		<property name="additionalData14"><![CDATA[Zusatzinformation 14]]></property>
   		<property name="additionalData15"><![CDATA[Zusatzinformation 15]]></property>
   		<property name="additionalData16"><![CDATA[Zusatzinformation 16]]></property>
   		<property name="additionalData17"><![CDATA[Zusatzinformation 17]]></property>
   		<property name="additionalData18"><![CDATA[Zusatzinformation 18]]></property>
   		<property name="additionalData19"><![CDATA[Zusatzinformation 19]]></property>
   		<property name="additionalData20"><![CDATA[Zusatzinformation 20]]></property>
   	</element>

   Die nachfolgenden Schritte führen Sie beispielhaft durch den kompletten Code. Die einzige Pflichtangabe ist die Produkt-ID (Property im Code: id). Alle anderen Werte sind optional. Löschen Sie unbenutzte Werte.

4. Tragen Sie in die erste Property-Zeile die Produkt-ID ein. Sie müssen Ihre Produkt-ID genau an die Stelle zwischen den spitzen Klammern eintragen.

   Beispiel: Ihr Produkt hat die Produkt-ID „FR123“: <property name="id">FR123</property>

   Verwenden Sie für Ihre Produkt-ID nur alphanumerische Zeichen (Buchstaben und Ziffern). Wenn Sie Sonderzeichen verwenden, kann es zu Fehlern beim Import Ihrer Produktdaten kommen.

   In den nachfolgenden Schritten geben Sie die Werte zwischen die Klammern nach CDATA ein.

5. Tragen Sie in die 2. bis 11. Property-Zeile (text1 bis text10) bis zu zehn textliche Bausteine Ihres Produktangebots ein. Als Platzhalter für Ihren textlichen Baustein ist „Textfeld 1“, „Textfeld 2“, „Textfeld 3“ und so weiter eingetragen.

   Zu den textlichen Bausteinen können beispielweise gehören: die Überschrift des Produktangebots, der Produktname, die Produktkategorie, die Produktbeschreibung, der alte Preis, der aktuelle Preis, der Hersteller/Anbieter und so weiter. Passen Sie die Inhalte entsprechend Ihren Wünschen und den Erfordernissen Ihres Produkts/Ihrer Dienstleistung an.

   Beispiel: Die Überschrift des Produktangebots lautet: Entspannen in Paris: <property name="text1"><![CDATA[Entspannen in Paris]]></property>

   Verteilen Sie die einzelnen Bestandteile Ihres Produktangebots chronologisch von text1 bis text 10, wie diese später auch von oben nach unten im fertigen Produktangebot angezeigt werden sollen. Wenn Sie sich nicht sicher sind, welche Reihenfolge für Sie am besten ist, wenden Sie sich an die Kundenbetreuung. Die Formatierung (zum Beispiel Schriftgröße und Schriftfarbe) der einzelnen textlichen Bausteine werden später gesondert über ein HTML-Layout gesteuert.

6. Tragen Sie in die 12. Property-Zeile die Beschriftung des Links zu Ihrem Produktangebot ein. Zum Beispiel: Zum Angebot, Mehr Informationen oder Jetzt kaufen.

   Beispiel: Die Beschriftung Ihres Links lautet: Jetzt buchen: <property name="link1Text"><![CDATA[Jetzt buchen]]></property>

7. Tragen Sie in die 13. Property-Zeile die URL ein, die zum Produkt führt, zum Beispiel zur Produktseite in Ihrem Webshop.

   Beispiel: Die URL zur Produktseite lautet http://www.sonnenhungrig/paris: <property name="link1Url"><![CDATA[http://www.sonnenhungrig/paris]]></property>

8. In die Property-Zeilen 14 bis 17 können Sie zwei weitere Links und zwei weitere Linkbeschriftungen eintragen, wenn Ihr Produktangebot mehr als einen Link haben soll. Nehmen Sie die Einträge entsprechend den Schritten 6 und 7 vor.

   Beispiel: Neben dem Link zur Buchungsseite der angebotenen Paris-Reise, führt ein weiterer Link zum aktuellen Reisewetter.

9. Tragen Sie die URL zum Produkt-Bild in die 18. Property-Zeile ein. Optimizely Campaign lädt das Produktbild über die angegebene URL und zeigt es in Ihrer Nachricht an.

   Beispiel: Die URL zum Produkt-Bild lautet http://www.sonnenhungrig.com/eiffelturm.jpg: <property name="image1ImageUrl"><![CDATA[http://www.sonnenhungrig.com/eiffelturm.jpg]]></property>

10. Tragen Sie in die 19. Property-Zeile den Alternativtext für Ihr Produkt-Bild ein. Ein Alternativtext ist der Text, der angezeigt wird, wenn ein Bild nicht geladen werden kann. Tragen Sie stets einen Alternativtext ein, denn dieser kann zudem sehbehinderten Menschen von speziellen Programmen vorgelesen werden und fördert die Barrierefreiheit des Internets.

    Beispiel: Der Alternativtext zu Ihrem Produktbild lautet „Der Eiffelturm in Paris im Frühling“: <property name="image1AltText"><![CDATA[Der Eiffelturm in Paris im Frühling]]></property>

11. Tragen Sie in die 20. Property-Zeile eine URL ein, die mit dem Produktbild verknüpft werden soll. Wenn ein Empfänger später auf das Bild klickt, wird er zum Ziel der verknüpften URL geführt. Dies kann Ihr Webshop sein oder auch jede andere Adresse, die Sie mit dem Bild in Zusammenhang bringen möchten.

    Die ImageURL führt zum Speicherort des Bildes, um dieses zu laden und in Ihren Nachrichten anzuzeigen. Der ImageLink hingegen führt den Empfänger nach dem Klicken des Bildes zum Link-Ziel mit weiteren Informationen.

    Beispiel: Die URL, die mit dem Bild Ihres Produkts verknüpft werden soll, lautet: http://www.sonnenhungrig.com/sehenswuerdigkeiten-in-frankreich: <property name="image1Link"><![CDATA[http://www.sonnenhungrig.com/sehenswuerdigkeiten-in-frankreich]]></property>

12. In die Property-Zeilen 21 bis 35 können Sie fünf weitere URLs zum Speicherort von Produktbildern, fünf weitere Alternativ-Texte sowie fünf weitere Links hinterlegen, die den Empfänger nach dem Klicken zum Link-Ziel führen. Dies bedeutet: Sie können pro Produktangebot bis zu sechs Produktbilder mit jeweils einem Alternativ-Text und jeweils einem weiterführenden Link einbinden. Nehmen Sie die Einträge entsprechend den Schritten 9 bis 11 in dieser Anleitung vor.
13. Tragen Sie in die Property-Zeilen 36 bis 55 weitere Datensätze ein, die Sie zum Beispiel als Metadaten für die Programmlogik der HTML-Layouts nutzen können.
14. Speichern Sie das Textdokument. Vergeben Sie als Dateinamen die Produkt-ID, also den Wert, den Sie im Code in die Property id eingetragen haben. Verwenden Sie den Dateitypen .xml.
15. Löschen Sie nach dem Speichern die Dateiendung Ihres Textdokuments. Wenn Ihr Textdokument beispielsweise ReiseParis01.xml heißt, benennen Sie die Datei in ReiseParis01 um.

    Wenn Sie die Dateiendung nicht entfernen, können Ihre Produktdaten nicht geladen werden.

16. Speichern Sie das Textdokument in Ihrem Webspace oder auf Ihrem Server im Verzeichnis, das Sie bei der Einrichtung des Produkt-Paragraphen mit Content-Schnittstelle angegeben haben.

    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 in Ihrem Webspace oder auf Ihrem Server gespeichert haben, können Sie im Template-Kit auf Ihr Produktangebot zugreifen. Folgen Sie im Abschnitt Statischer XML-Artikel 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.