Template-Sprache

Produktdatenfeed anbinden und einsetzen

Produkte aus einem Onlineshop über sitepackage:// zum Newsletter hinzufügen

Betreiber von Onlineshops stellen in ihren Newslettern häufig die eigenen Produkte vor. sitepackage:// bietet die Möglichkeit, einen sogenannten Produktdatenfeed an das Newsletter-System anzubinden. Anschließend können die Produkte über die sitepackage:// Benutzeroberfläche zum Newsletter hinzugefügt werden.

Was ist ein Produktdatenfeed?

Bei einem Produktdatenfeed handelt es sich um eine Datei, die alle oder ausgewählte Produkte eines Onlineshops beinhaltet. Zusätzlich zu Standardangaben wie Artikelnummer, Name, Preis, Beschreibung, URL und Bild-URL können je nach Ausrichtung des Produktdatenfeeds noch weitere Angaben wie Gewicht, Versandkosten, Verfügbarkeit etc. darin aufgeführt werden. Solche Produktdatenfeeds werden in der Regel genutzt, um Daten an Anbieter wie Google oder eBay zu übermitteln und passende Produktanzeigen in Suchergebnissen oder auf Shopping-Portalen zu schalten.

Anbindung eines Produktdatenfeeds

Mit der Template-Sprache von sitepackage:// besteht die Möglichkeit, einen Produktdatenfeed an die Newsletter Software anzubinden. So können Produkte aus dem Onlineshop auf einfache und zeitsparende Weise im Newsletter ausgegeben werden. Für die erfolgreiche Anbindung eines Produktdatenfeeds gibt es drei grundlegende Bedingungen:

  • der Produktdatenfeed muss ohne Einschränkungen oder Sperren online erreichbar sein
  • die Daten im Produktdatenfeed entsprechen dem CSV-Format. Andere Formate wie XML werden von sitepackage:// derzeit nicht unterstützt
  • die Datei muss Spaltenüberschriften enthalten

Zur Integration des Produktdatenfeeds muss ein neues Beitragsmuster mit dem Beitragstyp feed_product in die Newsletter-Vorlage eingefügt werden. Im nachfolgenden Beispiel wird die Ausgabe eines Produkts demonstriert.

Beispiel

<div sipa:type="feed_product" sipa:id="product" sipa:title="Produktdatenfeed" sipa:icon="image-text" sipa:url="http://www.domain.tld/produktdatenfeed.csv" sipa:delimiter="|" sipa:key="id" sipa:searchfields="titel" sipa:searchresult="%artikelnummer% - %titel%">
...
</div>

Im angeführten Beispiel werden sowohl die Standardattribute sipa:id, sipa:title und sipa:icon, als auch spezifische Attribute für die Konfiguration des Produktdatenfeeds verwendet. Diese werden nachfolgend erläutert:

AttributBeschreibung
sipa:url URL des Produktdatenfeeds
sipa:delimiter Im Produktdatenfeed verwendetes Spaltentrennzeichen
sipa:key Mit diesem Attribut muss ein Feld angegeben werden, mit dem das Produkt eindeutig identifiziert werden kann, wie z.B. die Artikelnummer oder die EAN.
sipa:searchfields Kommagetrennte Angabe von Feldern, die bei der Suche nach einem Produkt in sitepackage:// berücksichtigt werden sollen.
sipa:searchresult Mit diesem Attribut wird die Ausgabe des Suchergebnisses in sitepackage:// bestimmt. Im oben angeführten Beispiel wird die Artikelnummer und der Titel des Produkts ausgegeben. Die Feldnamen, welche mit den Spaltenüberschriften im Produktdatenfeed korrespondieren, müssen mit dem Platzhalterzeichen % umgeben sein.

Ausgabe der Produkte

Die Gestaltung der Ausgabe der Produkte orientiert sich an den Feldern zur Erfassung von Inhalten. Über das Attribut sipa:id wird ein Feld aus dem Produktdatenfeed bestimmt, das im Newsletter ausgegeben werden soll.

