타이틀 및 상품 가져오기
CSV 업로드를 통해 ISBN, 메타데이터 및 출판 세부정보가 포함된 상품을 일괄 가져오거나 업데이트합니다.
이 페이지에서는 새 상품을 가져오거나 기존 상품에 대한 업데이트를 가져오든 타이틀을 가져오는 단계를 안내합니다.
하나 또는 두 개의 새 타이틀만 추가하려는 경우 사용자 인터페이스를 통해 이 작업을 수행하는 것을 선호할 수 있습니다. 그러나 타이틀과 데이터를 일괄로 가져오려는 경우 올바른 위치에 있습니다.
상품은 타이틀의 특정 에디션입니다. 예를 들어 타이틀은 "My Book"이라고 불릴 수 있으며 소프트커버, 하드커버, 전자책 및 오디오북과 같은 여러 형식이 있을 수 있습니다. 이러한 각 에디션/형식을 Royalties HQ에서 상품이라고 하며, 각각 자체 상품 ID(예: ISBN)를 갖습니다.
상품은 CSV 업로드 기능을 사용하여 일괄로 가져올 수 있습니다. 권리 보유자 > 가져오기 페이지에서 다운로드할 수 있는 템플릿이 있습니다.
타이틀 가져오기 템플릿 다운로드
- 왼쪽 상단의 메인 메뉴로 이동하여 타이틀, 그 다음 상품을 클릭합니다.
- 상품 목록 페이지에서 가져오기 버튼을 클릭합니다.
- ‘무엇을 업로드하고 있습니까?’ 아래에서 '상품’을 선택합니다.
- 이 아래에서 **‘상품 템플릿 파일 다운로드’**를 클릭합니다.
- CSV 파일 템플릿이 기기에 다운로드됩니다.
타이틀 데이터 형식 지정
- 이전 단계에서 다운로드한 상품 CSV 가져오기 템플릿을 엽니다(위 참조) – Google Sheets를 사용하는 것이 좋습니다.
- 각 행은 하나의 상품입니다(로열티 GQ에서 타이틀은 '상위’이며 여러 형식을 가질 수 있습니다 – 이를 상품이라고 합니다).
- 각 상품에는 ISBN, ASIN 또는 기타 상품 ID와 같은 최소 하나의 상품 ID가 있어야 합니다(그리고 이는 고유해야 합니다).
- 다른 모든 필드는 선택 사항입니다.
- 데이터가 준비되면 CSV로 저장합니다. Google Sheets에서 이것은 파일 > 다운로드 > CSV입니다.
데이터를 형식화할 때 다음 요구 사항을 따라야 합니다:
- 숫자를 텍스트로 형식화해야 합니다
- 날짜는 이 형식이어야 합니다: YYYY-MM-DD(예: "2020년 12월 30일"은 "2020-12-30"으로 입력해야 함)
- 계층 계산 유형(tier-type 열)은 units-sold 또는 total-net-receipts여야 합니다(계층 및 계층 계산 유형에 대한 자세한 정보는 여기를 참조).
| 열 이름 | 설명 | 필수 | 형식/값 |
|---|---|---|---|
| name | 책의 전체 제목 | 예 | 텍스트 문자열 |
| title-code | 타이틀(상위 레코드)의 고유 식별자 | 예 | 영숫자(예: T000047). 7자여야 합니다. 비워두면 자동으로 생성됩니다. |
| royalty-period-start-month | 로열티 계산 시작 월 | 예 | 전체 철자 또는 약어로 된 월(예: “Jan” 또는 “January”) |
| royalty-period-length | 로열티 기간 길이 | 예 | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | 이 에디션의 형식 유형 | 예 | softcover, hardcover, ebook, audiobook, wire-bound |
| status | 출판 상태 | 예 | active, inactive, withdrawn |
| imprint | 출판사 임프린트 이름 | 아니요 | 텍스트 문자열 |
| isbn | 물리적 형식의 ISBN-13 | 조건부* | 하이픈 없는 13자리 ISBN |
| asin | Amazon 표준 식별 번호 | 조건부* | 10자 영숫자 |
| number-pages | 물리적 책의 페이지 수 | 아니요 | 정수(예: 300) |
| legacy-units-sold | Royalties HQ를 사용하기 전에 판매된 과거 단위 | 아니요 | 정수(예: 250) |
| legacy-earned-royalties | Royalties HQ를 사용하기 전에 획득한 과거 로열티 | 아니요 | 소수(예: 16.95) |
| date-first-published | 초기 출판 날짜 | 아니요 | YYYY-MM-DD 형식 |
| date-withdrawn | 판매에서 철회된 형식 날짜 | 아니요 | YYYY-MM-DD 형식 |
*각 상품에는 최소 하나의 상품 ID(ISBN, ASIN 또는 기타)가 필요합니다
기타 데이터
타이틀 코드
- Royalties HQ에서 각 타이틀에는 고유 식별자인 타이틀 코드가 제공됩니다. 참고: 타이틀은 ISBN이 아닙니다.
- 동일한 책의 모든 형식은 동일한 타이틀 코드를 공유합니다.
- 타이틀 코드는 새 타이틀을 생성할 때 자동으로 생성됩니다. 사용자 인터페이스를 통하든 가져오기를 통하든 관계없습니다. 가져올 때 타이틀 코드를 지정할 수 있습니다. 이것은 하나의 타이틀 아래에 상품을 그룹화하는 데 중요합니다. 예를 들어 타이틀의 새 에디션을 가져오는 경우 관련 타이틀 코드로 가져와야 합니다.
- 가져올 때 타이틀 코드를 지정하지 않으면 새 상품이 새 타이틀 아래에 생성됩니다.
권리 보유자
- Royalties HQ의 기존 권리 보유자 코드와 일치해야 합니다.
- Royalties HQ에 아직 존재하지 않는 경우 먼저 권리 보유자를 가져옵니다.
- 아직 권리 보유자가 할당되지 않은 경우 비워 둡니다.
레거시 데이터
- 선택 사항입니다.
- 레거시 필드를 사용하여 Royalties HQ를 사용하기 전의 과거 판매를 기록합니다.
- 계약이 상품(ISBN)에 대한 권리 보유자의 현재 로열티율을 결정하기 위해 총 판매 단위를 사용하는 경우 이 금액은 필수적입니다.
추가 상품 ID
- 추가 상품 ID에는 ACX, Google Play 등이 포함됩니다 – 대체 상품 식별자를 저장하기 위한 선택적 필드입니다
- ISBN 또는 ASIN이 아닌 독점 코드, 내부 SKU 또는 사용자 정의 식별자에 사용합니다
- 상품 ID는 모든 상품에서 고유해야 합니다
- 이 필드는 여러 시스템에서 타이틀을 추적하는 데 유용합니다
언어
- 언어는 상품의 언어를 나타내는 선택적 필드입니다
- ISO 639-3 3자 코드(예: 영어의 경우 “eng”, 독일어의 경우 “deu” 등) 또는 일반 영어 레이블(“English”, “German” 등)을 사용합니다
- 해당하지 않거나 언어가 관련이 없는 경우 비워 둡니다
- 새 상품의 경우 Google Books 메타데이터 가져오기를 통해 자동으로 채울 수 있습니다
월 및 기간 형식 지원
royalty-period-start-month는 유연한 월 설명자를 지원합니다:
- 전체 월 이름: “January”, “February”, “March” 등.
- 3자 약어: “Jan”, “Feb”, “Mar” 등.
- 숫자 형식: 1-12(예: 3월의 경우 3)
상품 CSV 업로드
상품 데이터를 다시 확인했으면 Royalties HQ로 가져올 수 있습니다. 방법은 다음과 같습니다:
- 왼쪽 상단의 메인 메뉴로 이동하여 가져오기를 클릭합니다.
- 유형으로 '타이틀’을 선택합니다.
- ‘파일 선택’ 아래에서 **‘찾아보기’**를 클릭하고 CSV 파일로 이동합니다.
- **‘다음’**을 클릭합니다
- 파일이 업로드되고 유효성 검사(문제 확인)됩니다. 미리보기 페이지에서 결과를 확인할 수 있습니다.
- 결과가 좋아 보이면 **‘계속’**을 클릭하면 상품이 가져오기됩니다(또는 미리보기 단계에서 문제가 강조 표시되면 데이터를 수정해야 합니다 – 오류 메시지를 읽고 아래 요구 사항을 확인하세요).
상품 일괄 업데이트
위의 프로세스를 사용하여 상품을 업데이트할 수도 있습니다.
CSV 가져오기는 ISBN 또는 ASIN의 기존 상품과 일치합니다. 빈 필드는 무시됩니다. 기존 데이터를 덮어쓰지 않습니다.
인식된 상품 ID가 있는 행에 없는 CSV의 새 상품 ID(ISBN 또는 ASIN 포함)는 새 상품이 생성됩니다.