ロイヤリティ明細書を CSV にエクスポートする

ロイヤリティ明細書を CSV ファイルとしてダウンロードすれば、収益を表計算ソフトで分析したり、確定申告に備えたり、詳細な財務記録を残したりできます。

始める前に

支払い済みのロイヤリティ明細書が少なくとも 1 件必要です（明細書は最初の支払いが処理されると表示されます）
CSV ファイルを開くための表計算ソフト（Excel、Google スプレッドシート、Numbers など）

明細書をダウンロードする

メインメニューから ロイヤリティ を開きます
明細書 タブに移動します
ダウンロードしたい明細期間を見つけます
明細書の横にある ダウンロードボタン（矢印アイコン）をクリックします

CSV ファイルが生成されます。小さな明細書の場合はすぐにダウンロードが始まります。大きな明細書の場合は、ファイルを準備している間、進行状況が表示されます。

エクスポート中の動作

即時ダウンロード

ほとんどの明細書では、CSV はすぐに準備できます。ファイルを保存するための ダウンロード ボタンが付いたダイアログが表示されます。

大きな明細書の処理

明細項目が多い明細書の場合、システムはバックグラウンドでエクスポートを処理します。

「エクスポートを準備中」というダイアログが表示されます
システムがファイルを生成します（少し時間がかかる場合があります）
準備が整うと ダウンロード ボタンが表示されます
ダウンロード をクリックしてファイルを保存します

CSV 列のリファレンス

CSV の各行は、ロイヤリティ明細書の 1 件の明細項目を表します。各列の意味は次のとおりです。

基本の列

列	説明	例
`pay_period`	支払い期間（YYYYMM 形式）	`202601`
`label`	あなたのレーベル名	`Midnight Records`
`retailer`	プラットフォーム名	`Spotify`
`territory`	国または地域のコード	`US`、`GB`、`DE`
`type`	取引種別	`Stream`、`Download`、`UGC`
`cat`	カタログ番号	`MR-2026-001`
`upc`	リリースの UPC バーコード	`840123456789`
`release`	リリースタイトル	`Neon Skyline`
`isrc`	トラックの ISRC コード（各トラックの一意の識別子）	`USRC12400001`
`track_artist`	アーティスト名	`Luna Rivera`
`track_title`	トラックタイトル	`Golden Hour`
`track_version`	バージョンやリミックスの情報（該当しない場合は空欄）	`Acoustic Version`
`track_count`	トラック数	`1`
`purchase_qty`	ストリーム数または販売数	`4523`
`dsp_transaction_date`	プラットフォームから報告された取引日	`2026-01-15`
`dsp_statement_id`	明細書の参照 ID	`SP-2026-0001`

収益の列

列	説明	例
`gross_usd`	総収益（USD、明細提供元の手数料を差し引いた後の金額）	`18.09000000`

LabelGrid 手数料の列

列	説明	例
`platform_fee_rate`	あなたのプランに基づく LabelGrid のプラットフォーム手数料率	`0.05000000`（5%）
`platform_fee_usd`	LabelGrid のプラットフォーム手数料額（マイナスの値で表示）	`-0.90450000`
`ugc_fee_rate`	UGC プラットフォーム向けのユーザー生成コンテンツ手数料率	`0.20000000`（20%）
`ugc_fee_usd`	UGC プラットフォーム手数料額（マイナスの値で表示）	`-1.74400000`
`total_labelgrid_fee`	LabelGrid のすべての手数料の合計（マイナスの値）	`-2.18000000`
`net_revenue_usd`	すべての手数料を差し引いた後の最終的な収益	`17.18550000`

技術仕様

この CSV を会計ソフトや財務システムのバックエンドに連携する場合は、以下が正確なフォーマットの詳細です。

