Telif geliri ekstrelerini CSV olarak dışa aktarma
Telif geliri ekstrelerinizi CSV dosyası olarak indirerek kazançlarınızı bir hesap tablosunda inceleyebilir, vergi dönemine hazırlanabilir veya ayrıntılı finansal kayıtlar tutabilirsiniz.
Başlamadan önce
Section titled “Başlamadan önce”- Ödenmiş en az bir telif geliri ekstresi olmalıdır (ekstreler, ilk ödemeniz işlendikten sonra görünür)
- CSV dosyasını açmak için Excel, Google Sheets veya Numbers gibi bir hesap tablosu uygulaması
Bir ekstre indirme
Section titled “Bir ekstre indirme”- Ana menüden Telif Gelirleri bölümüne gidin
- Ekstreler sekmesine geçin
- İndirmek istediğiniz ekstre dönemini bulun
- Ekstrenin yanındaki indirme düğmesine (ok simgesi) tıklayın
Sistem CSV dosyanızı oluşturur. Küçük ekstrelerde indirme hemen başlar. Büyük ekstrelerde, dosya hazırlanırken bir ilerleme göstergesi görürsünüz.
Dışa aktarma sırasında neler olur?
Section titled “Dışa aktarma sırasında neler olur?”Anında indirmeler
Section titled “Anında indirmeler”Çoğu ekstre için CSV anında hazır olur. Dosyayı kaydetmek üzere bir İndir düğmesi içeren bir pencere açılır.
Büyük ekstrelerin işlenmesi
Section titled “Büyük ekstrelerin işlenmesi”Çok sayıda satır içeren ekstrelerde sistem, dışa aktarmayı arka planda işler:
- Bir “Dışa Aktarma Hazırlanıyor” penceresi açılır
- Sistem dosyayı oluşturur (bu birkaç dakika sürebilir)
- Hazır olduğunda bir İndir düğmesi görünür
- Dosyayı kaydetmek için İndir düğmesine tıklayın
İndirilen dosyanın içeriği
Section titled “İndirilen dosyanın içeriği”İndirdiğiniz dosya, şunları içeren bir ZIP arşividir:
- CSV dosyası (dışa aktarma bölünecek kadar büyükse birden fazla CSV dosyası)
COLUMNS.txt, dosyadaki her sütunu açıklayan düz metin açıklama dosyası
Oluşturulan her dışa aktarma 24 saat boyunca saklanır. Aynı hesap, tarih aralığı ve gruplama için bu süre içinde yeniden istekte bulunursanız dosya yeniden oluşturulmaz; daha önce hazırlanan dosya size sunulur.
CSV sütun açıklamaları
Section titled “CSV sütun açıklamaları”CSV dosyasındaki her satır, telif geliri ekstrenizdeki tek bir satır kalemini temsil eder. Her sütunun anlamı aşağıda açıklanmıştır.
Temel sütunlar
Section titled “Temel sütunlar”| Sütun | Açıklama | Örnek |
|---|---|---|
pay_period | YYYYAA biçiminde ödeme dönemi | 202601 |
label | Plak şirketinizin adı | Midnight Records |
retailer | Platform adı | Spotify |
territory | Ülke veya bölge kodu | US, GB, DE |
type | İşlem türü | Stream, Download, UGC |
cat | Katalog numarası | MR-2026-001 |
upc | Yayım UPC barkodu | 840123456789 |
release | Yayım başlığı | Neon Skyline |
isrc | Parça ISRC kodu (her parça için benzersiz bir tanımlayıcı) | USRC12400001 |
track_artist | Sanatçı adı | Luna Rivera |
track_title | Parça başlığı | Golden Hour |
track_version | Sürüm veya remix bilgisi (yoksa boş) | Acoustic Version |
track_count | Parça sayısı | 1 |
purchase_qty | Stream veya satış sayısı | 4523 |
dsp_transaction_date | Platformdan gelen işlem tarihi | 2026-01-15 |
dsp_statement_id | Ekstre referans kimliği | SP-2026-0001 |
Gelir sütunları
Section titled “Gelir sütunları”Aşağıdaki örnekler standart bir stream satırını ve bir UGC satırını gösterir.
| Sütun | Açıklama | Stream satırı | UGC satırı |
|---|---|---|---|
gross_usd | O satırın USD cinsinden brüt geliri; LabelGrid ücretlerinden önceki tutar | 18.09000000 | 4.63000000 |
LabelGrid ücret sütunları
Section titled “LabelGrid ücret sütunları”| Sütun | Açıklama | Stream satırı | UGC satırı |
|---|---|---|---|
platform_fee_rate | Planınıza ait platform ücreti oranı | 0.05000000 (%5) | 0.00000000 |
platform_fee_usd | Platform ücreti tutarı (negatif değer olarak gösterilir) | -0.90450000 | 0.00000000 |
ugc_fee_rate | Planınıza ait UGC / Content ID ücreti oranı | 0.00000000 | 0.20000000 (%20) |
ugc_fee_usd | UGC / Content ID ücreti tutarı (negatif değer olarak gösterilir) | 0.00000000 | -0.92600000 |
total_labelgrid_fee | İki ücretin toplamı (negatif değer) | -0.90450000 | -0.92600000 |
net_revenue_usd | Tüm LabelGrid ücretlerinden sonra net kazancınız | 17.18550000 | 3.70400000 |
Teknik özellikler
Section titled “Teknik özellikler”Bu CSV dosyasını bir muhasebe yazılımına veya finans altyapısına entegre ediyorsanız, kesin biçim ayrıntıları aşağıdadır.
| Özellik | Değer |
|---|---|
| Kodlama | UTF-8 |
| Ayırıcı | Virgül (,) |
| Tırnak karakteri | Çift tırnak (") |
| Kaçış karakteri | Ters bölü (\) |
| Satır sonu | LF (\n) |
| Başlık satırı | İlk satır olarak her zaman bulunur |
| Toplam sütun | 23 (sabit sıra, yukarıdaki sütun açıklamalarına bakın) |
| Teslim biçimi | CSV dosyasını ve COLUMNS.txt açıklama dosyasını içeren ZIP arşivi |
Veri türleri ve hassasiyet
Section titled “Veri türleri ve hassasiyet”| Sütun grubu | Tür | Hassasiyet |
|---|---|---|
pay_period | Metin | YYYYAA (6 karakter) |
dsp_transaction_date | Metin | YYYY-AA-GG (10 karakter) |
purchase_qty | Tam sayı | Tam sayı |
gross_usd, *_fee_usd, net_revenue_usd | Ondalık | 8 ondalık basamağa kadar |
platform_fee_rate, ugc_fee_rate | Ondalık | 8 ondalık basamağa kadar (örneğin 0.05000000 = %5) |
| Diğer tüm sütunlar | Metin | Değişken uzunluk |
Gelir formülleri
Section titled “Gelir formülleri”total_labelgrid_fee = platform_fee_usd + ugc_fee_usdnet_revenue_usd = gross_usd + total_labelgrid_feeOtomatik ayrıştırmaya ilişkin notlar
Section titled “Otomatik ayrıştırmaya ilişkin notlar”- Boş alanlar:
track_versionvecatboş olabilir (art arda iki virgül) - Metin tırnaklama: Virgül veya tırnak içeren alanlar çift tırnak içine alınır. Alan değerlerinin içindeki çift tırnaklar dışa aktarma sırasında kaldırılır.
- Büyük dışa aktarmalar: 150 MB üzerindeki dışa aktarmalar birden fazla CSV dosyasına bölünür (her biri kendi başlık satırına sahip) ve ZIP arşivi olarak teslim edilir
- Sıralama: Satırlar önce
pay_periodazalan sırada, ardındandsp_transaction_dateazalan sırada düzenlenir
CSV’deki ücretleri anlamak
Section titled “CSV’deki ücretleri anlamak”Net gelir nasıl hesaplanır?
Section titled “Net gelir nasıl hesaplanır?”net_revenue_usd = gross_usd + total_labelgrid_feeÜcretler negatif değer olduğundan brüt tutarınızı azaltır. Aşağıda örnek dosyadan alınmış eksiksiz bir stream satırı yer alır; satır, %5’lik bir platform ücreti içerir:
| Tutar | |
|---|---|
Brüt gelir (gross_usd) | $18.09000000 |
| Platform ücreti (%5) | -$0.90450000 |
| UGC / Content ID ücreti | $0.00000000 |
| Net gelir | $17.18550000 |
Platform ücreti ile UGC ücreti ayrı kalemlerdir ve birbirine bindirilmez
Section titled “Platform ücreti ile UGC ücreti ayrı kalemlerdir ve birbirine bindirilmez”Bu dışa aktarmaya dayanan bir muhasebe defteri kuruyorsanız, en çok dikkat etmeniz gereken nokta budur.
- Her iki oran da aynı tutar üzerinden alınır.
- Hiçbir ücret, diğerinin sonucu üzerinden alınmaz. UGC ücreti, platform ücreti düşüldükten sonra kalan tutara uygulanmaz; platform ücreti de UGC ücreti düşüldükten sonra kalan tutara uygulanmaz.
- İki tutar toplanır:
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.
Her iki ücret türünü de içeren bir ekstrenin satırı için örnek hesap: aynı $100.00000000 tutara %5 platform oranı ve %20 UGC oranı uygulanıyor.
| Hesaplama | Doğru (toplamalı) | Yanlış (bindirmeli) |
|---|---|---|
| Platform ücreti | -$5.00000000 | -$5.00000000 |
| UGC / Content ID ücreti | -$20.00000000 ($100.00 tutarının %20’si) | -$19.00000000 ($95.00 tutarının %20’si) |
| Toplam LabelGrid ücreti | -$25.00000000 | -$24.00000000 |
Mutabakatı sağlayan, soldaki sütundur. %5’lik platform oranı ile %20’lik UGC oranı, bu tutar üzerinden toplam %25 kesinti demektir; bir oranı diğerinin kalanına uygulayarak bulacağınız %24 değil.
Her ücret hangi durumda görünür?
Section titled “Her ücret hangi durumda görünür?”UGC / Content ID ücreti, YouTube, TikTok ve SoundCloud gibi platformlardan gelen kullanıcı tarafından oluşturulan içerik (UGC) kazançlarına uygulanır. Spotify veya Apple Music gibi standart stream platformlarından gelen satırlarda ugc_fee_rate ve ugc_fee_usd değerleri 0.00 görünür.
Oranlar ekstre bazında belirlendiği için çoğu satırda oranlardan biri dolu, diğeri sıfırdır; bir ekstre genellikle tek türde kazanç içerir. Bir ekstrede iki tür bir arada bulunuyorsa, o ekstrenin bütün satırlarında iki oran da görünür ve yukarıdaki toplama kuralı geçerli olur. İki oran sütunundan tam olarak birinin sıfırdan farklı olduğunu varsaymayın; dolu olanların hepsini okuyup toplayın.
Ücretlerin dahil edilmesine ilişkin bilgi
Section titled “Ücretlerin dahil edilmesine ilişkin bilgi”Ücretler, Ekim 2024 ekstre döneminden itibaren CSV dışa aktarmalarına dahildir. Daha önceki ekstreler, ücret dökümü sütunları olmadan gelir verilerini gösterir.
Ekstre API’sinde ücretler
Section titled “Ekstre API’sinde ücretler”Ekstreleri CSV dışa aktarma yerine genel API üzerinden okuyorsanız, ekstre uç noktaları aynı dökümü üç ek alanla döndürür:
| Alan | Açıklama |
|---|---|
platform_fee_usd | Ekstrede tahsil edilen standart dağıtım ücreti |
ugc_fee_usd | Ekstrede tahsil edilen UGC / Content ID ücreti |
labelgrid_ugc_rate | Ekstre oluşturulduğunda geçerli olan UGC / Content ID ücret oranı |
Her iki tutar da negatiftir ve toplamları labelgrid_fee değerini verir. Ücretler, ekstrede mutabık kalınan tutarın tamamı üzerinden alınır; buna önceki dönemlerden devredilen bakiye de dahildir. Bu nedenle bir oranı yalnızca o dönemin kazançlarıyla çarpmak her zaman tutarı vermez; esas alınacak değerler tutarlardır.
Döküm kaydedilmeye başlanmadan önce oluşturulan ekstrelerde üç alan da null olur. null değerini sıfır olarak değil “döküm yok” olarak değerlendirin ve her durumda ücret toplamı için labelgrid_fee kullanmayı sürdürün.
Örnek bir CSV indirin
Section titled “Örnek bir CSV indirin”Kendi dosyanızı indirmeden önce dışa aktarmanın nasıl göründüğünü görmek ister misiniz? Örnek dosyamızı indirin:
Örnek dosya, birden fazla platform ve bölgedeki tipik satır kalemlerini gösteren yer tutucu veriler içerir ve yukarıda açıklanan 23 sütunlu düzeni kullanır. İçindeki her satır bu makaledeki formüllere uyar; bu sayede bir ayrıştırıcı geliştirirken dosyayı test verisi olarak kullanabilirsiniz.
Verilerle çalışmaya yönelik ipuçları
Section titled “Verilerle çalışmaya yönelik ipuçları”Google Sheets’te açma
Section titled “Google Sheets’te açma”- Google Sheets bölümüne gidin
- Dosya → İçe Aktar seçeneğine tıklayın
- CSV dosyanızı yükleyin
- Ayırıcı olarak “Virgül” seçeneğini belirleyin
- Verileri içe aktar seçeneğine tıklayın
Excel’de açma
Section titled “Excel’de açma”- Excel’i açın
- Dosya → Aç seçeneğine tıklayın ve CSV dosyasını seçin
- Excel, virgülle ayrılmış biçimi otomatik olarak algılar
Yaygın analiz fikirleri
Section titled “Yaygın analiz fikirleri”- Platform başına kazancı görmek için retailer alanına göre filtreleyin
- En güçlü pazarlarınızı bulmak için territory alanına göre özet tablosu oluşturun
- Toplam ekstre tutarınızı doğrulamak için net_revenue_usd sütununu toplayın
- En çok dinlenen parçalarınızı bulmak için purchase_qty alanına göre sıralayın
- Albüm performansını karşılaştırmak için release alanına göre gruplayın
Sorun giderme
Section titled “Sorun giderme”Dışa aktarma çok uzun sürüyor
Section titled “Dışa aktarma çok uzun sürüyor”Çok sayıda satır içeren büyük ekstrelerin oluşturulması daha uzun sürebilir. Sistem 5 dakikaya kadar yoklama yapar. Dışa aktarma zaman aşımına uğrarsa:
- Pencereyi kapatın
- Birkaç dakika bekleyin
- Yeniden indirmeyi deneyin
”Dışa Aktarma Sürüyor” hatası
Section titled “”Dışa Aktarma Sürüyor” hatası”Aynı anda yalnızca bir dışa aktarma işlemi yürütülebilir. Mevcut dışa aktarmanın bitmesini bekleyin, ardından yeniden deneyin.
CSV’de beklenmedik karakterler görünüyor
Section titled “CSV’de beklenmedik karakterler görünüyor”İçe aktarma sırasında hesap tablosu uygulamanızın UTF-8 kodlamasına ayarlı olduğundan emin olun. Bu, özel karakterler içeren sanatçı adlarının ve parça başlıklarının doğru görüntülenmesini sağlar.
Eksik ücret sütunları
Section titled “Eksik ücret sütunları”Ücret sütunları (platform_fee_rate, platform_fee_usd vb.) yalnızca Ekim 2024 ve sonrasındaki ekstre dönemleri için kullanılabilir. Daha önceki dönemler, ücret dökümü olmadan gelir verilerini gösterir.
İlgili rehberler
Section titled “İlgili rehberler”- Telif Geliri Raporlarını Anlamak: Telif geliri verilerinizi okuma
- Ödeme Takvimi: Telif gelirlerinin ne zaman ödendiği
- Vergi Bilgileri: Vergi hazırlığında dışa aktarma verilerini kullanma
Dışa aktarma konusunda yardıma mı ihtiyacınız var? Destek ekibimizle iletişime geçin.
LabelGrid’i henüz kullanmıyor musunuz?
Az önce okuduklarınızın tamamı platformumuzda mevcut.
LabelGrid’in neler yapabileceğini keşfedin →