Befüllhilfe CSV-Import (für Partner)

Diese Seite bietet dir eine umfassende Referenz für alle Spalten im Partner-Inserate-CSV-Format. Nutze diese Anleitung, um die Datentypen, Validierungsregeln und Beispiele für jedes Feld zu verstehen.

So funktioniert der CSV-Import

Das CSV-Import-System ermöglicht es dir, alle deine PianoHub-Inserate effizient über Tabellendateien zu verwalten:

  • Exportiere deine aktuellen PianoHub-Inserate als CSV-Datei, um den aktuellen Datenstand zu erhalten.
  • Bearbeite oder ergänze die CSV-Datei mit Änderungen, Aktualisierungen oder neuen Inseraten.
  • Wichtig: Alle bestehenden Inserate, die du behalten möchtest, müssen in der CSV enthalten bleiben. Fehlende Inserate werden vom Import-Tool als zum Löschen markiert betrachtet.
  • Um neue Inserate hinzuzufügen (z. B. per KI-Konvertierung), musst du deine Bestandsdaten mit den neuen Inseraten in einer einzigen CSV-Datei zusammenführen, bevor du importierst.

Schnellreferenz

Übersicht aller Spalten im CSV-Format:

CSV-Spaltenreferenztabelle mit Spaltennamen, Typen und Anforderungsstatus
Column NameTypeRequired
public_idreadonly
No
summarytext
Yes
instrument_typedropdown
Yes
brandtext
Yes
modeltext
No
pricenumber
Yes
currencydropdown
Yes
colordropdown
Yes
year_builtnumber
No
production_countrytext
No
serial_numbertext
No
heightnumber
No
widthnumber
No
depthnumber
No
weightnumber
No
conditiondropdown
Yes
descriptiondescription
Yes
emailtext
Yes
image_urlstext
No

Detaillierte Spaltenbeschreibungen

public_id - ID

Required: No | Type: Schreibgeschützte Kennung

Die ID des Inserats. Dieses Feld wird automatisch zugewiesen, wenn du ein Inserat erstellst und kann nicht geändert werden. Lass es bei neuen Inseraten leer.

Bei Änderungen an bestehenden Inseraten muss die CSV-Zeile die von PianoHub zuvor vergebene public_id enthalten. Inserate werden anhand dieser ID identifiziert, nicht anhand des Titels oder anderer Felder.

Example: 12345

summary - Titel

Required: Yes | Type: Text

Ein kurzer, beschreibender Titel für das Klavier. Dieser erscheint in den Suchergebnissen und sollte prägnant, aber informativ sein.

Example: Yamaha U1 Klavier Schwarz

Max length: 80 characters

instrument_type - Instrumententyp

Required: Yes | Type: Dropdown-Auswahl

Die Art des Instruments. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

  • UPRIGHT_PIANO - Klavier
  • GRAND_PIANO - Flügel
  • DIGITAL_PIANO - Digitalpiano
  • OTHER - Sonstiges

brand - Marke

Required: Yes | Type: Text

Hersteller- oder Markenname.

Wichtig: Falls du ein Klavier einer der unten aufgeführten, besonders beliebten Marken inserierst, verwende die hier dokumentierte Schreibweise. Abweichende Schreibweisen (z. B. "C. Bechstein" statt "Bechstein") führen dazu, dass Nutzer dein Inserat nicht finden, wenn sie auf PianoHub per Suchfunktion nach der Marke filtern.

  • Baldwin
  • Bechstein
  • Blüthner
  • Bösendorfer
  • Boston
  • Essex
  • Fazioli
  • Feurich
  • August Förster
  • Grotrian-Steinweg
  • Haessler
  • W. Hoffmann
  • Ibach
  • Irmler
  • Kawai
  • Mason & Hamlin
  • Petrof
  • Pfeiffer
  • Samick
  • Sauter
  • Schimmel
  • Seiler
  • Steingraeber & Söhne
  • Steinway & Sons
  • Yamaha
  • Zimmermann

Example: Yamaha

Max length: 30 characters

model - Modell

Required: No | Type: Text

Modellbezeichnung oder -name. Optionales Feld.

Example: U1

Max length: 30 characters

price - Preis

Required: Yes | Type: Zahl

Preis ohne Währungssymbol. Gib nur die Zahl ein.

Example: 3500

Min: 0.01

currency - Währung

Required: Yes | Type: Dropdown-Auswahl

Währungscode. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

  • CHF
  • EUR
  • GBP
  • USD

color - Farbe

Required: Yes | Type: Dropdown-Auswahl

Hauptfarbe des Instruments. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

  • BLACK - Schwarz
  • WHITE - Weiß
  • WOOD - Holz
  • OTHER - Andere Farbe

year_built - Baujahr

Required: No | Type: Zahl

Herstellungsjahr. Optionales Feld.

Example: 2005

Min: 1800 | Max: 2026

production_country - Herstellungsland

Required: No | Type: Text

Land, in dem das Instrument hergestellt wurde. Optionales Feld.

Example: Japan

Max length: 30 characters

serial_number - Seriennummer

Required: No | Type: Text

Seriennummer des Herstellers. Optionales Feld.

Example: 5678901

Max length: 15 characters

height - Höhe

Required: No | Type: Zahl (in cm)

Höhe des Instruments in Zentimetern. Optionales Feld.

Example: 121

Min: 1

width - Breite

Required: No | Type: Zahl (in cm)

Breite des Instruments in Zentimetern. Optionales Feld.

Example: 153

Min: 1

depth - Tiefe

Required: No | Type: Zahl (in cm)

Tiefe des Instruments in Zentimetern. Optionales Feld.

Example: 65

Min: 1

weight - Gewicht

Required: No | Type: Zahl (in kg)

Gewicht des Instruments in Kilogramm. Optionales Feld.

Example: 230

Min: 1

condition - Zustand

Required: Yes | Type: Dropdown-Auswahl

Zustand des Instruments. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

  • NEW - Neues Instrument
  • USED - Gebrauchtes Instrument

description - Beschreibung

Required: Yes | Type: Text

Detaillierte Beschreibung des Instruments. Füge wichtige Details, Zustandshinweise und besondere Merkmale hinzu.

Example: Gut gepflegtes Yamaha U1 in ausgezeichnetem Zustand. Regelmäßige Wartung, neue Saiten 2020 eingebaut.

Max length: 4000 characters

email - E-Mail

Required: Yes | Type: E-Mail-Adresse

Kontakt-E-Mail für Anfragen zu diesem Inserat. Diese kann sich von deiner Partner-Konto-E-Mail unterscheiden.

Example: partner@example.com

Max length: 255 characters

image_urls - Bild-URLs

Required: No | Type: Kommagetrennte URLs

URLs zu Bildern des Instruments. Trenne mehrere URLs mit Kommas. Alle Bilder müssen öffentlich zugänglich sein. Optionales Feld.

Bilder von deiner eigenen Website wiederverwenden:

Wenn du bereits Inserate auf deiner eigenen Website hast und diese zusätzlich auf PianoHub schalten möchtest, kannst du die Bild-URLs deiner Website direkt verwenden. So musst du Bilder nicht doppelt hochladen oder speichern.

Tipp: Klicke mit der rechten Maustaste auf ein Bild in deinem Browser und wähle "Bildadresse kopieren", um die URL zu erhalten.

Example: https://example.com/img1.jpg,https://example.com/img2.jpg

KontaktNutzungsbedingungenDatenschutzImpressum