項目	値
エンコーディング	UTF-8
区切り文字	カンマ（`,`）
引用符	ダブルクォート（`"`）
エスケープ文字	バックスラッシュ（`\`）
改行コード	LF（`\n`）
ヘッダー行	常に先頭行に存在
列の総数	23（順序は固定。上記の列リファレンスを参照）

データ型と精度

列のグループ	型	精度
`pay_period`	文字列	`YYYYMM`（6 文字）
`dsp_transaction_date`	文字列	`YYYY-MM-DD`（10 文字）
`purchase_qty`	整数	整数値
`gross_usd`、`*_fee_usd`、`net_revenue_usd`	小数	小数点以下 8 桁まで
`platform_fee_rate`、`ugc_fee_rate`	小数	小数点以下 8 桁まで（例：`0.05000000` = 5%）
その他すべての列	文字列	可変長

収益の計算式

platform_fee_usd  = -1 × platform_fee_rate × gross_usd
ugc_fee_usd       = -1 × ugc_fee_rate × gross_usd
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd   = gross_usd + total_labelgrid_fee

自動解析のための注意点

空のフィールド：track_version と cat は空になることがあります（カンマが 2 つ連続します）
テキストの引用符付け：カンマや引用符を含むフィールドはダブルクォートで囲まれます。フィールド値内のダブルクォートはエクスポート時に削除されます。
大量のエクスポート：150 MB を超えるエクスポートは複数の CSV ファイル（それぞれにヘッダー行を含む）に分割され、ZIP アーカイブとして提供されます
並び順：行は pay_period の降順、次に dsp_transaction_date の降順で並びます

CSV 内の手数料を理解する

純収益の計算方法

net_revenue_usd = gross_usd + total_labelgrid_fee

手数料はマイナスの値なので、総収益から差し引かれます。例：

	金額
総収益	$18.09000000
プラットフォーム手数料（5%）	-$0.90450000
UGC 手数料	$0.00000000
純収益	$17.18550000

UGC プラットフォーム手数料

UGC 手数料は、YouTube、TikTok、SoundCloud といったユーザー生成コンテンツのプラットフォームにのみ適用されます。Spotify や Apple Music などの通常のストリーミングプラットフォームでは、ugc_fee_rate と ugc_fee_usd の列は 0.00 と表示されます。

手数料の表示開始時期について

手数料は 2024 年 10 月の明細期間から CSV エクスポートに含まれています。それ以前の明細書には、手数料の内訳列のない収益データが表示されます。

サンプル CSV をダウンロードする

自分の明細をダウンロードする前に、エクスポートの内容を確認したいですか？サンプルファイルをダウンロードできます。

サンプル CSV をダウンロード

このサンプルには、複数のプラットフォームや地域にまたがる典型的な明細項目を示すダミーデータが含まれています。

データを扱うためのヒント

Google スプレッドシートで開く

Google スプレッドシートを開きます
ファイル → インポート をクリックします
CSV ファイルをアップロードします
区切り文字として「カンマ」を選択します
データをインポート をクリックします

Excel で開く

Excel を開きます
ファイル → 開く をクリックして CSV ファイルを選択します
Excel がカンマ区切り形式を自動的に認識します

よくある分析の例

販売店（retailer）で絞り込み プラットフォームごとの収益を確認できます
地域別のピボットテーブル 最も強い市場を見つけられます
net_revenue_usd の合計 明細書の合計金額を検算できます
purchase_qty で並べ替え 最もストリームされたトラックを見つけられます
リリースでグループ化 アルバムのパフォーマンスを比較できます

トラブルシューティング

エクスポートに時間がかかりすぎる

明細項目の多い大きな明細書は、生成に時間がかかることがあります。システムは最長 5 分間ポーリングします。エクスポートがタイムアウトした場合：

ダイアログを閉じます
数分待ちます
もう一度ダウンロードを試します

「エクスポート処理中」エラー

エクスポートは同時に 1 件しか処理できません。現在のエクスポートが完了するのを待ってから、もう一度試してください。

CSV に文字化けが表示される

表計算ソフトの設定で、インポート時のエンコーディングが UTF-8 になっていることを確認してください。これにより、特殊文字を含むアーティスト名やトラックタイトルが正しく表示されます。

手数料の列が表示されない

手数料の列（platform_fee_rate、platform_fee_usd など）は、2024 年 10 月以降の明細期間でのみ利用できます。それ以前の期間には、手数料の内訳列のない収益データが表示されます。