Dokumentation

Import af titler og produkter

Masseimporter eller opdater produkter med ISBN'er, metadata og udgivelsesdetaljer via CSV-upload.

Denne side vil guide dig gennem trinene til at importere dine titler, hvad enten du importerer nye produkter eller importerer opdateringer til eksisterende produkter.

Hvis du kun ønsker at tilføje én eller to nye titler, foretrækker du måske at gøre dette gennem brugergrænsefladen. Men hvis du ønsker at importere titler og data i bulk, er du det rette sted.

Bemærk, at produkter er specifikke udgaver af en titel. For eksempel kan en titel hedde “Min bog” og kan have flere formater: softcover, hardcover, e-bog og lydbog. Hver af disse udgaver/formater er kendt i Royalties HQ som et produkt, og hver vil have sit eget produkt-ID (f.eks. ISBN).

Produkter kan importeres i bulk ved hjælp af CSV-uploadfunktionen. En skabelon kan downloades fra siden Rettighedshavere > Import.

Download titelimportskabelonen

  1. Gå til hovedmenuen, øverst til venstre, og klik på Titler, derefter Produkter.
  2. På produktlistesiden skal du klikke på knappen Importer.
  3. Under ‘Hvad uploader du?’, vælg ‘Produkter’.
  4. Under dette skal du klikke på ‘Download produktskabelonfil’.
  5. CSV-filskabelonen vil blive downloadet til din enhed.

Formatér dine titeldata

  1. Åbn produkters CSV-importskabelon, der blev downloadet i det forrige trin (se ovenfor) – vi anbefaler at bruge Google Sheets.
  2. Hver række er ét produkt (i Royalties HQ er en titel ‘forælderen’, og den kan have flere formater – vi kalder disse produkter).
  3. Hvert produkt skal have mindst ét produkt-ID såsom ISBN, ASIN eller andet produkt-ID (og disse skal være unikke).
  4. Alle andre felter er valgfrie.
  5. Når dine data er klar, gem som en CSV. I Google Sheets er dette Fil > Download > CSV.

Når du formaterer dine data, skal du følge disse krav:

  • Du skal formatere tal som tekst
  • Datoer skal være i dette format: YYYY-MM-DD (f.eks. skal “30. december 2020” indtastes som “2020-12-30”)
  • Tier-beregningstypen (tier-type-kolonnen) skal være enten units-sold eller total-net-receipts (Mere info om tiers og tier-beregningstype er her).
KolonnenavnBeskrivelsePåkrævetFormat/Værdier
nameFuld bogtitelJaTekststreng
title-codeUnik identifikator for titlen (forælderpost)JaAlfanumerisk (f.eks. T000047). Skal være 7 tegn. Én vil blive oprettet automatisk, hvis den efterlades tom.
royalty-period-start-monthStartmåned for royaltyberegningerJaEn måned enten stavet fuldt ud eller forkortet (f.eks. “Jan” eller “Januar”)
royalty-period-lengthLængde af royaltyperiodeJamonthly, two-monthly, quarterly, six-monthly, annual
product-typeFormattype for denne udgaveJasoftcover, hardcover, ebook, audiobook, wire-bound
statusUdgivelsesstatusJaactive, inactive, withdrawn
imprintForlags imprintnavnNejTekststreng
isbnISBN-13 til fysiske formaterBetinget*13-cifret ISBN uden bindestreger
asinAmazon Standard Identification NumberBetinget*10-tegns alfanumerisk
number-pagesSidetal for fysiske bøgerNejHeltal (f.eks. 300)
legacy-units-soldHistoriske solgte enheder før brug af Royalties HQNejHeltal (f.eks. 250)
legacy-earned-royaltiesHistoriske optjente royalties før brug af Royalties HQNejDecimal (f.eks. 16.95)
date-first-publishedFørste udgivelsesdatoNejYYYY-MM-DD format
date-withdrawnDato for tilbagetrækning fra salgNejYYYY-MM-DD format

