Mit dem Tool für den Massen-Upload können Sie mithilfe einer CSV-Vorlage mehrere Veröffentlichungen gleichzeitig in die Plattform importieren. In diesem Artikel wird erläutert, wie Sie Ihre Metadaten formatieren, Assets anhängen und mit häufigen Fehlern umgehen. 

Sie können die neueste CSV-Vorlage am Ende dieses Artikels herunterladen. Um die Eignung zu prüfen, müssen Sie über unser Kontaktformular eine Beispiel-CSV-Datei für den Massen-Upload an den Support senden. 

Allgemeines 

• Katalog-Metadaten: Im Folgenden beschreiben wir das Format für die CSV-Vorlage zum Massen-Upload. Bevor Sie das Tool verwenden, empfehlen wir Ihnen, diesen Leitfaden zu nutzen und ihn sorgfältig durchzulesen. 
• Katalog-Assets: Assets werden nicht direkt auf die Plattform hochgeladen. Stattdessen muss die Metadatendatei eine URL enthalten, über die das System das Asset mit einem einzigen Aufruf abrufen kann. Unser Tool ruft die Assets automatisch in Echtzeit von den in der CSV-Datei angegebenen URLs ab. 

Der CSV-Massen-Upload unterliegt einigen Einschränkungen: 

• Diese spezielle Vorlage unterstützt nur Veröffentlichungs-Inserts (ausgenommen Klingeltöne und Videoclips). 
• Nicht unterstützte Felder: Beschreibung und Anmerkungen zu Veröffentlichungen und Titeln; Songtexte, Startzeit des Titels. 
  • Diese Felder können nicht im Rahmen des Massen-Uploads eingefügt werden. Sie können diese Felder über die reguläre Benutzeroberfläche aktualisieren, sobald der Upload-Vorgang abgeschlossen ist. 

Definition der Felder für Veröffentlichungen und Titel 

Ab Zeile 8 in der CSV-Massen-Upload-Vorlage müssen Sie Ihre Katalog-Metadaten eingeben. Jede Zeile ist für einen Titel vorgesehen und enthält auch die Veröffentlichungsdaten (Album). Wenn Sie also beispielsweise eine Veröffentlichung mit 10 Titeln hochladen, wird der erste Teil (Veröffentlichungsfelder) der Zeile für alle Titel (in allen 10 Zeilen) mit denselben Daten ausgefüllt, während der zweite Teil (Titel-Felder) für jeden Titel unterschiedlich ist. 

In diesem Beispiel lädt das System, sobald Sie die Datei hochgeladen haben und keine Fehler aufgetreten sind, 1 Album mit 10 Titeln hoch. 

Fehler beheben 

Wenn eine Veröffentlichung Fehler enthält, wird sie nicht hochgeladen, fehlerfreie Veröffentlichungen werden jedoch in jedem Fall hochgeladen. Sobald der Upload abgeschlossen ist, erhalten Sie eine CSV-Datei mit den fehlgeschlagenen Veröffentlichungen, und Details zu den Fehlern werden angezeigt, wenn Sie auf „Details“ klicken. So können Sie die fehlgeschlagenen Veröffentlichungen korrigieren und eine neue Version davon hochladen. 

In Bezug auf Titelbeziehungen haben Sie folgende Möglichkeiten: 

• Einen bestehenden Titel an eine neue Veröffentlichung anhängen: Mit diesem Tool kannst du einen Titel, der bereits in der Vergangenheit hochgeladen wurde, an eine völlig neue Veröffentlichung anhängen. Dazu musst du die korrekten ISRC-Felder im Abschnitt „Track Fields“ ausfüllen und alle anderen Felder leer lassen. Der Abschnitt „Release Fields“ sollte wie gewohnt ausgefüllt werden. 
• Einen neuen Titel an mehrere Veröffentlichungen anhängen: Du kannst einen neuen Titel hochladen, der in derselben CSV-Datei in mehrere neue Veröffentlichungen aufgenommen werden soll. Dazu musst du die gleichen Metadatenfelder für den Titel im Abschnitt „Track Fields“ in mehr als einer Zeile ausfüllen und sicherstellen, dass du in jeder der mehreren Zeilen unterschiedliche „Release Fields“ angibst, um diesen Titel an jede dieser Veröffentlichungen anzuhängen. 
  • Falls dieser Titel bereits im Katalog vorhanden ist, befolge die Anweisungen unter Punkt 1. 

