Dokumentacja

Importowanie tytułów i produktów

Zbiorcze importowanie lub aktualizowanie produktów z ISBN, metadanymi i szczegółami publikacji za pomocą przesyłania CSV.

Ta strona przeprowadzi cię przez kroki importu twoich tytułów, czy to importując nowe produkty, czy importując aktualizacje do istniejących produktów.

Jeśli chcesz dodać tylko jeden lub dwa nowe tytuły, możesz preferować zrobienie tego przez interfejs użytkownika. Jednak jeśli chcesz zaimportować tytuły i dane zbiorczo, jesteś we właściwym miejscu.

Należy pamiętać, że produkty to konkretne wydania tytułu. Na przykład tytuł może nazywać się “Moja książka” i może mieć wiele formatów: miękka oprawa, twarda oprawa, e-book i audiobook. Każde z tych wydań/formatów jest znane w Royalties HQ jako produkt, a każdy będzie miał swoje własne ID produktu (np. ISBN).

Produkty mogą być importowane zbiorczo za pomocą funkcji przesyłania CSV. Szablon jest dostępny do pobrania ze strony Tytuły > Produkty > Import.

Pobieranie szablonu importu tytułów

  1. Przejdź do menu głównego w lewym górnym rogu i kliknij Tytuły, następnie Produkty.
  2. Na stronie listy produktów kliknij przycisk Importuj.
  3. W sekcji ‘Co przesyłasz?’ wybierz ‘Produkty’.
  4. Poniżej kliknij ‘Pobierz szablon pliku produktów’.
  5. Szablon pliku CSV zostanie pobrany na twoje urządzenie.

Formatowanie danych tytułów

  1. Otwórz pobrany szablon CSV importu produktów z poprzedniego kroku (zobacz powyżej) – zalecamy użycie Google Sheets.
  2. Każdy wiersz to jeden produkt (w Royalties HQ tytuł jest ‘rodzicem’ i może mieć wiele formatów – nazywamy je produktami).
  3. Każdy produkt musi mieć co najmniej jedno ID produktu, takie jak ISBN, ASIN lub inne ID produktu (i muszą być one unikalne).
  4. Wszystkie inne pola są opcjonalne.
  5. Gdy dane są gotowe, zapisz jako CSV. W Google Sheets jest to Plik > Pobierz > CSV.

Podczas formatowania danych musisz przestrzegać tych wymagań:

Nazwa kolumnyOpisWymaganeFormat/Wartości
namePełny tytuł książkiTakCiąg tekstowy
title-codeUnikalny identyfikator tytułu (rekord nadrzędny)TakAlfanumeryczny (np. T000047). Musi mieć 7 znaków. Jeden zostanie utworzony automatycznie, jeśli zostanie pusty.
royalty-period-start-monthMiesiąc rozpoczęcia obliczeń tantiemTakMiesiąc napisany w pełni lub skrócony (np. “Sty” lub “Styczeń”)
royalty-period-lengthDługość okresu tantiemTakmonthly, two-monthly, quarterly, six-monthly, annual
product-typeTyp formatu tego wydaniaTaksoftcover, hardcover, ebook, audiobook, wire-bound
statusStatus publikacjiTakactive, inactive, withdrawn
imprintNazwa imprintu wydawcyNieCiąg tekstowy
isbnISBN-13 dla formatów fizycznychWarunkowe*13-cyfrowy ISBN bez kresek
asinAmazon Standard Identification NumberWarunkowe*10-znakowy alfanumeryczny
number-pagesLiczba stron dla książek fizycznychNieLiczba całkowita (np. 300)
legacy-units-soldHistoryczne jednostki sprzedane przed używaniem Royalties HQNieLiczba całkowita (np. 250)
legacy-earned-royaltiesHistoryczne tantiemy zarobione przed używaniem Royalties HQNieLiczba dziesiętna (np. 16.95)
date-first-publishedPoczątkowa data publikacjiNieFormat RRRR-MM-DD
date-withdrawnData wycofania formatu ze sprzedażyNieFormat RRRR-MM-DD

*Co najmniej jedno ID produktu (ISBN, ASIN lub inne) jest wymagane dla każdego produktu

Inne dane

