Mengekspor laporan royalti ke CSV

Unduh laporan royalti Anda sebagai file CSV untuk menganalisis pendapatan di spreadsheet, mempersiapkan musim pajak, atau menyimpan catatan keuangan terperinci.

Sebelum mulai

Anda harus memiliki minimal satu laporan royalti yang sudah dibayar (laporan muncul setelah pencairan pertama Anda diproses)
Aplikasi spreadsheet seperti Excel, Google Sheets, atau Numbers untuk membuka file CSV

Mengunduh laporan

Buka Royalti dari menu utama
Masuk ke tab Laporan
Cari periode laporan yang ingin Anda unduh
Klik tombol unduh (ikon panah) di samping laporan

Sistem akan membuat file CSV Anda. Untuk laporan berukuran kecil, unduhan langsung dimulai. Untuk laporan yang lebih besar, Anda akan melihat indikator progres selama file sedang disiapkan.

Apa yang terjadi selama ekspor

Unduhan instan

Untuk sebagian besar laporan, CSV langsung siap. Sebuah dialog akan muncul dengan tombol Unduh untuk menyimpan file.

Pemrosesan laporan besar

Untuk laporan dengan banyak baris data, sistem memproses ekspor di latar belakang:

Dialog “Menyiapkan Ekspor” muncul
Sistem membuat file (proses ini mungkin memerlukan beberapa saat)
Setelah siap, tombol Unduh muncul
Klik Unduh untuk menyimpan file

Referensi kolom CSV

Setiap baris dalam CSV mewakili satu baris data dari laporan royalti Anda. Berikut arti masing-masing kolom.

Kolom dasar

Kolom	Keterangan	Contoh
`pay_period`	Periode pembayaran dalam format YYYYMM	`202601`
`label`	Nama label Anda	`Midnight Records`
`retailer`	Nama platform	`Spotify`
`territory`	Kode negara atau wilayah	`US`, `GB`, `DE`
`type`	Jenis transaksi	`Stream`, `Download`, `UGC`
`cat`	Nomor katalog	`MR-2026-001`
`upc`	Barcode UPC rilis	`840123456789`
`release`	Judul rilis	`Neon Skyline`
`isrc`	Kode ISRC trek (pengenal unik untuk setiap trek)	`USRC12400001`
`track_artist`	Nama artis	`Luna Rivera`
`track_title`	Judul trek	`Golden Hour`
`track_version`	Informasi versi atau remix (kosong jika tidak ada)	`Acoustic Version`
`track_count`	Jumlah trek	`1`
`purchase_qty`	Jumlah pemutaran atau penjualan	`4523`
`dsp_transaction_date`	Tanggal transaksi dari platform	`2026-01-15`
`dsp_statement_id`	ID referensi laporan	`SP-2026-0001`

Kolom pendapatan

Kolom	Keterangan	Contoh
`gross_usd`	Pendapatan kotor dalam USD (setelah biaya penyedia laporan dipotong)	`18.09000000`

Kolom biaya LabelGrid

Kolom	Keterangan	Contoh
`platform_fee_rate`	Tarif biaya platform LabelGrid berdasarkan paket Anda	`0.05000000` (5%)
`platform_fee_usd`	Jumlah biaya platform LabelGrid (ditampilkan sebagai nilai negatif)	`-0.90450000`
`ugc_fee_rate`	Tarif biaya User-Generated Content untuk platform UGC	`0.20000000` (20%)
`ugc_fee_usd`	Jumlah biaya platform UGC (ditampilkan sebagai nilai negatif)	`-1.74400000`
`total_labelgrid_fee`	Total seluruh biaya LabelGrid (nilai negatif)	`-2.18000000`
`net_revenue_usd`	Pendapatan akhir Anda setelah semua biaya	`17.18550000`

Spesifikasi teknis

Jika Anda mengintegrasikan CSV ini ke perangkat lunak akuntansi atau sistem keuangan, berikut detail format yang persis.

