Veri Toplama Planı

Şarkı Çalma - Veri Toplama

Kullanıcı şarkı çaldığında hangi veriler toplanıyor?

29 Aralık 2025

Basit Anlatım (Herkes İçin)

Bir kullanıcı şarkı çalmaya başladığında, sistem şu bilgileri kaydeder:

Şarkı Bilgisi

Hangi şarkı çalındı?

Kullanıcı

Kim dinledi?

Zaman

Ne zaman çaldı?

Cihaz

Hangi cihaz/tarayıcıdan?

Teknik Detaylar (Geliştiriciler İçin)

Tablo: muzibu_song_plays

Field Type Açıklama Örnek
id bigint AUTO_INCREMENT Primary key 725
song_id bigint (FK) Çalınan şarkının ID'si 42
user_id bigint (FK, nullable) Dinleyen kullanıcı ID'si 1
ip_address varchar(45) Kullanıcının IP adresi 92.44.171.31
user_agent varchar(255) Tarayıcı user-agent string Mozilla/5.0 (Macintosh; Intel Mac OS X...)
device_type varchar(255) Cihaz tipi desktop / mobile / tablet
browser varchar(50) Tarayıcı adı Chrome / Safari / Firefox
platform varchar(50) İşletim sistemi macOS / Windows / iOS / Android
created_at timestamp Çalma başlangıç zamanı 2025-12-29 21:04:53

Veri Toplama Akışı

1

Kullanıcı şarkıya tıklar

Player şarkıyı çalmaya başlar

2

HLS stream başlar

/api/song/{id}/stream endpoint'i çağrılır

3

Jenssegers Agent cihaz bilgisini parse eder

User-Agent string'inden browser, platform, device_type çıkarılır

$agent = new Agent(); $agent->browser(); $agent->platform();
4

Veritabanına kayıt

INSERT INTO muzibu_song_plays (...)

Kaynak Kod Konumu

Modules/Muzibu/app/Http/Controllers/Api/SongStreamController.php :299
Modules/Muzibu/app/Http/Controllers/Api/SongController.php :204

Şu An Toplanmayan Ama Eklenebilecek Veriler

Dinleme Süresi

Şarkının ne kadarı dinlendi? (30 saniye mi, tamamı mı?)

Öneri: listened_duration (seconds)

Bitiş Zamanı

Şarkı ne zaman durdu/bitti?

Öneri: ended_at (timestamp)

Skip Bilgisi

Kullanıcı şarkıyı atladı mı?

Öneri: was_skipped (boolean)

Kaynak

Şarkı nereden çalındı? (Playlist, Album, Search?)

Öneri: source_type, source_id

Abuse Detection ile İlişki

Bu veriler AbuseDetectionService tarafından analiz edilir: