CSV-Import

Was ist der CSV-Import?

Mit Hilfe des CSV-Imports können Anbieter in einem Schritt bis zu 1000 Songs per CSV-Datei-Upload registrieren. In einer speziell formatierten csv-Datei müssen alle Daten angegeben werden die auch sonst bei der Registrierung angegeben werden müssen. Das Erstellen einer solchen CSV-Datei kann mit Excel oder einem Text-Editor geschehen.

Beispieldateien:

Hier können sie sich die Beispiel-CSV-Dateien für Musik bzw. für Texte herunterladen
(Mit rechter Maustaste anklicken und "...speichern unter" auswählen):

Musik CSV Import
Musik CSV Import mit Album
Text CSV Import
Picture CSV Import
Video CSV Import

Nutzung

Öffnen sie die jeweilige Beispieldatei. Darin befindet sich in der ersten Zeile die Kopfzeile. Diese Kopfzeile muss auch beim Import erhalten bleiben! In den nachfolgenden Zeile befinden sich Beispiele. Diese Beispiele sollen nur verdeutlichen wie die Daten eingegeben werden müssen. Entfernen sie bitte die Beispiele bzw. überschreiben sie sie wenn sie ihre Daten eingeben.

Mit dem Feld UserNumber ist die die Nutzernummer des jeweiligen Künstleraccounts gemeint worin das File registriert werden soll!

Jede weitere Zeile stellt eine neu zu registriende Datei dar.

Speichern sie die so erzeugte Datei bitte unbedingt als "csv-Datei" ab!

Nachdem sie alle Daten eingegeben haben, loggen sie sich in ihren Account ein und klicken sie in der linken Navigationsleiste auf CSV-Import.

Geben Sie in der daraufhin erscheinenden Oberfläche ihr zu importierende Datei an und bestätigen sie den Import mit ihrem Passwort. Die Datei wird daraufhin kurz überprüft und demnächst abgearbeitet. Das Ergebnis des Imports (Erfolgsmeldungen bzw. Fehlermeldungen) bekommen sie per E-Mail zugeschickt (an die E-Mail-Adresse die bei der Registrierung bzw. unter Benutzerdaten angegeben wurde).

Der Import kann je nach Umfang der Datei eine gewisse Zeit in Anspruch nehmen (ca. 15 Minuten).

File URL bei PotatoSystem Webspace

Wenn Sie ihre Dateien auf dem PotatoSystem-Webspace upgeloaded haben dann ist die URL welche sie in das CSV-File eintragen müssen folgende:
http://customerspace.potatosystem.com/up/[LOGIN]/file/[FILE_NAME]
Für Preview-Dateien:
http://customerspace.potatosystem.com/up/[LOGIN]/preview/[FILE_NAME]
Und für Covers:
http://customerspace.potatosystem.com/up/[LOGIN]/pic/[FILE_NAME]

Bitte beachten sie dass das System die Dateinamen umbenennt falls darin nicht erlaubte Zeichen wie z.B. Leerzeichen oder Umlaute enthalten sind. Die Filenamen können also von ihren Filenamen welche sie hochgeladen haben abweichen.

Preview-/Vorhördatei automatisch erstellen lassen

Diese Option steht ihnen nur zur Verfügung wenn der Song selbst eine MP3-Datei ist. Möchten sie die Option nutzen, so lassen sie bitte das preview url-Feld leer. Gegen Sie dann im Feld previewStart bitte die Startsekunde an ab der das Preview starten soll. Die Gesamtzeit des Previews beträgt 45 Sekunden. Die Previews werden nach dem erfolgreichen Import erst erstellt und stehen nach kurzer Zeit danach zur Verfügung.

Datei von GEMA Abgaben ausschließen

Ist ihr Künstler ein GEMA-Mitglied so werden alle registrierten Musikstücke mit der GEMA abgerechnet. Sollte der Nutzer aber auch Dateien haben welche nicht mit der GEMA verrechnet werden sollen so teilen sie das in der Spalte "notGEMA" mit. Schreiben sie einfach in das Feld "true" rein. Die Downloads der Datei werden dann nicht zur GEMA gemeldet!

Andere Währungen

Neben den price-Feld welches den Eurocentbetrag enthält, gibt es auch noch andere Währungsfelder wo man den Preis der Datei in den Währungen CHF, GBP, CAD, AUD, JPY und USD definieren kann (ab Label-Account). Auch hier sind Centbeträge einzugeben. JPY Beträge müssen immer mit 00 enden da krumme Yen-Beträge nicht gestattet sind. Die Angabe dieser zusätzlichen Währungen ist rein optional. Wird eine Währung nicht definiert so wird die entsprechende Währung notfalls von uns automatisch umgerechnet sollte der Warenkorb in einer anderen Währung sein. Das definieren von zusätzlichen Währungen ist jederzeit per Weboberfläche bzw. Webservice möglich. Da Basic Nutzer nur den Europreis definieren können (andere Währungen werden automatisch umgerechnet) werden die Angaben in der CSV-Datei ignoriert sollten dort andere Währungen definiert sein. Als Beispiel sei hier auf die obigen CSV-Beispieldateien verwiesen.

(Musik-)Album registrieren

Alle Musik-Dateien, die in einem CSV-Import registriert werden, können auch zu einem Album hinzugefügt werden. Fügen Sie einfach eine weitere Zeile in die CSV ein. Statt der URL schreiben Sie in die erste Spalte das Wort "album". Alle Titel, die in den Zeilen darüber stehen, werden einem neuen Album hinzugefügt. Tritt beim Import ein Fehler auf, werden weder die Dateien noch das Album registriert. Sie können nur ein Album per CSV registrieren. Alle Zeilen unter der Album-Zeile werden ignoriert.

Beschreibung der Spalten im einzelnen

Musik
Spaltenname Beschreibung
url Link zur eigentlichen Datei
preview url Link zur Vorhördatei
cover url Link zum Cover (150x150 Pixel wird empfohlen)
bundle darf die Datei Bestandteil eines Albums sein (empfohlen true)
single darf die Datei außerhalb eines Albums verkauft werden (empfohlen true)
usernumber PotatoSystem Nutzernummer des Künstler-Accounts in welchen das File registriert werden soll
price Preis in Eurocent
description Beschreibungstext der Datei
title Titel des Songs
album title wenn Song in einen Album ist dann Titel von dem Album
date Zeitangabe der Veröffentlichung
performer Künstler-/Bandname
minutes Dauer des Stückes (Minutenteil)
seconds Dauer des Stückes (Sekundenteil)
genre Genre (gültige Angaben siehe weiter unten)
bitrate Bitrate der Datei
channels Kanäle (Standard: STEREO)
origin gültige Werte siehe unten (Standard: STUDIO)
taken from gültige Werte siehe unten (Standard: CD)
text author Textautor des Songs
arranger Arrangeur
publisher Herrausgeber
record company Aufnahmefirma
label Label
labelcode Label Code
buyerCollection kann das File in einen von dem Käufer generierten Bundle aufgenommen werden (empfohlen true)
isrc ISRC
AUD - USD Centbetrag in den entsprechenden Währungen

notGEMA wenn Künstler ein GEMA-Mitglied ist aber dieses File von dem Künstler nicht mit der GEMA abgerechnet wird dann muss hier true stehen
grid GRid (siehe unten)
previewStart Zeitpunkt in Sekunden ab da ein 45 Sekunden Preview herausgeschnitten wird (empfohlen ab 45. Sekunden)
Musik-Album (gilt nur für die letzte Zeile der CSV-Datei)
Spaltenname Beschreibung
url Hier das Wort "album" eintragen
cover url Link zum Cover (150x150 Pixel wird empfohlen)
price Album-Preis in Eurocent
description Beschreibungstext des Albums
title Titel des Albums
date Zeitangabe der Veröffentlichung
performer Künstler-/Bandname
genre Genre (gültige Angaben siehe weiter unten)
arranger Arrangeur
publisher Herrausgeber
record company Aufnahmefirma
label Label
labelcode Label Code
AUD - USD Centbetrag in den entsprechenden Währungen
albumEAN die EAN des Albums
Bild
Spaltenname Beschreibung
url Link zur eigentlichen Datei
preview url Link zur Vorhördatei
cover url Link zum Cover (150x150 Pixel wird empfohlen)
bundle darf die Datei Bestandteil eines Albums sein (empfohlen true)
single darf die Datei außerhalb eines Albums verkauft werden (empfohlen true)
usernumber PotatoSystem Nutzernummer des Künstler-Accounts in welchen das File registriert werden soll
price Preis in Eurocent
description Beschreibungstext der Datei
title Titel des Songs
album title wenn Song in einen Album ist dann Titel von dem Album
date Zeitangabe der Veröffentlichung
artist Künstlername
genre gültige Werte siehe unten
heigth Höhe des Bildes in Pixel
width Breite des Bildes in Pixel
publisher Herrausgeber
buyerCollection kann das File in einen von dem Käufer generierten Bundle aufgenommen werden (empfohlen true)
AUD - USD Centbetrag in den entsprechenden Währungen
Text
Spaltenname Beschreibung
url Link zur eigentlichen Datei
preview url Link zur Vorhördatei
cover url Link zum Cover (150x150 Pixel wird empfohlen)
bundle darf die Datei Bestandteil eines Albums sein (empfohlen true)
single darf die Datei außerhalb eines Albums verkauft werden (empfohlen true)
usernumber PotatoSystem Nutzernummer des Künstler-Accounts in welchen das File registriert werden soll
price Preis in Eurocent
description Beschreibungstext der Datei
title Titel des Songs
album title wenn Song in einen Album ist dann Titel von dem Album
date Zeitangabe der Veröffentlichung
author Autor
genre gültige Werte siehe unten
language Sprache des Textes
id name Name eines anzugebenen ID Systems z.B. ISBN bei Büchern
id value ID des Textes (z.B. wenn ISBN 12345 ist dann hier 12345 eingeben)
origin
publisher Herrausgeber
buyerCollection kann das File in einen von dem Käufer generierten Bundle aufgenommen werden (empfohlen true)
AUD - USD Centbetrag in den entsprechenden Währungen
Video
Spaltenname Beschreibung
url Link zur eigentlichen Datei
preview url Link zur Vorhördatei
cover url Link zum Cover (150x150 Pixel wird empfohlen)
bundle darf die Datei Bestandteil eines Albums sein (empfohlen true)
single darf die Datei außerhalb eines Albums verkauft werden (empfohlen true)
usernumber PotatoSystem Nutzernummer des Künstler-Accounts in welchen das File registriert werden soll
price Preis in Eurocent
description Beschreibungstext der Datei
title Titel des Songs
album title wenn Song in einen Album ist dann Titel von dem Album
date Zeitangabe der Veröffentlichung
director Regie
genre Genre des Films (gültige Werte siehe unten)
actors Schauspieler
duration Dauer in Minuten
bitrate Bitrate des Videos
buyerCollection kann das File in einen von dem Käufer generierten Bundle aufgenommen werden (empfohlen true)
channel gültige Werte siehe unten
codec mit welchem Codec wurde das Video encoded (z.B. MPEG-2 oder H.264)
cut Schnitt
language Sprache
pictureFormat Bildformat z.B. 4:3 oder 16:9
producer Produzent
ratingName Name der Rating ID z.B. FSK
ratingValue Rating ID (z.B. wenn Film Rating FSK 16 hat dann hier 16 eingeben)
recordCompany Aufnahmefirma
resolution Auflösung des Videos z.B. 1920x1080 (für Full HD)
script Drehbuch
studio Studio
AUD - USD Centbetrag in den entsprechenden Währungen

