Dokumentasjon

Importere titler og produkter

Bulkimporter eller oppdater produkter med ISBN, metadata og publiseringsdetaljer via CSV-opplasting.

Denne siden vil lede deg gjennom trinnene for å importere titlene dine, enten du importerer nye produkter eller importerer oppdateringer til eksisterende produkter.

Hvis du bare vil legge til én eller to nye titler, kan du foretrekke å gjøre dette gjennom brukergrensesnittet. Hvis du imidlertid ønsker å importere titler og data i bulk, er du på rett sted.

Merk at produkter er spesifikke utgaver av en tittel. For eksempel kan en tittel hete “Min bok” og kan ha flere formater: paperback, innbundet, e-bok og lydbok. Hver av disse utgavene/formatene er kjent i Royalties HQ som et produkt, og hver vil ha sin egen produkt-ID (f.eks. ISBN).

Produkter kan importeres i bulk ved å bruke CSV-opplastingsfunksjonen. En mal er tilgjengelig for nedlasting fra Rettighetshavere > Import-siden.

Last ned importmalen for titler

  1. Gå til hovedmenyen, øverst til venstre, og klikk Titler, deretter Produkter.
  2. På produktlistesiden, klikk Import-knappen.
  3. Under ‘Hva laster du opp?’, velg ‘Produkter’.
  4. Under dette, klikk ‘Last ned produktmalen’.
  5. CSV-filmalen vil bli lastet ned til enheten din.

Formater titteldataene dine

  1. Åpne produktenes CSV-importmal lastet ned i forrige trinn (se ovenfor) – vi anbefaler å bruke Google Sheets.
  2. Hver rad er ett produkt (i Royalties HQ er en tittel ‘forelderen’ og den kan ha flere formater – vi kaller disse produkter).
  3. Hvert produkt må ha minst én produkt-ID som ISBN, ASIN eller annen produkt-ID (og disse må være unike).
  4. Alle andre felt er valgfrie.
  5. Når dataene dine er klare, lagre som en CSV. I Google Sheets er dette Fil > Last ned > CSV.

Når du formaterer dataene dine, må du følge disse kravene:

  • Du må formatere tall som tekst
  • Datoer må være i dette formatet: ÅÅÅÅ-MM-DD (f.eks. “30. desember 2020” må skrives inn som “2020-12-30”)
  • Nivåberegningstypen (tier-type-kolonnen) må være enten units-sold eller total-net-receipts (Mer informasjon om nivåer og nivåberegningstype finnes her).
KolonnenavnBeskrivelsePåkrevdFormat/Verdier
nameFullstendig boktittelJaTekststreng
title-codeUnik identifikator for tittelen (overordnet oppføring)JaAlfanumerisk (f.eks. T000047). Må være 7 tegn. Vil bli opprettet automatisk hvis tom.
royalty-period-start-monthStartmåned for royaltyberegningerJaEn måned enten stavet fullt ut eller forkortet (f.eks. “Jan” eller “Januar”)
royalty-period-lengthLengde på royaltyperiodeJamonthly, two-monthly, quarterly, six-monthly, annual
product-typeFormattype for denne utgavenJasoftcover, hardcover, ebook, audiobook, wire-bound
statusPubliseringsstatusJaactive, inactive, withdrawn
imprintForlagets imprint-navnNeiTekststreng
isbnISBN-13 for fysiske formaterBetinget*13-sifret ISBN uten bindestreker
asinAmazon Standard Identification NumberBetinget*10-tegns alfanumerisk
number-pagesSideantall for fysiske bøkerNeiHeltall (f.eks. 300)
legacy-units-soldHistoriske solgte enheter før bruk av Royalties HQNeiHeltall (f.eks. 250)
legacy-earned-royaltiesHistoriske royalties opptjent før bruk av Royalties HQNeiDesimaltall (f.eks. 16.95)
date-first-publishedOpprinnelig publiseringsdatoNeiÅÅÅÅ-MM-DD format
date-withdrawnDato formatet ble trukket fra salgNeiÅÅÅÅ-MM-DD format

