affilinet Product Data Import

Transkript

1 04 / 2015

2 affilinet Product Data Import Inhaltsverzeichnis Einleitung 1 1. Datensatzaufbau für Produktlisten 2 Datensatzaufbau für Nicht-Mobilfunk-Advertiser: 2 Zusätzlicher Datensatzaufbau für Mobilfunk-Advertiser 3 2. Allgemeine Infos zum Dateiaufbau von CSV-Files 4 3. Allgemeine Infos zum Dateiaufbau von XML-Files 5 4. Besonderheiten bei einzelnen Feldern Kategorie PricePrefix und PriceSuffix Deeplinks ImageURL Grundpreis Title und Description_short Description Komprimierte (gezippte) Dateien 7 5. Änderungen am Dateiaufbau 7 6. Logos 8 7. Downloadzeiten und Intervalle 8

3 Einleitung Produktdaten stellen eine attraktive Werbemöglichkeit zusätzlich zu klassischen Bannern dar. Vorteile sind u.a. höhere Benutzerakzeptanz, größere Publisher-Reichweite und weniger Benutzerabbrüche durch klare Führung des Webseitenbesuchers. Produktdaten werden regelmäßig von einer Quell-URL des Advertisers in die affilinet-datenbank importiert und den Publishern in Form einer CSV- bzw. XML-Datei sowie über den affilinet Produktdaten-Webservice zur Verfügung gestellt. Sie können Ihre Produktdaten in einem oder mehreren Feeds einreichen, wir stellen diese Feeds dann Ihren Publishern getrennt voneinander zur Verfügung. Jeder dieser Feeds sollte nach Möglichkeit maximal 1 Mio. Produkte enthalten. Für jeden Ihrer Feeds brauchen wir folgende Informationen: URL: unter dieser URL holen wir die Datei ab. (http, https, ftp, sftp) Intervall: jeden 2. Tag, 1x täglich, mehrmals täglich (z.b. 4 Uhr, 17 Uhr), 1x stündlich Format: CSV, XML, TXT Username / Passwort: falls für den Abruf Ihrer Datei nötig. Sicherheit: Sollten Sie Blacklists für Ihre Systeme führen, teilen Sie uns dies bitte mit. Übermitteln Sie uns diese Daten unter produktdaten@affili.net. Des Weiteren ist es hilfreich, wenn Sie uns einen Beispiel-Datenfeed zur Verfügung stellen. Wir adaptieren unser System dann für Ihr Datei-Format. In unserer Produkt-Datenbank gibt es sowohl Pflicht- als auch optionale Datenfelder. Egal ob Sie uns Ihre Datensätze im CSV- oder im XML-Format zur Verfügung stellen - es muss in jedem Fall sichergestellt sein, dass zumindest die Pflichtfelder bei allen Ihren Datensätzen gefüllt sind. Andernfalls können wir Ihre Daten nicht importieren. Die Datenfelder sind im Folgenden beschrieben. Product Data Import Seite 1