Erlaubte Eingabewerte

Bei manchen Felder sind, wie bei der Registrierungsoberfläche auch, nur bestimmte Werte erlaubt. Hier finden sie alle erlaubten Werte bei diesen speziellen Feldern. Die erlaubten Zeichen in anderen Feldern sind genau die gleichen wie bei der Registrierung per Web-Oberfläche bzw. wie bei der Registrierung per Web-Service.

Musikgenreliste

POPULAR
A CAPPELLA
AFRICA/AFROBEAT
ALTERNATIVE/PUNK
ASIAN
BLUES
CHANSON
CHILLOUT
CLASSIC
COUNTRY
DANCE
DIXILAND
DRUM`N BASS
EUROPEAN FOLK
EXPERIMENTAL
FUNK
GOSPEL
HIPHOP/RAP
HOUSE/TECHNO/ELEKTRONIK
INDIE
JAZZ
LATIN
MEDLEY
MUSICAL
ROCK/HARDROCK/METAL
SAMPLES
SKA/REGGAE/DANCEHALL
SOUL/BLACK/R`N`B
SOUNDTRACK
SWING
TEXT
TRANCE
WAVE/DARK/GOTHIC
WORLD MUSIC

Textgenreliste

FICTION
BIOGRAPHIES
BUSINESS/MONEY
CHILDREN´S BOOKS
COMICS
COMPUTER/INTERNET
COOKING
ENTERTAINMENT
EROTIC
FANTASY
GUIDEBOOK
HISTORY
HORROR
LIFESTYLE
LYRIC
MANUAL
REFERENCE/LEARNING
RELIGION
SCIENCE
SCIENCE FICTION
SPECIALIZED BOOK
SPORT
THRILLER
TRAVEL

Bildgenreliste

COVER
PHOTO
WALLPAPER
OTHERS

Musik Aufnahmeort

(origin)
STUDIO
LIVE

Musik Urpsungstonträger

(taken from)
CD
MASTER
LIVE
RECORDING

Musik Kanäle

(channels)
STEREO
MONO
SURROUND

Erlaubte Zeichen in anderen Feldern (Auswahl)

URLs

a-z A-Z 0-9 - _ . / @ + ( ) : = (nur in Domainnamen: ä ü ö ß Ä Ü Ö)

Beschreibungstext

(description)
a-z A-Z 0-9 ä ü ö ß Ä Ü Ö _ . @ + ( ) : = - / ~ \ ! ? ] [ < > & , `

GRid

(Global Release Identifier)
A-Z 0-9
Die ID muss mit "A1" beginnen und muss genau eine Länge von 18 Zeichen besitzen!

Album EAN

(European Article Number) bzw GTIN (Global Trade Item Number)
0-9

Andere Felder

a-z A-Z 0-9 ä ü ö ß Ä Ü Ö & - _ / . @ + ( ) : = ; ~ , ! ? ` ] [