Titel und Produkte importieren
Massenimport oder Aktualisierung von Produkten mit ISBNs, Metadaten und Veröffentlichungsdetails per CSV-Upload.
Diese Seite führt Sie durch die Schritte zum Importieren Ihrer Titel, ob Sie neue Produkte importieren oder Aktualisierungen vorhandener Produkte importieren.
Wenn Sie nur ein oder zwei neue Titel hinzufügen möchten, bevorzugen Sie möglicherweise, dies über die Benutzeroberfläche zu tun. Wenn Sie jedoch Titel und Daten in großen Mengen importieren möchten, sind Sie hier richtig.
Bitte beachten Sie, dass Produkte spezifische Ausgaben eines Titels sind. Zum Beispiel könnte ein Titel „Mein Buch" heißen und mehrere Formate haben: Taschenbuch, Hardcover, E-Book und Hörbuch. Jede dieser Ausgaben/Formate wird in Royalties HQ als Produkt bezeichnet und hat jeweils eine eigene Produkt-ID (z.B. ISBN).
Produkte können in großen Mengen importiert werden mit der CSV-Upload-Funktion. Eine Vorlage steht auf der Seite Rechteinhaber > Import zum Download bereit.
Die Titel-Importvorlage herunterladen
- Gehen Sie zum Hauptmenü oben links und klicken Sie auf Titel, dann auf Produkte.
- Klicken Sie auf der Seite mit der Produktliste auf die Schaltfläche Import.
- Wählen Sie unter „Was laden Sie hoch?" die Option „Produkte".
- Klicken Sie darunter auf „Produkte-Vorlagendatei herunterladen".
- Die CSV-Vorlagendatei wird auf Ihr Gerät heruntergeladen.
Ihre Titeldaten formatieren
- Öffnen Sie die im vorherigen Schritt heruntergeladene CSV-Importvorlage für Produkte (siehe oben) – wir empfehlen Google Sheets.
- Jede Zeile ist ein Produkt (in Royalties HQ ist ein Titel das „Elternelement" und kann mehrere Formate haben – diese nennen wir Produkte).
- Jedes Produkt muss mindestens eine Produkt-ID wie ISBN, ASIN oder andere Produkt-ID haben (und diese müssen eindeutig sein).
- Alle anderen Felder sind optional.
- Wenn Ihre Daten fertig sind, speichern Sie sie als CSV. In Google Sheets ist das Datei > Herunterladen > CSV.
Bei der Formatierung Ihrer Daten müssen Sie diese Anforderungen befolgen:
- Sie müssen Zahlen als Text formatieren
- Daten müssen in diesem Format sein: JJJJ-MM-TT (z.B. muss „30. Dezember 2020" als „2020-12-30" eingegeben werden)
- Der Staffelberechnungstyp (tier-type-Spalte) muss entweder units-sold oder total-net-receipts sein (Mehr Informationen zu Staffeln und Staffelberechnungstyp finden Sie hier).
| Spaltenname | Beschreibung | Erforderlich | Format/Werte |
|---|---|---|---|
| name | Vollständiger Titel des Buches | Ja | Textzeichenfolge |
| title-code | Eindeutiger Bezeichner für den Titel (übergeordneter Datensatz) | Ja | Alphanumerisch (z.B. T000047). Muss 7 Zeichen haben. Wird automatisch erstellt, wenn leer gelassen. |
| royalty-period-start-month | Startmonat für Honorarberechnungen | Ja | Ein Monat, entweder ausgeschrieben oder abgekürzt (z.B. „Jan" oder „Januar") |
| royalty-period-length | Länge der Honorarperiode | Ja | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | Formattyp dieser Ausgabe | Ja | softcover, hardcover, ebook, audiobook, wire-bound |
| status | Veröffentlichungsstatus | Ja | active, inactive, withdrawn |
| imprint | Name des Verlags-Imprints | Nein | Textzeichenfolge |
| isbn | ISBN-13 für physische Formate | Bedingt* | 13-stellige ISBN ohne Bindestriche |
| asin | Amazon Standard Identification Number | Bedingt* | 10-stelliges alphanumerisches Zeichen |
| number-pages | Seitenzahl für physische Bücher | Nein | Ganzzahl (z.B. 300) |
| legacy-units-sold | Historische verkaufte Einheiten vor Nutzung von Royalties HQ | Nein | Ganzzahl (z.B. 250) |
| legacy-earned-royalties | Historische verdiente Honorare vor Nutzung von Royalties HQ | Nein | Dezimalzahl (z.B. 16,95) |
| date-first-published | Erstveröffentlichungsdatum | Nein | JJJJ-MM-TT Format |
| date-withdrawn | Datum, an dem das Format aus dem Verkauf genommen wurde | Nein | JJJJ-MM-TT Format |
*Mindestens eine Produkt-ID (ISBN, ASIN oder andere) ist für jedes Produkt erforderlich
Andere Daten
Titel-Codes
- In Royalties HQ erhält jeder Titel einen eindeutigen Bezeichner – einen Titel-Code. Hinweis: Ein Titel ist KEINE ISBN.
- Alle Formate desselben Buches teilen denselben Titel-Code.
- Ein Titel-Code wird automatisch generiert, wenn Sie einen neuen Titel erstellen – ob über die Benutzeroberfläche oder per Import. Sie können beim Import einen Titel-Code angeben. Dies ist wichtig für die Gruppierung von Produkten unter einem Titel. Wenn Sie beispielsweise eine neue Ausgabe eines Titels importieren, sollten Sie sie mit dem entsprechenden Titel-Code importieren.
- Wenn Sie beim Import keinen Titel-Code angeben, werden alle neuen Produkte unter neuen Titeln generiert.
Rechteinhaber
- Müssen mit vorhandenen Rechteinhaber-Codes in Royalties HQ übereinstimmen.
- Importieren Sie Rechteinhaber zuerst, wenn sie noch nicht in Royalties HQ existieren.
- Lassen Sie es leer, wenn noch kein Rechteinhaber zugewiesen ist.
Historische Daten
- Optional.
- Verwenden Sie historische Felder, um historische Verkäufe zu erfassen, bevor Sie Royalties HQ verwendet haben.
- Diese Beträge sind wichtig, wenn ein Vertrag die Gesamtzahl der verkauften Einheiten verwendet, um den aktuellen Honorarsatz eines Rechteinhabers für ein Produkt (ISBN) zu bestimmen.
Zusätzliche Produkt-IDs
- Zusätzliche Produkt-IDs umfassen ACX, Google Play und mehr – dies sind optionale Felder zum Speichern alternativer Produktbezeichner
- Verwenden Sie diese für proprietäre Codes, interne SKUs oder benutzerdefinierte Bezeichner, die keine ISBNs oder ASINs sind
- Produkt-IDs müssen über alle Produkte hinweg eindeutig sein
- Dieses Feld ist nützlich für die Verfolgung von Titeln in mehreren Systemen
Sprache
- Sprache ist ein optionales Feld zur Angabe der Sprache des Produkts
- Verwenden Sie ISO 639-3 Drei-Buchstaben-Codes (z.B. „eng" für Englisch, „deu" für Deutsch usw.) oder einfache Bezeichnungen („English", „German" usw.)
- Lassen Sie es leer, wenn nicht zutreffend oder wenn die Sprache nicht relevant ist
- Dies kann automatisch über den Google Books-Metadatenabruf für neue Produkte ausgefüllt werden
Monats- und Periodenformatunterstützung
royalty-period-start-month unterstützt flexible Monatsbeschreibungen:
- Vollständige Monatsnamen: „January", „February", „March" usw.
- Drei-Buchstaben-Abkürzungen: „Jan", „Feb", „Mar" usw.
- Numerisches Format: 1-12 (z.B. 3 für März)
Ihre Produkte-CSV hochladen
Wenn Sie Ihre Produktdaten nochmals überprüft haben, können Sie sie in Royalties HQ importieren. So machen Sie das:
- Gehen Sie zum Hauptmenü oben links und klicken Sie auf Import.
- Wählen Sie für den Typ „Titel".
- Klicken Sie unter „Datei auswählen" auf „Durchsuchen" und navigieren Sie zu Ihrer CSV-Datei.
- Klicken Sie auf „Weiter".
- Die Datei wird hochgeladen und validiert (auf Probleme geprüft). Sie sehen die Ergebnisse auf einer Vorschauseite.
- Wenn die Ergebnisse gut aussehen, klicken Sie auf „Fortfahren" und die Produkte werden importiert (oder, wenn der Vorschauschritt Probleme hervorhebt, müssen Sie die Daten korrigieren – lesen Sie die Fehlermeldung und überprüfen Sie die Anforderungen unten).
Produkte in großen Mengen aktualisieren
Sie können den obigen Prozess auch verwenden, um Produkte in großen Mengen zu aktualisieren.
Der CSV-Import gleicht vorhandene Produkte anhand von ISBN oder ASIN ab. Leere Felder werden ignoriert; diese überschreiben keine vorhandenen Daten.
Beachten Sie, dass alle neuen Produkt-IDs (einschließlich ISBNs oder ASINs) in Ihrer CSV, die sich nicht in einer Zeile mit einer erkannten Produkt-ID befinden, zu einem neuen Produkt führen.