4 1. Datensatzaufbau für Produktlisten Für einen korrekten Import muss der Aufbau wie hier beschrieben erfolgen. Bitte beachten Sie, dass für Advertiser aus dem Mobilfunk-Bereich andere Pflichtfelder gelten als für die anderen Bereiche. Gerne können Sie uns weitere Felder, die im Folgenden nicht aufgelistet sind, übergeben. Diese werden jedoch nicht als standardisierte Felder ausgegeben, sondern wie von Ihnen benannt weitergereicht. Datensatzaufbau für Nicht-Mobilfunk-Advertiser: Spalte Erklärung Datentyp ArtNumber Category Einzigartige ID - z.b. Artikelnummer (möglichst analog der Artikel-ID im Webshop) Produktkategorie-Pfad - z.b.: Damen > Kleidung > Röcke String (50) String (250) Title Produktbezeichnung String (250) DescriptionShort Produktbeschreibung (kurz) String (500) Description Produktbeschreibung String (4500) PricePrefix Text, der dem Preis vorangestellt sein muss String (25) Price Preis inkl. MwSt. dezimal Punkt PriceSuffix Dem Feld Price nachgestellter Text String (50) PriceOld Alter Preis bzw. UVP inkl. MwSt. dezimal Punkt Currency Währung z.b. EUR, GBP, CHF; wird für den Produktpreis und die Versandkosten verwendet, sowie für den Grundpreis, falls vorhanden. String (3) (ISO 4217) ImgUrl Link zum Produktbild (absolut http(s)://...) String (200) Deeplink1 Deeplink zum Produkt (absolut http(s)://...) String (1500) Deeplink2 Zusatz-Deeplink (absolut http(s)://...) String (1500) Keywords Suchbegriffe, die für das Produkt relevant sind String (250) Manufacturer Nestlé String (100) Brand Nespresso String (100) Distributor Distributor - z.b. bei Büchern oder DVDs String (100) Product Data Import Seite 2

5 ValidFrom Angebot gültig von jjjj-mm-ttthh:mm:ss ValidTo Angebot gültig bis jjjj-mm-ttthh:mm:ss EAN 13- oder 14-stellige EAN-Nummer des Produkts String (14) ShippingPrefix Dem Feld Shipping vorangestellter Text String (25) Shipping Versandkosten dezimal Punkt ShippingSuffix Dem Feld Shipping nachgestellter Text String (50) BasePricePrefix Dem BasePrice vorangestellter Text String (25) BasePrice * Preis pro Einheit (wenn gesetzlich vorgeschrieben) dezimal Punkt BasePriceSuffix Definition der Einheit z.b. pro 100ml String (50) Efficiency-Class** Angabe der Energie-Effizienz-Klasse (z.b. A+++, B, C, String (6) Availability Verfügbarkeit des Artikels String (50) Delivery time Lieferzeit String (25) ISBN Nur bei Büchern String (17) Size Größe String (50) Gender Geschlecht String (50) Color Farbe String (50) Nutrition_Information Nährwertangaben String (200) Die fett gedruckten Felder sind Pflichtfelder. * Pflichtfeld bei Produkten nach gesetzlicher Vorgabe (Grundpreis) ** Pflichtfeld bei Produkten die der gesetzlichen Kennzeichnungspflicht unterliegen. Weitere Informationen unter: 3.html und Zusätzlicher Datensatzaufbau für Mobilfunk-Advertiser Spalte Erklärung Datentyp phone_model Modell z.b String (50) phone_operator Netzbetreiber Immer in diesem Format: tmobile / o2 / vodafone / eplus String (50) base_fee Grundgebühr z.b dezimal Punkt Product Data Import Seite 3

6 free_minutes Frei-Minuten/Monat - z.b. 100 dezimal Punkt free_texts Frei-SMS/Monat - z.b. 20 dezimal Punkt contract_obligation Vertragsbindung yes bzw. no String (50) number_portability Rufnummernmitnahme yes bzw. no String (50) contract_duration Vertragslaufzeit (in Monaten, z.b. 12 ) dezimal Punkt starting_balance Startguthaben z.b dezimal Punkt clockrate Taktung z.b. 60/60 String (50) charge_landline Minutenpreis ins Festnetz z.b dezimal Punkt charge_other_networ ks Minutenpreis in Fremdnetze z.b dezimal Punkt charge_own_network Minutenpreis ins gleiche Netz z.b dezimal Punkt texts_charge Preis pro SMS z.b dezimal Punkt commission Anzahlung für das Gerät dezimal Punkt service_fee Bereitstellungspreis dezimal Punkt Die fett gedruckten Felder sind Pflichtfelder. 2. Allgemeine Infos zum Dateiaufbau von CSV-Files Importformat ist CSV bzw. TXT (kein Excel) Dateien komprimiert zu übermitteln (.gz/.zip) ist möglich und erwünscht. Hierzu muss die URL auf.gz oder.zip enden. Beispiel: Dies gilt ebenfalls, wenn die URL ein Script ist, welches die CSV-Datei erstellt. Beispiel: Zip-Files dürfen nur ein (1) File, und keine Unterordner enthalten. Die erste Zeile muss eine Satzbeschreibung der Spalten enthalten. Jede Zeile muss gleich viele Spalten enthalten. Jeder Datensatz muss in einer (1) Zeile übermittelt werden. Gültige Feld-Trennzeichen sind Semikolon, Tabulator, Komma, Pipe ( ) oder Carret (^), $ und sharp (#). Alle String-Felder müssen mit Text-Begrenzern versehen werden (z.b. " oder '). Idealerweise sollten prinzipiell alle Felder (also auch Dezimal-Felder) mit Text-Begrenzern versehen sein. Zwischen den Text-Begrenzern müssen Feld-Trennzeichen stehen. Beispiel (Text-Begrenzer " und Feld-Trennzeichen ): "0/8/15" "Ein großes, schönes Produkt" "12.00" Der Verwendete Feld-Trenner darf nicht im Inhalt vorkommen bzw. muss maskiert werden. (Empfohlene Trenner: Pipe ( ), Tabulator oder Carret (^)) Das Dezimal-Trennzeichen darf nur Punkt (.) oder Komma (,) sein. Product Data Import Seite 4

7 Wird das Komma als Dezimal-Trennzeichen gewählt, darf das Feld-Trennzeichen kein Komma sein. Die Zahlen (>1000) dürfen keine 1000er-Trennzeichen enthalten. Wenn in Betragsfeldern andere Zeichen als Zahlen oder Komma (,), Punkt (.), Minus (-) oder Plus (+) enthalten sind, dann werden diese Zeichen ignoriert (z.b.: EUR11 = 11 oder 11,- = 11). 3. Allgemeine Infos zum Dateiaufbau von XML-Files Importformat ist XML (d.h. die Datei muss auf.xml oder.xml enden) Dateien komprimiert zu übermitteln (.gz/.zip) ist möglich und erwünscht. Hierzu muss die URL auf.gz oder.zip enden. Beispiel : Dies gilt ebenfalls, wenn die URL ein Script ist, welches die XML-Datei erstellt. Beispiel: Zip-Files dürfen nur ein (1) File enthalten und keine Unterordner enthalten. Wenn Sie bereits für andere Netzwerke einen XML-Feed bereitstellen, können Sie in der Regel das identische File auch für den affilinet-feed verwenden. Das XML muss so strukturiert sein, dass alle Informationen zu einem Produkt in einem Element enthalten sind. Beispiel: <Product> <ArticleNumber>0000</ArticleNumber> <Title>Produktname</Title> <Price>123,45</Price>... </Product> <Product>... So nicht: <Prices> <Product id=0000>123,45</product> <Product id=0001>98,76</product>... </Prices> <Titles> <Product id=0000>produktname 1</Product>... Der gleiche Tag-Name darf nicht für unterschiedliche Zwecke verwendet werden. D.h. Konstrukte wie <Product> <Image> <URL> </Image> <Deeplink> <URL> </Deeplink>... sind nicht möglich. Das Dezimal-Trennzeichen darf nur Punkt (.) oder Komma (,) sein. Product Data Import Seite 5

8 Die Zahlen (>1000) dürfen keine 1000er-Trennzeichen enthalten. Wenn in Betragsfeldern andere Zeichen als Zahlen oder Komma (,), Punkt (.), Minus (-) oder Plus (+) enthalten sind, dann werden diese Zeichen ignoriert (z.b.: EUR11 = 11 oder 11,- = 11). Produkt-Eigenschaften können entweder in Form von Tags (z.b. <ProductName>Nokia 8880</ProductName>) oder in Form von Properties (z.b: <Product name= Nokia 8880 >) angegeben werden. XML-Feeds müssen mindestens zwei (2) Produkte enthalten. (Variablenerkennung) 4. Besonderheiten bei einzelnen Feldern 4.1 Kategorie Wenn eine mehrstufige Kategorie vorliegt, dann muss das Trennzeichen zwischen den Kategorie-Stufen mitgeteilt werden (z.b.: HauptKat > UnterKat > DetailKat. Kategory-Trennzeichen > (größer)). Wenn in den Datensätzen mehrere Kategorie-Stufen in weitere Spalten übergeben werden, dann muss die Reihenfolge wie in diesem Beispiel vorliegen: HauptKat; UnterKat; DetailKat; (hier mit Feld- Trennzeichen ; (Semikolon)). 4.2 PricePrefix und PriceSuffix Wenn aus rechtlichen Gründen bestimmte Zusätze am Preis erscheinen müssen, können Sie uns diese hier anliefern. Beispiel: PricePrefix: ab Price: PriceSuffix: inkl. MwSt Wir stellen den Partnern neben dem Feld Price auch das Feld DisplayPrice zur Verfügung, welches zur Anzeige auf der Partner-Webseite zu verwenden ist und die von Ihnen benötigte Formatierung enthält. Der DisplayPrice wird zusammengesetzt aus den Spalten PricePrefix, Price, PriceSuffix und Currency Symbol. 4.3 Deeplinks Alle Links müssen absolut sein ( Bitte beachten Sie, dass Sie hier auch alle notwendigen Kampagnen-Parameter ihres Systems mit berücksichtigen. Z.B. &network=affilinet, etc. Der Aufbau der Deeplinks muss der üblichen Syntax ihrer Deeplinks bei affilinet entsprechen. Sollten die Parameter bereits global in unserem Parameter-Forwarding bzw im Tracking-Duplexer hinterlegt sein, dürfen diese jedoch nicht mehr in den Deeplinks integriert sein. Bitte erfragen Sie die aktuellen Programmeinstellungen bei ihrem Account-Manager. 4.4 ImageURL Alle URLs müssen absolut sein ( Bitte liefern Sie uns nur die URL des jeweils größten Bildes. Wir rechnen die Bilder auf Standardgrößen um und hosten diese auf unseren Servern. Zusätzlich zu unseren Standardgrößen stellen wir Ihren Partnern natürlich auch Ihren Originallink zur Verfügung. Product Data Import Seite 6

9 4.5 Grundpreis Beispiel: UnitPricePrefix: entspricht UnitPrice: 5.99 UnitPriceSuffix: pro 100 ml Alle Waren, die in Fertigverpackungen, offenen Verpackungen, Verkaufseinheiten ohne Umhüllungen, nach Gewicht, Volumen, Länge oder Fläche Letztverbrauchern angeboten werden (unabhängig ob offline oder online), sind gemäß 2 Abs. 1 PAngV mit sog. "Grundpreisen" zu versehen. Die Verpflichtung zur Angabe von Grundpreisen folgt direkt aus der PreisAngV, die der deutsche Gesetzgeber aufgrund der Richtlinie 98/6/EG des Europäischen Parlaments vom 16. Februar 1998 über den Schutz der Verbraucher bei der Angabe der Preise von angebotenen Erzeugnisse erheblich anpassen musste. Die letzte Änderung der PreisAngV ist zum 29. Juli 2009 verkündet worden und trat zum 11. Juni 2010 in Kraft (im Fokus dieser Änderung stand die Werbung für Kreditverträge). Die Mengeneinheit für den Grundpreis ist gemäß 2 Abs. 3 PAngV ein Kilogramm, ein Liter, ein Kubikmeter, ein Meter oder ein Quadratmeter. Bei Waren, deren Nenngewicht oder Nennvolumen üblicherweise 200 Gramm oder Milliliter nicht übersteigt, dürfen als Mengeneinheit für den Grundpreis 100 Gramm oder Milliliter verwendet werden. Bei nach Gewicht oder Volumen angebotener loser Ware ist als Mengeneinheit für den Grundpreis entsprechend der allgemeinen Verkehrsauffassung entweder ein Kilogramm oder 100 Gramm oder ein Liter oder 100 Milliliter zu verwenden. Schließlich ist bei Waren, die üblicherweise in Mengen von 100 Litern und mehr, 50 Kilogramm oder mehr oder 100 Meter oder mehr abgegeben werden, für den Grundpreis die Mengeneinheit zu verwenden, die der allgemeinen Verkehrsauffassung entspricht. 4.6 Title und Description_short Diese Felder dürfen keine HTML-Tags enthalten (außer <br> bzw. <br/>). 4.7 Description Falls in diesem Feld schon HTML-Code enthalten ist, der mit HREF verzweigen könnte, dann müssen auch das absolute Links sein. Weiterhin sollten diese Links auch ein target=_blank enthalten. 4.8 Komprimierte (gezippte) Dateien Die Produktdatendatei sollte idealerweise in gepackter Form bereitgestellt werden. Hierzu muss die URL auf.gz oder.zip enden. Beispiel: Dies gilt ebenfalls, wenn die URL ein Script ist, welches die CSV-Datei erstellt. Beispiel: 5. Änderungen am Dateiaufbau Bei Änderungen des Dateiaufbaus sind diese affilinet unaufgefordert in Form einer Beispieldatei mitzuteilen, und zwar bevor diese Änderungen zum Download unter der angegebenen URL zur Verfügung stehen. Grundsätzliche Änderungen (insbesondere die Spaltenreihenfolge bei CSV) sind nach Möglichkeit zu vermeiden. Product Data Import Seite 7

10 Achten Sie bei der Ergänzung zusätzlicher Spalten im CSV-Format bitte darauf, diese nur am Zeilenende anzufügen. Bitte informieren Sie uns über die Änderung, damit wir diese in unser System übernehmen können. Änderungen an Produktdaten stehen erst nach Bearbeitung und Bestätigung durch affilinet den Publishern zur Verfügung. Denken Sie bitte daran, dass affilinet Änderungen manuell nachziehen muss und planen Sie hierfür entsprechende Vorlaufzeiten ein. Sollte eine unangemeldete Änderung des Dateiaufbaus dazu führen, dass einige oder alle Produktdaten bei einem Update (automatisch oder manuell auf Anfrage durch den Advertiser) nicht korrekt eingelesen werden können, so müssen u. U. sämtliche Produktdaten des Advertisers deaktiviert werden und stehen den Partnern somit nicht mehr zur Verfügung. 6. Logos Logos müssen im Advertiser-Interface direkt hochgeladen werden. In den Details des Feeds, unter Produktlisten-Einstellungen, können Sie diese in verschiedenen Größen anlegen. Bitte beachten Sie, dass Logos Pflichtangaben sind! 7. Downloadzeiten und Intervalle Um eine größtmögliche Datenaktualität zu erreichen, achten Sie bitte darauf, dass der Zeitpunkt für den Download des Feeds in das affilinet-system, nach der aktuellen Bereitstellung der Daten auf ihrem System stattfindet. Damit ist sichergestellt, dass die Daten, die wir herunter laden immer dem aktuellen Stand entsprechen. Das Intervall können Sie ebenfalls definieren. Beispielsweise: jeden 2. Tag, 1x täglich, mehrmals täglich (z.b. 4 Uhr, 17 Uhr), 1x stündlich Prüfen Sie hier bitte genau, welche Turnusse notwendig sind, da der Traffic nicht unerheblich sein kann. Product Data Import Seite 8

11 Änderungshistorie: Datum Art der Änderung Änderung Autor Kommentar NEU Dokument ST konsolidiert und dem neuen Stand angepasst Erklärung Änderungshistorie: Datum: Datum der Änderung im Dokument Art der Änderung: Kann neu, hinzugefügt, geändert oder gelöscht sein Änderung: Seitennummer, Kapitel oder Zeile angeben, je nach Notwendigkeit Author: Namenskürzel der ändernden Person Kommentar: Wenn notwendig, bitte hier Kommentare oder weiterführende Infos hinterlegen Product Data Import Seite 9