Properti	Nilai
Encoding	UTF-8
Pemisah	Koma (`,`)
Karakter kutip	Tanda kutip ganda (`"`)
Karakter escape	Garis miring terbalik (`\`)
Akhir baris	LF (`\n`)
Baris header	Selalu ada sebagai baris pertama
Total kolom	23 (urutan tetap, lihat referensi kolom di atas)

Tipe data dan presisi

Kelompok kolom	Tipe	Presisi
`pay_period`	String	`YYYYMM` (6 karakter)
`dsp_transaction_date`	String	`YYYY-MM-DD` (10 karakter)
`purchase_qty`	Integer	Bilangan bulat
`gross_usd`, `*_fee_usd`, `net_revenue_usd`	Desimal	Hingga 8 angka di belakang koma
`platform_fee_rate`, `ugc_fee_rate`	Desimal	Hingga 8 angka di belakang koma (mis. `0.05000000` = 5%)
Semua kolom lainnya	String	Panjang bervariasi

Rumus pendapatan

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

Catatan untuk pemrosesan otomatis

Kolom kosong: track_version dan cat bisa kosong (dua koma berurutan)
Pengutipan teks: Kolom yang berisi koma atau tanda kutip diapit dengan tanda kutip ganda. Tanda kutip ganda di dalam nilai kolom dihapus selama ekspor.
Ekspor besar: Ekspor di atas 150 MB dipecah menjadi beberapa file CSV (masing-masing dengan baris header tersendiri) dan dikirim sebagai arsip ZIP
Pengurutan: Baris diurutkan berdasarkan pay_period menurun, lalu berdasarkan dsp_transaction_date menurun

Memahami biaya dalam CSV

Cara perhitungan pendapatan bersih

net_revenue_usd = gross_usd + total_labelgrid_fee

Karena biaya bernilai negatif, biaya akan mengurangi jumlah kotor Anda. Sebagai contoh:

	Jumlah
Pendapatan kotor	$18.09000000
Biaya platform (5%)	-$0.90450000
Biaya UGC	$0.00000000
Pendapatan bersih	$17.18550000

Biaya platform UGC

Biaya UGC hanya berlaku untuk platform User-Generated Content seperti YouTube, TikTok, dan SoundCloud. Untuk platform streaming standar seperti Spotify atau Apple Music, kolom ugc_fee_rate dan ugc_fee_usd akan menampilkan 0.00.

Pemberitahuan tentang pencantuman biaya

Biaya dicantumkan dalam ekspor CSV mulai dari periode laporan Oktober 2024. Laporan sebelumnya menampilkan data pendapatan tanpa kolom rincian biaya.

Mengunduh contoh CSV

Ingin melihat tampilan hasil ekspor sebelum mengunduh milik Anda sendiri? Unduh file contoh kami:

Unduh contoh CSV

Contoh ini berisi data placeholder yang menampilkan baris data umum dari berbagai platform dan teritori.

Tips bekerja dengan data

Membuka di Google Sheets

Buka Google Sheets
Klik File → Impor
Unggah file CSV Anda
Pilih “Koma” sebagai pemisah
Klik Impor data

Membuka di Excel

Buka Excel
Klik File → Buka dan pilih file CSV
Excel akan otomatis mendeteksi format yang dipisahkan koma

Ide analisis umum

Filter berdasarkan retailer untuk melihat pendapatan per platform
Tabel pivot berdasarkan teritori untuk menemukan pasar terkuat Anda
Jumlahkan net_revenue_usd untuk memverifikasi total jumlah laporan Anda
Urutkan berdasarkan purchase_qty untuk menemukan trek yang paling banyak diputar
Kelompokkan berdasarkan rilis untuk membandingkan performa album

Pemecahan masalah

Ekspor terlalu lama

Laporan besar dengan banyak baris data mungkin perlu waktu lebih lama untuk dibuat. Sistem melakukan polling hingga 5 menit. Jika ekspor mengalami waktu habis:

Tutup dialog
Tunggu beberapa menit
Coba unduh lagi

Galat “Ekspor Sedang Berlangsung”

Hanya satu ekspor yang dapat diproses dalam satu waktu. Tunggu hingga ekspor yang sedang berjalan selesai, lalu coba lagi.

CSV menampilkan karakter yang tidak terduga

Pastikan aplikasi spreadsheet Anda diatur ke encoding UTF-8 saat mengimpor. Ini memastikan nama artis dan judul trek yang mengandung karakter khusus ditampilkan dengan benar.

Kolom biaya tidak ada

Kolom biaya (platform_fee_rate, platform_fee_usd, dan sebagainya) hanya tersedia untuk periode laporan sejak Oktober 2024 dan setelahnya. Periode sebelumnya menampilkan data pendapatan tanpa rincian biaya.

Panduan terkait

Memahami Laporan Royalti - Cara membaca data royalti Anda
Jadwal Pembayaran - Kapan royalti dibayarkan
Informasi Pajak - Menggunakan data ekspor untuk persiapan pajak

Butuh bantuan dengan ekspor Anda? Hubungi tim dukungan kami.

Belum menggunakan LabelGrid?

Semua yang baru saja Anda baca tersedia di platform kami.

Lihat kemampuan LabelGrid →