Product Data Import -...

Product Data Import

Technische Dokumentation für Advertiser 05.12.2016

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 ______________________________________ 6 4.1 Kategorie ____________________________________________________________________ 6 4.2 PricePrefix und PriceSuffix _______________________________________________________ 6 4.3 Deeplinks ____________________________________________________________________ 6 4.4 ImageURL ____________________________________________________________________ 6 4.5 Grundpreis ___________________________________________________________________ 7 4.6 Title und Description_short ______________________________________________________ 7 4.7 Description ___________________________________________________________________ 7 4.8 Komprimierte (gezippte) Dateien __________________________________________________ 7

5. Änderungen am Dateiaufbau ______________________________________________ 8

6. Logos _________________________________________________________________ 8

7. Downloadzeiten und Intervalle _____________________________________________ 8

Product Data ImportProduct-Data Advertiser (de) INTERNATIONAL Seite 1

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 [email protected]. 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.

mailto:[email protected]


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 Einzigartige ID - z.B. Artikelnummer (möglichst

analog der Artikel-ID im Webshop)

String (50)

Category Produktkategorie-Pfad - z.B.:

Damen > Kleidung > Röcke

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)


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)

EfficiencyClass** Angabe der Energie-Effizienz-Klasse (z.B.

„A+++“, „B“, „C“,

String (6)

Availability Verfügbarkeit des Artikels String (50)

DeliveryTime Lieferzeit String (25)

ISBN Nur bei Büchern String (17)

Size Größe String (50)

Gender Geschlecht String (50)

Color Farbe String (50)

NutritionInformation 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: http://www.gesetze-im-internet.de/envkv/__3.html und http://www.ecommerce.jetzt/energieeffizienz-label-ab-2015-pflicht-im-onlineshop/

Zusätzlicher Datensatzaufbau für Mobilfunk-Advertiser

Spalte Erklärung Datentyp

phone_model Modell – z.B. „8800“ String (50)

phone_operator Netzbetreiber – Immer in diesem Format: „t-

mobile“ / “o2“ / „vodafone“ / „eplus“

String (50)

base_fee Grundgebühr – z.B. „19.90“ dezimal Punkt


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. „9.99“ dezimal Punkt

clockrate Taktung – z.B. 60/60 String (50)

charge_landline Minutenpreis ins Festnetz – z.B. „0.09“ dezimal Punkt

charge_other_networ

ks

Minutenpreis in Fremdnetze – z.B. „0.12“ dezimal Punkt

charge_own_network Minutenpreis ins gleiche Netz – z.B. „0.09“ dezimal Punkt

texts_charge Preis pro SMS – z.B. „0.15“ 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: http://www.ihre-url.de/produktdaten.csv.gz

Dies gilt ebenfalls, wenn die URL ein Script ist, welches die CSV-Datei erstellt. Beispiel: http://www.ihre-url.de/script.php?name=Filename.gz

• 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"|“http://www.ihre-url.de/bild.jpg“. 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.

http://www.ihre-url.de/produktdaten.csv.gz

http://www.ihre-url.de/bild.jpg

http://www.ihre-url.de/bild.jpg


• 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 : http://www.ihre-url.de/produktdaten.xml.gz

• Dies gilt ebenfalls, wenn die URL ein Script ist, welches die XML-Datei erstellt. Beispiel: http://www.ihre-url.de/script.php?name=Filename.gz

• 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>http://....</URL>

</Image>

<Deeplink>

<URL>http://....</URL>

</Deeplink>

...

sind nicht möglich.

• Das Dezimal-Trennzeichen darf nur Punkt (.) oder 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).

• 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: “19.99” 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 (http://www.ihre-url.de/handy_123.html).

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 (http://www.ihre-url.de/pics/handy123.jpg).

Bitte liefern Sie uns nur die URL des jeweils größten Bildes. Wir rechnen die Bilder auf Standard-größ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.

http://www.ihre-url.de/handy_123.html


Der Hosting-Server sollte unbedingt HTTPS Verschlüsselung unterstützen. So ist sichergestellt, dass Bild-Aufrufe, die durch Publisher auf HTTPS umgestellt werden kein „broken image“ zurück liefern. Im Idealfall stehen die Bilder generell HTTPS gehostet zur Verfügung.

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: http://www.ihre-url.de/produktdaten.csv.gz

Dies gilt ebenfalls, wenn die URL ein Script ist, welches die CSV-Datei erstellt. Beispiel: http://www.ihre-url.de/script.php?name=Filename.gz

http://www.ihre-url.de/script.php?name=Filename.gz


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.

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!

http://advertiser.affili.net/ProductData/Productfeedsettings.aspx?nr=1&pnp=60

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.

http://advertiser.affili.net/ProductData/Productfeedsettings.aspx?nr=1&pnp=60


8. Historie

• Datum • Art der Änderung • Änderung • Autor • Kommentar

• 27.03.2015 • NEU • Dokument konsolidiert und dem neuen Stand angepasst

• ST •

• 20.05.2015 • HINZUGEFÜGT • 4.4. letzten Absatz über https hinzugefügt

• •

• 05.12.2016 • GEÄNDERT • Schreibweise von EfficiencyClass**, DeliveryTime und NutritionInformation geändert

• ST •

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

Documents

Transcript of Product Data Import -...