*Mindst ét produkt-ID (ISBN, ASIN eller andet) er påkrævet for hvert produkt

Andre data

Titelkoder

  • På Royalties HQ får hver titel en unik identifikator – en titelkode. Bemærk: en titel er IKKE et ISBN.
  • Alle formater af samme bog deler samme titelkode.
  • En titelkode genereres automatisk, når du opretter en ny titel – hvad enten det er via brugergrænsefladen eller via import. Du kan specificere en titelkode ved import. Dette er vigtigt for at gruppere produkter under én titel. For eksempel, hvis du importerer en ny udgave af en titel, bør du importere den med den relevante titelkode.
  • Hvis du ikke specificerer en titelkode ved import, vil alle nye produkter blive genereret under nye titler.

Rettighedshavere

  • Skal matche eksisterende rettighedshaverkoder i Royalties HQ.
  • Importer rettighedshavere først, hvis de endnu ikke eksisterer i Royalties HQ.
  • Efterlad tom, hvis ingen rettighedshaver er tildelt endnu.

Legacy-data

  • Valgfrit.
  • Brug legacy-felter til at registrere historisk salg, før du brugte Royalties HQ.
  • Disse beløb er essentielle, når en kontrakt bruger samlede solgte enheder til at bestemme en rettighedshavers nuværende royaltysats for et produkt (ISBN).

Yderligere produkt-ID’er

  • Yderligere produkt-ID omfatter ACX, Google Play og mere – disse er valgfrie felter til lagring af alternative produktidentifikatorer
  • Brug disse til proprietære koder, interne SKU’er eller tilpassede identifikatorer, der ikke er ISBN’er eller ASIN’er
  • Produkt-ID’er skal være unikke på tværs af alle produkter
  • Dette felt er nyttigt til at spore titler på tværs af flere systemer

Sprog

  • Sprog er et valgfrit felt til angivelse af produktets sprog
  • Brug ISO 639-3 tre-bogstavs koder (f.eks. “eng” for engelsk, “deu” for tysk osv.) eller almindelige engelske etiketter (“English”, “German” osv.)
  • Efterlad tom, hvis ikke relevant eller hvis sprog ikke er relevant
  • Dette kan automatisk udfyldes via Google Books-metadatahentning for nye produkter

Måneds- og periodeformatunderstøttelse

royalty-period-start-month understøtter fleksible månedsbeskrivelser:

  • Fulde månedsnavne: “January”, “February”, “March” osv.
  • Tre-bogstavs forkortelser: “Jan”, “Feb”, “Mar” osv.
  • Numerisk format: 1-12 (f.eks. 3 for marts)

Upload din produkt-CSV

Når du har dobbelttjekket dine produktdata, kan du gå videre og importere dem til Royalties HQ. Sådan gør du:

  1. Gå til hovedmenuen, øverst til venstre, og klik på Importer.
  2. For typen, vælg ‘Titler’.
  3. Under ‘Vælg din fil’ klik på ‘Gennemse’ og naviger til din CSV-fil.
  4. Klik på ‘Næste’
  5. Filen vil blive uploadet og valideret (kontrolleret for problemer). Du vil se resultaterne på en forhåndsvisningsside.
  6. Hvis resultaterne ser gode ud, klik på ‘Fortsæt’, og produkterne vil blive importeret (eller, hvis forhåndsvisningstrinnet fremhæver problemer, skal du rette dataene – læs fejlmeddelelsen og tjek kravene nedenfor).

Opdater produkter i bulk

Du kan også bruge ovenstående proces til at opdatere produkter i bulk.

CSV-importen vil matche eksisterende produkter på ISBN eller ASIN. Tomme felter vil blive ignoreret; disse vil ikke overskrive eksisterende data.

Bemærk, at eventuelle nye produkt-ID’er (inklusive ISBN’er eller ASIN’er) i din CSV, der ikke er i en række med et genkendt produkt-ID, vil resultere i et nyt produkt.