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

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

始める前に

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

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

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

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

エクスポート中の動作

即時ダウンロード

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

大きな明細書の処理

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

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

ダウンロードファイルの内容

ダウンロードされるのは ZIP アーカイブで、次のものが含まれます。

CSV ファイル（エクスポートが大きく、分割された場合は複数の CSV ファイル）
COLUMNS.txt（CSV の各列を説明したテキストファイル）

生成されたエクスポートは 24 時間保持されます。この間にアカウント、期間、グループ化の条件が同じリクエストを再度行った場合は、生成し直すのではなく、作成済みのファイルが返されます。

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`

収益の列

以下の例では、通常のストリーミングの行と UGC の行を示しています。

列	説明	ストリーミングの行	UGC の行
`gross_usd`	その行の総収益（USD）。LabelGrid の手数料を差し引く前の金額です	`18.09000000`	`4.63000000`

LabelGrid 手数料の列

列	説明	ストリーミングの行	UGC の行
`platform_fee_rate`	ご利用プランのプラットフォーム手数料率	`0.05000000`（5%）	`0.00000000`
`platform_fee_usd`	プラットフォーム手数料額（マイナスの値で表示）	`-0.90450000`	`0.00000000`
`ugc_fee_rate`	ご利用プランの UGC / Content ID 手数料率	`0.00000000`	`0.20000000`（20%）
`ugc_fee_usd`	UGC / Content ID 手数料額（マイナスの値で表示）	`0.00000000`	`-0.92600000`
`total_labelgrid_fee`	上記 2 つの手数料の合計（マイナスの値）	`-0.90450000`	`-0.92600000`
`net_revenue_usd`	LabelGrid のすべての手数料を差し引いた後の最終的な収益	`17.18550000`	`3.70400000`

技術仕様

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

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

データ型と精度

列のグループ	型	精度
`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%）
その他すべての列	文字列	可変長

収益の計算式

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

手数料はマイナスの値なので、総収益から差し引かれます。以下は、プラットフォーム手数料が 5% の場合に、サンプルファイルのストリーミングの行がどう計算されるかを示したものです。

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

プラットフォーム手数料と UGC / Content ID 手数料の加算ルール

このエクスポートをもとに会計処理を行う場合は、ここを正確に理解しておく必要があります。

どちらの手数料も、同じ金額 を基準に計算されます。
一方の手数料を差し引いた残額に、もう一方の手数料が掛かることはありません。UGC / Content ID 手数料はプラットフォーム手数料を引いた残りに対して計算されるわけではなく、その逆も同様です。
2 つの金額は加算されます。total_labelgrid_fee = platform_fee_usd + ugc_fee_usd

1 つの明細書に両方の手数料区分が含まれる場合の計算例です。同じ $100.00000000 に対して、プラットフォーム手数料率 5%、UGC / Content ID 手数料率 20% とします。

計算	正しい方法（加算）	誤った方法（二重適用）
プラットフォーム手数料	-$5.00000000	-$5.00000000
UGC / Content ID 手数料	-$20.00000000（$100.00 の 20%）	-$19.00000000（$95.00 の 20%）
LabelGrid 手数料の合計	-$25.00000000	-$24.00000000

実際の金額と一致するのは左側の列です。プラットフォーム手数料率 5% と UGC / Content ID 手数料率 20% は、その金額に対して合計 25% の控除になります。一方の料率を適用した残額にもう一方の料率を適用すると 24% になりますが、これは誤りです。

各手数料が適用される範囲

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

料率は明細書ごとに決まります。1 つの明細書には通常 1 種類の収益しか含まれないため、ほとんどの行では一方の料率だけに値が入り、もう一方はゼロになります。両方の種別を含む明細書では、その明細書のすべての行に両方の料率が表示され、上記の加算ルールが適用されます。2 つの料率列のうち、必ず一方だけがゼロ以外になるとは限りません。値が入っている列をすべて読み取り、合計してください。

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

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

明細書 API での手数料

CSV エクスポートではなく公開 API から明細書を取得する場合、明細書のエンドポイントは同じ内訳を 3 つの追加フィールドで返します。

フィールド	説明
`platform_fee_usd`	その明細書で課される標準の配信手数料
`ugc_fee_usd`	その明細書で課される UGC / Content ID 手数料
`labelgrid_ugc_rate`	明細書の生成時点で適用されていた UGC / Content ID の料率

いずれの金額も負の値で、合計すると labelgrid_fee になります。手数料は、その明細書で精算される総額に対して発生し、これには過去の期間から繰り越された残高も含まれます。そのため、料率にその期間の収益だけを掛けても金額と一致しない場合があります。金額を正式な数値として扱ってください。

内訳が記録される前に生成された明細書では、3 つのフィールドはいずれも null です。null はゼロではなく「内訳なし」として扱い、いずれの場合も手数料の合計には labelgrid_fee を使い続けてください。

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

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

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

このサンプルには、複数のプラットフォームや地域にまたがる典型的な明細項目を示すダミーデータが含まれています。列の構成は、上記で説明した 23 列のレイアウトと同じです。すべての行が本記事の計算式どおりの値になっているため、パーサーを開発する際のテストデータとして利用できます。

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

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 月以降の明細期間でのみ利用できます。それ以前の期間には、手数料の内訳列のない収益データが表示されます。