Dateiformat 

Die Datei muss aus durch Kommas getrennten Feldern bestehen (CSV) und kann optional in doppelte Anführungszeichen gesetzt werden, gemäß RFC4180. Die Zeichenkodierung der Datei muss UTF-8 sein, um die korrekte Verarbeitung nicht-englischer Sprachen zu gewährleisten. 

Optionale Felder können leer gelassen werden, ihre Spalten müssen jedoch im Dokument vorhanden sein, um die Struktur beizubehalten, für die das Tool ausgelegt ist. 

Veröffentlichungstyp 

Das Veröffentlichungsformat wird automatisch nach folgenden Regeln zugewiesen: 

Veröffentlichungen hochladen 

Sie können Ihre Dateien über den Release Manager hochladen. Standardmäßig ist diese Funktion in Ihrem Konto nicht verfügbar und muss von Ihrem Kundenbetreuer aktiviert werden. Alternativ können Sie sich an support@toolost.com wenden und eine Beispiel-CSV-Datei beifügen. 

CSV-Anleitung 

Metadatenfelder 

Der erste Abschnitt der Datei ist ein Metadatenabschnitt (Zeilen 1–5). Alle Felder sind Pflichtfelder und ermöglichen es unserem Tool, die Datei korrekt zu verarbeiten. 

Veröffentlichungsfelder 

Titel-Felder 

Die Titel der Veröffentlichung werden in der Reihenfolge, in der sie in der CSV-Datei für den Massen-Upload erscheinen, ab 1 nummeriert. Ab der zweiten Titelzeile für dieselbe Veröffentlichung müssen alle Veröffentlichungsfelder vorhanden sein und mit der ersten Veröffentlichungszeile übereinstimmen. 

Teilnehmer 

Die Rollen und Namen aller Künstler und anderer Beteiligter müssen in der einzelnen Spalte „participants“ aufgeführt werden. Vor dem Namen jedes Beteiligten muss dessen Rolle sowie ein Doppelpunkt stehen. Rollen- und Namenspaare müssen durch Semikolons getrennt werden. 

Zum Beispiel: 

• Hauptkünstler: Natos, Waor. 
• Featuring: Ambkor. 
• Remixer: Natos. 
• Produzent: Waor. 
• Komponist: Waor. 

Die Spalte „Mitwirkende“ sollte Folgendes anzeigen: 

• primary:Natos;primary:Waor;featuring:Ambkor;remixer:Natos;producer:Waor;composer:Waor 

Regeln für Mitwirkende 

• Jede Veröffentlichung und jeder Titel muss mindestens einen Hauptkünstler haben. 
• In einer Veröffentlichung oder einem Titel kann ein einzelner Künstler eine der folgenden Rollen einnehmen: Hauptinterpret, Interpret, Gastinterpret oder Mitwirkender. 
• Bei jeder Veröffentlichung, der ein anderes Genre als „Non-Spoken“ zugewiesen ist, muss es auf jedem Titel mindestens einen Komponisten geben. 
• Der Hauptkünstler muss der erste in der Reihenfolge aufgeführte Teilnehmer sein. 

Derzeit akzeptierte Bezeichnungen für Teilnehmerrollen (in Kleinbuchstaben) 

• primary 
• Interpreten 
• Produzent 
• Remixer 
• Komponist 
• Autor 
• Redakteur 
• mit 
• mit 
• Dirigent 
• Arrangeur 
• Orchester 
• Schauspieler 

Doppelte Titel in derselben CSV-Datei 

Wenn Sie einen neuen Titel mit einer bestimmten ISRC erstellen müssen, der in zwei oder mehr Veröffentlichungen enthalten sein soll, können Sie dies erreichen, indem Sie den Titel in allen diesen Veröffentlichungen wiederholen. Achten Sie dabei jedoch besonders darauf, dass die Informationen jedes Titels bei allen Duplikaten identisch sein müssen. 

Wenn sich einige Titelinformationen von den anderen unterscheiden, werden alle Titel als fehlerhaft markiert. 

Diesem gemeinsamen Titel muss ein ISRC zugewiesen sein; es darf sich nicht um einen AUTO-ISRC handeln. 

Wiederholter Titel im Katalog des Benutzers 

