Dokumentace

Import titulů a produktů

Hromadný import nebo aktualizace produktů s ISBN, metadaty a publikačními údaji přes CSV nahrání.

Tato stránka vás provede kroky pro import vašich titulů, ať už importujete nové produkty nebo importujete aktualizace existujících produktů.

Pokud chcete přidat pouze jeden nebo dva nové tituly, možná preferujete provést to přes uživatelské rozhraní. Avšak pokud chcete importovat tituly a data hromadně, jste na správném místě.

Prosím mějte na paměti, že produkty jsou specifické edice titulu. Například titul může být nazván “Moje kniha” a může mít více formátů: brožovaná kniha, vázaná kniha, e-kniha a audiokniha. Každá z těchto edic/formátů je v Royalties HQ známa jako produkt a každý bude mít své vlastní ID produktu (např. ISBN).

Produkty lze importovat hromadně pomocí funkce nahrání CSV. Šablona je k dispozici ke stažení na stránce Držitelé práv > Import.

Stažení šablony pro import titulů

  1. Přejděte do hlavního menu vlevo nahoře a klikněte na Tituly, poté Produkty.
  2. Na stránce se seznamem produktů klikněte na tlačítko Import.
  3. V sekci ‘Co nahráváte?’ vyberte ‘Produkty’.
  4. Pod tím klikněte na ‘Stáhnout šablonu souboru produktů’.
  5. CSV soubor šablony se stáhne do vašeho zařízení.

Formátování dat titulů

  1. Otevřete CSV šablonu pro import produktů staženou v předchozím kroku (viz výše) – doporučujeme použít Google Sheets.
  2. Každý řádek je jeden produkt (v Royalties HQ je titul “rodičem” a může mít více formátů – těmto říkáme produkty).
  3. Každý produkt musí mít alespoň jedno ID produktu jako ISBN, ASIN nebo jiné ID produktu (a tyto musí být jedinečné).
  4. Všechna ostatní pole jsou volitelná.
  5. Když jsou vaše data připravena, uložte je jako CSV. V Google Sheets je to Soubor > Stáhnout > CSV.

Při formátování dat musíte dodržovat tyto požadavky:

  • Musíte formátovat čísla jako text
  • Data musí být v tomto formátu: RRRR-MM-DD (např. “30. prosince 2020” musí být zadáno jako “2020-12-30”)
  • Typ výpočtu úrovně (sloupec tier-type) musí být buď units-sold nebo total-net-receipts (Více informací o úrovních a typu výpočtu úrovně zde).
Název sloupcePopisPovinnéFormát/Hodnoty
nameCelý název knihyAnoTextový řetězec
title-codeUnikátní identifikátor titulu (rodičovský záznam)AnoAlfanumerický (např. T000047). Musí mít 7 znaků. Jeden bude vytvořen automaticky, pokud zůstane prázdný.
royalty-period-start-monthPočáteční měsíc pro výpočty honorářůAnoMěsíc buď celý nebo zkrácený (např. “Jan” nebo “January”)
royalty-period-lengthDélka období honorářůAnomonthly, two-monthly, quarterly, six-monthly, annual
product-typeTyp formátu této ediceAnosoftcover, hardcover, ebook, audiobook, wire-bound
statusStav vydáníAnoactive, inactive, withdrawn
imprintNázev imprintu vydavateleNeTextový řetězec
isbnISBN-13 pro fyzické formátyPodmíněné*13místné ISBN bez pomlček
asinAmazon Standard Identification NumberPodmíněné*10znakový alfanumerický
number-pagesPočet stránek pro fyzické knihyNeCelé číslo (např. 300)
legacy-units-soldHistoricky prodané kusy před používáním Royalties HQNeCelé číslo (např. 250)
legacy-earned-royaltiesHistoricky vyděláno na honorářích před používáním Royalties HQNeDesetinné číslo (např. 16.95)
date-first-publishedDatum prvního vydáníNeFormát RRRR-MM-DD
date-withdrawnDatum stažení formátu z prodejeNeFormát RRRR-MM-DD