Kody tytułów

  • W Royalties HQ każdy tytuł otrzymuje unikalny identyfikator – kod tytułu. Uwaga: tytuł to NIE jest ISBN.
  • Wszystkie formaty tej samej książki współdzielą ten sam kod tytułu.
  • Kod tytułu zostanie wygenerowany automatycznie, gdy utworzysz nowy tytuł – czy to przez interfejs użytkownika, czy przez import. Możesz określić kod tytułu podczas importu. Jest to ważne dla grupowania produktów pod jednym tytułem. Na przykład, jeśli importujesz nowe wydanie tytułu, powinieneś zaimportować je z odpowiednim kodem tytułu.
  • Jeśli nie określisz kodu tytułu podczas importu, wszelkie nowe produkty zostaną wygenerowane pod nowymi tytułami.

Posiadacze praw

  • Muszą odpowiadać istniejącym kodom posiadaczy praw w Royalties HQ.
  • Najpierw zaimportuj posiadaczy praw, jeśli jeszcze nie istnieją w Royalties HQ.
  • Zostaw puste, jeśli nie przypisano jeszcze posiadacza praw.

Dane historyczne

  • Opcjonalne.
  • Użyj pól historycznych do rejestrowania historycznej sprzedaży przed rozpoczęciem używania Royalties HQ.
  • Te kwoty są niezbędne, gdy umowa używa całkowitej liczby sprzedanych egzemplarzy do określenia aktualnej stawki tantiem posiadacza praw dla produktu (ISBN).

Dodatkowe ID produktów

  • Dodatkowe ID produktu obejmują ACX, Google Play i więcej – są to opcjonalne pola do przechowywania alternatywnych identyfikatorów produktów
  • Użyj ich dla zastrzeżonych kodów, wewnętrznych SKU lub niestandardowych identyfikatorów, które nie są ISBN ani ASIN
  • ID produktów muszą być unikalne we wszystkich produktach
  • To pole jest przydatne do śledzenia tytułów w wielu systemach

Język

  • Język to opcjonalne pole wskazujące język produktu
  • Użyj trzyliterowych kodów ISO 639-3 (np. “eng” dla angielskiego, “deu” dla niemieckiego itp.) lub angielskich etykiet (“English”, “German” itp.)
  • Zostaw puste, jeśli nie ma zastosowania lub jeśli język nie jest istotny
  • Może być automatycznie wypełnione przez pobieranie metadanych Google Books dla nowych produktów

Obsługa formatu miesiąca i okresu

royalty-period-start-month obsługuje elastyczne deskryptory miesięcy:

  • Pełne nazwy miesięcy: “January”, “February”, “March” itp.
  • Trzyliterowe skróty: “Jan”, “Feb”, “Mar” itp.
  • Format numeryczny: 1-12 (np. 3 dla marca)

Przesyłanie CSV produktów

Gdy dokładnie sprawdziłeś swoje dane produktów, możesz zaimportować je do Royalties HQ. Oto jak to zrobić:

  1. Przejdź do menu głównego w lewym górnym rogu i kliknij Import.
  2. Dla typu wybierz ‘Tytuły’.
  3. W sekcji ‘Wybierz plik’ kliknij ‘Przeglądaj’ i przejdź do swojego pliku CSV.
  4. Kliknij ‘Dalej’
  5. Plik zostanie przesłany i zwalidowany (sprawdzony pod kątem problemów). Wyniki zobaczysz na stronie podglądu.
  6. Jeśli wyniki wyglądają dobrze, kliknij ‘Kontynuuj’ i produkty zostaną zaimportowane (lub, jeśli podgląd wykaże problemy, będziesz musiał naprawić dane – przeczytaj komunikat błędu i sprawdź wymagania poniżej).

Zbiorcza aktualizacja produktów

Możesz również użyć powyższego procesu do aktualizacji produktów zbiorczo.

Import CSV będzie dopasowywał istniejące produkty po ISBN lub ASIN. Puste pola zostaną zignorowane; nie nadpiszą istniejących danych.

Należy pamiętać, że wszelkie nowe ID produktów (w tym ISBN lub ASIN) w twoim CSV, które nie znajdują się w wierszu z rozpoznanym ID produktu, spowodują utworzenie nowego produktu.