Sie können einen bereits im Benutzerkatalog vorhandenen Titel einer neu erstellten Veröffentlichung zuweisen. 

Dazu müssen wir in der CSV-Datei alle Titelinformationen außer dem ISRC leer lassen; dies sind die Daten, mit denen wir den vorhandenen Titel im Katalog des Benutzers finden. 

So fügen Sie Asset-Dateien hinzu 

In den Feldern für Asset-Links (cover_url auf Veröffentlichungsebene und audio_url auf Titeleebene) müssen Sie einen Link zu einer verfügbaren Datei angeben, damit wir diese abrufen und zusammen mit Ihren Inhalten hochladen können. 

Assets sind obligatorisch, und wenn einer der Links fehlschlägt, kann die Veröffentlichung nicht hochgeladen werden. Daher müssen Sie sicherstellen, dass die URLs auf die richtigen Assets verweisen. 
Wenn die URLs (z. B. WeTransfer) oder die Anmeldedaten (z. B. signierte S3-URLs) nur für eine begrenzte Zeit gültig sind, stellen Sie sicher, dass die Zeit lang genug ist, damit das System die Assets einlesen kann. 

Bitte lesen Sie unseren Leitfaden zu den Anforderungen an Audiodateien. 

Bitte lesen Sie unseren Leitfaden zu den Anforderungen an Cover-Art. 

Unterstützte Methoden für die Asset-Erfassung 

Assets werden nicht direkt auf die Plattform hochgeladen. Stattdessen muss die Metadatendatei eine URL enthalten, über die das System das Asset mit einem einzigen Aufruf abrufen kann. Das bedeutet, dass die URL für jedes Asset eindeutig sein muss. Beispielsweise kann der Cover-Link für jeden Titel des Albums wiederholt werden, aber für jeden Titel muss es eine eigene Audio-URL geben (da das Audiomaterial unterschiedlich ist). Die URL muss ein direkter Download-Link sein. 

Die URL darf keinerlei Authentifizierungsdaten enthalten. Der Importvorgang folgt keinem separaten Anmeldeverfahren. 

Die Metadaten müssen nicht dauerhaft unter der externen URL gehostet werden, sie müssen lediglich zugänglich sein, während wir sie abrufen, um das Album auf unserer Plattform zu verarbeiten. Ab diesem Zeitpunkt werden das Audio und das Cover in unserem System gespeichert. 

Wir unterstützen derzeit die folgenden Optionen: 

• Öffentliche URLs: 
  • HTTP-URLs 
  • HTTPS-URLs 
  • FTP-URLs 
  • SFTP-URLs 
  • Amazon S3-URLs (mit einer signierten URL, wenn die Datei schreibgeschützt ist) (dies ist die bevorzugte Methode) 
  • Cloud-Speicherdienste, die öffentliche Links zum direkten Herunterladen bereitstellen (z. B. Dropbox, WeTransfer, Google Drive) 

• Authentifizierte URLs: 
  Wir unterstützen einige Methoden für authentifizierte URLs, jedoch nur mit Benutzername und Passwort. Um einen authentifizierten Link einzufügen, befolge bitte dieses Format: 
  • HTTP-URLs: http://{user}:{pass}@{host}/{file} 
  • HTTPS-URLs: https://{user}:{pass}@{host}/{file} 
  • FTP-URLs: ftp://{user}:{pass}@{host}/{file} 
  • SFTP-URLs*:sftp://{user}:{pass}@{host}/{file} 
  • Amazon S3-URLs**: https://{bucket}.s3.amazonaws.com/{file}?AWSAccessKeyId={accesskey}&Signature={signature}&Expires={timestamp} 

* Wir unterstützen für SFTP-URLs nur öffentliche Schlüssel. Um uns einen öffentlichen Schlüssel zur Verfügung zu stellen, wenden Sie sich bitte an unseren Support und stimmen Sie Ihren Upload mit unserem Team ab. 
** Amazon S3-URLs – mit einer signierten URL, wenn die Datei schreibgeschützt ist. 

Creative-Commons-Lizenzen 

Wir unterstützen derzeit nur CC Version 3.0. Verwenden Sie „license_info“, um Creative-Commons-Klauseln mit den offiziellen Abkürzungen, durch Bindestriche getrennt, anzuzeigen. 

Beispiel für einen CSV-Massenimport 

Beispiel für einen CSV-Massenimport