*Alespoň jedno ID produktu (ISBN, ASIN nebo jiné) je vyžadováno pro každý produkt

Další data

Kódy titulů

  • V Royalties HQ je každému titulu přidělen unikátní identifikátor – kód titulu. Poznámka: titul NENÍ ISBN.
  • Všechny formáty stejné knihy sdílejí stejný kód titulu.
  • Kód titulu bude vygenerován automaticky, když vytvoříte nový titul – ať už přes uživatelské rozhraní nebo přes import. Můžete specifikovat kód titulu při importu. To je důležité pro seskupování produktů pod jeden titul. Například pokud importujete novou edici titulu, měli byste ji importovat s příslušným kódem titulu.
  • Pokud nespecifikujete kód titulu při importu, jakékoli nové produkty budou vygenerovány pod novými tituly.

Držitelé práv

  • Musí odpovídat existujícím kódům držitelů práv v Royalties HQ.
  • Nejprve importujte držitele práv, pokud ještě v Royalties HQ neexistují.
  • Ponechte prázdné, pokud není dosud přiřazen žádný držitel práv.

Data před používáním Royalties HQ

  • Volitelné.
  • Použijte pole pro data před používáním RHQ k zaznamenání historických prodejů před tím, než jste používali Royalties HQ.
  • Tyto částky jsou nezbytné, když smlouva používá celkové prodané kusy k určení aktuální sazby honorářů držitele práv pro produkt (ISBN).

Další ID produktů

  • Další ID produktu zahrnuje ACX, Google Play a další – toto jsou volitelná pole pro ukládání alternativních identifikátorů produktů
  • Použijte je pro vlastní kódy, interní SKU nebo vlastní identifikátory, které nejsou ISBN nebo ASIN
  • ID produktů musí být jedinečná napříč všemi produkty
  • Toto pole je užitečné pro sledování titulů ve více systémech

Jazyk

  • Jazyk je volitelné pole pro indikaci jazyka produktu
  • Použijte ISO 639-3 třípísmenné kódy (např. “eng” pro angličtinu, “deu” pro němčinu atd.), nebo anglické názvy (“English”, “German” atd.)
  • Ponechte prázdné, pokud není použitelné nebo pokud jazyk není relevantní
  • Toto může být automaticky naplněno přes načtení Google Books metadat pro nové produkty

Podpora formátu měsíce a období

royalty-period-start-month podporuje flexibilní popisy měsíce:

  • Celé názvy měsíců: “January”, “February”, “March” atd.
  • Třípísmenné zkratky: “Jan”, “Feb”, “Mar” atd.
  • Číselný formát: 1-12 (např. 3 pro březen)

Nahrajte své CSV s produkty

Když jste dvakrát zkontrolovali data svých produktů, můžete je importovat do Royalties HQ. Zde je postup:

  1. Přejděte do hlavního menu vlevo nahoře a klikněte na Import.
  2. Jako typ vyberte ‘Tituly’.
  3. V sekci ‘Vyberte soubor’ klikněte na ‘Procházet’ a přejděte k vašemu CSV souboru.
  4. Klikněte na ‘Další’
  5. Soubor bude nahrán a ověřen (zkontrolován na problémy). Výsledky uvidíte na stránce náhledu.
  6. Pokud výsledky vypadají dobře, klikněte na ‘Pokračovat’ a produkty budou importovány (nebo pokud krok náhledu zvýrazní problémy, budete muset opravit data – přečtěte si chybovou zprávu a zkontrolujte požadavky níže).

Hromadná aktualizace produktů

Můžete také použít výše uvedený proces k aktualizaci produktů hromadně.

CSV import bude odpovídat existujícím produktům podle ISBN nebo ASIN. Prázdná pole budou ignorována; ta nepřepíší existující data.

Mějte na paměti, že jakákoli nová ID produktů (včetně ISBN nebo ASIN) ve vašem CSV, která nejsou v řádku s rozpoznaným ID produktu, povedou k vytvoření nového produktu.