タイトルと商品のインポート
CSVアップロードを使用して、ISBN、メタデータ、出版の詳細を含む商品を一括インポートまたは更新します。
このページでは、新しい商品のインポートまたは既存の商品の更新のインポートのいずれであっても、タイトルをインポートする手順を説明します。
1つか2つの新しいタイトルのみを追加したい場合は、ユーザーインターフェースを使用することをお勧めします。ただし、タイトルとデータを一括でインポートしたい場合は、ここが適切な場所です。
商品はタイトルの特定の版であることに注意してください。例えば、タイトルは「My Book」と呼ばれ、複数のフォーマットがある場合があります：ソフトカバー、ハードカバー、電子書籍、オーディオブック。これらの各版/フォーマットは、Royalties HQでは商品として知られており、それぞれが独自の商品ID（例：ISBN）を持ちます。
商品は一括でインポートできます。CSVアップロード機能を使用します。テンプレートはRights holders > Importページからダウンロードできます。
タイトルインポートテンプレートをダウンロード
- 左上のメインメニューに移動し、TitlesをクリックしてからProductsをクリックします。
- 商品リストページで、Importボタンをクリックします。
- 'What are you uploading?'の下で、'Products’を選択します。
- この下で、**‘Download Products template file’**をクリックします。
- CSVファイルテンプレートがデバイスにダウンロードされます。
タイトルデータのフォーマット
- 前のステップでダウンロードした商品CSVインポートテンプレートを開きます（上記参照）。Google Sheetsの使用をお勧めします。
- 各行は1つの商品です（Royalties HQでは、タイトルは「親」であり、複数のフォーマットを持つことができます。これらを商品と呼びます）。
- 各商品には、ISBN、ASIN、またはその他の商品IDなど、少なくとも1つの商品IDが必要です（これらは一意である必要があります）。
- その他のすべてのフィールドはオプションです。
- データの準備ができたら、CSVとして保存します。Google Sheetsでは、これはFile > Download > CSVです。
データをフォーマットする際は、以下の要件に従う必要があります：
- 数値をテキストとしてフォーマットする必要があります
- 日付はこの形式である必要があります：YYYY-MM-DD（例：「December 30, 2020」は「2020-12-30」と入力する必要があります）
- 階層計算タイプ（tier-type列）は、units-soldまたはtotal-net-receiptsのいずれかである必要があります（階層と階層計算タイプに関する詳細情報はこちら）。
| Column Name | Description | Required | Format/Values |
|---|---|---|---|
| name | Full title of the book | Yes | Text string |
| title-code | Unique identifier for the title (parent record) | Yes | Alphanumeric (e.g., T000047). Must be 7 characters. One will be created automatically if left blank. |
| royalty-period-start-month | Starting month for royalty calculations | Yes | A month either spelled in full or abbreviated (e.g. “Jan” or “January”) |
| royalty-period-length | Length of royalty period | Yes | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | Format type of this edition | Yes | softcover, hardcover, ebook, audiobook, wire-bound |
| status | Publication status | Yes | active, inactive, withdrawn |
| imprint | Publisher imprint name | No | Text string |
| isbn | ISBN-13 for physical formats | Conditional* | 13-digit ISBN without hyphens |
| asin | Amazon Standard Identification Number | Conditional* | 10-character alphanumeric |
| number-pages | Page count for physical books | No | Integer (e.g., 300) |
| legacy-units-sold | Historical units sold before using Royalties HQ | No | Integer (e.g., 250) |
| legacy-earned-royalties | Historical royalties earned before using Royalties HQ | No | Decimal (e.g., 16.95) |
| date-first-published | Initial publication date | No | YYYY-MM-DD format |
| date-withdrawn | Date format was withdrawn from sale | No | YYYY-MM-DD format |
*各商品には少なくとも1つの商品ID（ISBN、ASIN、またはその他）が必要です
その他のデータ
タイトルコード
- Royalties HQでは、各タイトルに一意の識別子であるタイトルコードが与えられます。注意：タイトルはISBNではありません。
- 同じ書籍のすべてのフォーマットは、同じタイトルコードを共有します。
- タイトルコードは、ユーザーインターフェースまたはインポート経由で新しいタイトルを作成すると自動的に生成されます。インポート時にタイトルコードを指定できます。これは、1つのタイトルの下に商品をグループ化するために重要です。例えば、タイトルの新版をインポートする場合は、関連するタイトルコードでインポートする必要があります。
- インポート時にタイトルコードを指定しない場合、新しい商品はすべて新しいタイトルの下に生成されます。
権利者
- 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にインポートできます。手順は次のとおりです：
- 左上のメインメニューに移動し、Importをクリックします。
- タイプには、'Titles’を選択します。
- **‘Choose your file’の下で’Browse’**をクリックし、CSVファイルに移動します。
- **‘Next’**をクリックします
- ファイルがアップロードされ、検証（問題のチェック）されます。結果はプレビューページに表示されます。
- 結果が良好であれば、**‘Continue’**をクリックすると、商品がインポートされます（または、プレビューステップで問題が強調表示された場合は、データを修正する必要があります。エラーメッセージを読み、以下の要件を確認してください）。
商品を一括更新
上記のプロセスを使用して、商品を一括で更新することもできます。
CSVインポートは、ISBNまたはASINで既存の商品を照合します。空白フィールドは無視されます。これらは既存のデータを上書きしません。
認識された商品IDを含む行にないCSV内の新しい商品ID（ISBNやASINを含む）は、新しい商品になることに注意してください。