*Minst én produkt-ID (ISBN, ASIN eller annen) er påkrevd for hvert produkt

Andre data

Tittelkoder

  • I Royalties HQ får hver tittel en unik identifikator – en tittelkode. Merk: en tittel er IKKE et ISBN.
  • Alle formater av samme bok deler samme tittelkode.
  • En tittelkode vil bli generert automatisk når du oppretter en ny tittel – enten via brukergrensesnittet eller via import. Du kan spesifisere en tittelkode ved import. Dette er viktig for å gruppere produkter under én tittel. For eksempel, hvis du importerer en ny utgave av en tittel, bør du importere den med den relevante tittelkoden.
  • Hvis du ikke spesifiserer en tittelkode ved import, vil alle nye produkter bli generert under nye titler.

Rettighetshavere

  • Må matche eksisterende rettighetshaverkoder i Royalties HQ.
  • Importer rettighetshavere først hvis de ennå ikke eksisterer i Royalties HQ.
  • La stå tom hvis ingen rettighetshaver er tildelt ennå.

Legacy-data

  • Valgfritt.
  • Bruk legacy-felt for å registrere historiske salg før du brukte Royalties HQ.
  • Disse beløpene er essensielle der en kontrakt bruker totale solgte enheter for å bestemme en rettighetshavers gjeldende royaltysats for et produkt (ISBN).

Ytterligere produkt-ID-er

  • Ytterligere produkt-ID inkluderer ACX, Google Play og mer – dette er valgfrie felt for å lagre alternative produktidentifikatorer
  • Bruk disse for proprietære koder, interne SKU-er eller egendefinerte identifikatorer som ikke er ISBN eller ASIN
  • Produkt-ID-er må være unike på tvers av alle produkter
  • Dette feltet er nyttig for å spore titler i flere systemer

Språk

  • Språk er et valgfritt felt for å indikere språket til produktet
  • Bruk ISO 639-3 tre-bokstavs koder (f.eks. “eng” for engelsk, “deu” for tysk, etc.), eller vanlige engelske etiketter (“English”, “German”, etc.)
  • La stå tom hvis ikke relevant eller hvis språk ikke er relevant
  • Dette kan fylles ut automatisk via Google Books metadatahenting for nye produkter

Støtte for måned- og periodeformat

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

  • Fulle månedsnavn: “January”, “February”, “March”, etc.
  • Tre-bokstavers forkortelser: “Jan”, “Feb”, “Mar”, etc.
  • Numerisk format: 1-12 (f.eks. 3 for mars)

Last opp produkt-CSV-en din

Når du har dobbelsjekket produktdataene dine, kan du gå videre og importere dem til Royalties HQ. Slik gjør du dette:

  1. Gå til hovedmenyen, øverst til venstre, og klikk Import.
  2. For typen, velg ‘Titler’.
  3. Under ‘Velg filen din’ klikk ‘Bla gjennom’ og naviger til CSV-filen din.
  4. Klikk ‘Neste’
  5. Filen vil bli lastet opp og validert (sjekket for problemer). Du vil se resultatene på en forhåndsvisningsside.
  6. Hvis resultatene ser bra ut, klikk ‘Fortsett’ og produktene vil bli importert (eller, hvis forhåndsvisningstrinnet fremhever problemer, må du fikse dataene – les feilmeldingen og sjekk kravene nedenfor).

Oppdater produkter i bulk

Du kan også bruke prosessen ovenfor til å oppdatere produkter i bulk.

CSV-importen vil matche eksisterende produkter på ISBN eller ASIN. Tomme felt vil bli ignorert; disse vil ikke overskrive eksisterende data.

Merk at alle nye produkt-ID-er (inkludert ISBN eller ASIN) i din CSV som ikke er i en rad med en gjenkjent produkt-ID vil resultere i et nytt produkt.