Beispiel

<p sipa:id="preis_1">00,00 €</p>

Die Angabe der Felder besteht aus der korrespondierenden Spaltenüberschrift des Produktdatenfeeds und einer anschließenden Nummerierung, getrennt durch einen Unterstrich und beginnend bei 1. Dadurch ist es möglich, in einem Beitragsmuster mehrere Produkte abzubilden. In dem oben angeführten Beispiel bezieht sich die Angabe der sipa:id auf den Preis des ersten Produkts, das über die sitepackage:// Benutzeroberfläche hinzugefügt wurde.

Ausgehend von der höchsten Nummerierung kann sitepackage:// erkennen, wie viele Produkte in dem Beitragsmuster hinzugefügt werden können.

Für den Fall, dass ein Wert aus dem Produktdatenfeed mehrmals im Beitragsmuster für ein Produkt verwendet werden soll, gibt es die Möglichkeit eine weitere Nummerierung als Suffix an die sipa:id anzuhängen:

Beispiel

<p><a href="#" sipa:id="link_1_1"><img src="bild.jpg" sipa:id="bild_1" /></p>
<p><a href="#" sipa:id="link_1_2">Zum Produkt</p>

Das Suffix ist notwendig, da der Wert in sipa:id immer eindeutig sein muss. Im angeführten Beispiel wird sowohl das Bild des Produkts als auch der Text unter dem Bild mit dem Produkt verlinkt.

Formatierung von Dezimalzahlen

Zumeist sind die Preise in einem Produktdatenfeed in der englischen Schreibweise mit einem Punkt statt eines Kommas als Dezimaltrennzeichen angegeben. Um die Preise entsprechend der deutschen Konvention zu formatieren, gibt es das Attribut sipa:number.

Beispiel

<p sipa:number="2|,|." sipa:id="preis_1">00,00 €</p>

Das Attribut erwartet drei Angaben, welche durch das Pipe-Zeichen (|) getrennt werden müssen:

  • Anzahl der Nachkommastellen
  • Trennzeichen der Zahl
  • Gruppierungszeichen für Tausenderstellen

Attribute zum Steuern der Bilddarstellung

Das Bild zu einem Produkt wird von sitepackage:// geladen und entsprechend der folgenden Angaben verändert.

AttributBeschreibung
sipa:width Gewünschte Breite des Bildes in Pixeln
sipa:height Gewünschte Höhe des Bildes in Pixeln
sipa:fill Beim Zuschneiden des Bildes auf das gewünschte Maß gehen keine Bildinformationen verloren. Der Rest wird mit Weiß aufgefüllt. Mögliche Werte sind 0 (kein Zuschnitt) und 1 (Zuschnitt).
sipa:crop Beim Zuschneiden des Bildes gehen Bildinformationen verloren. Es wird nicht mit Weiß gefüllt. Mögliche Werte sind 0 (kein Zuschnitt) und 1 (Zuschnitt).

Beispiel

<img src="bild.jpg" sipa:width="200" sipa:height="200" sipa:fill="1" sipa:id="bildlink_1" />

Produkte über die sitepackage:// Benutzeroberfläche hinzufügen

Ist der Produktdatenfeed erfolgreich an das Newsletter-System angebunden, kann der entsprechende Beitragstyp bei der Newsletter-Erstellung ausgewählt werden, um ihn mit Inhalten zu füllen. Die gewünschten Produkte können über das Suchfeld unter Eingabe des Produktnamens oder der Artikelnummer gefunden werden. Danach kann durch die Auswahl des Produkts und einen Klick auf die Schaltfläche Zuweisen das Produkt dem Beitrag hinzugefügt werden. Es erscheint nun in der Liste der zugewiesenen Produkte des Beitragstyps. Die Reihenfolge der Produkte kann per Drag & Drop verändert werden, über das rote Minus werden sie wieder aus der Liste entfernt.