Documentation Index
Fetch the complete documentation index at: https://docs.mmmytics.com/llms.txt
Use this file to discover all available pages before exploring further.
İlk Verinizi Yükleyin
İlk MMM modelinizi çalıştırmak için haftalık medya verinizi L1 Data Hub’a yüklemeniz gerekiyor. Bu sayfada hem örnek veri ile hem de kendi verinizle nasıl başlayabileceğinizi anlatıyoruz.CSV Format Şartları
MMMytics aşağıdaki CSV formatını bekler:| Sütun | Tip | Zorunlu | Açıklama |
|---|---|---|---|
week | Date (ISO 8601) | ✅ | Pazartesi tarihi (örn: 2025-01-06) |
<kpi> | Integer/Decimal | ✅ | Birincil KPI (örn: registrations, unit_sales, bookings) |
<channel>_spend | Integer/Decimal | ✅ | Kanal harcaması TL veya USD (örn: tv_spend, youtube_spend) |
| Bağlam değişkenleri | mixed | Opsiyonel | fx_usd_try, competitor_index, holiday_flag |
Asgari Şartlar
- Minimum 26 hafta (6 ay) — daha kısa süre için MMM güvenilir değil
- Önerilen 52+ hafta (1+ yıl) — seasonality öğrenmek için
- En az 2 medya kanalı + 1 KPI
Sample Data ile Deneme
Henüz kendi veriniz yoksa örnek veri ile başlayabilirsiniz:Sample MMM Data İndir
52 hafta otomotiv sektör örneği — 6 kanal ×
registrations KPI. Gerçekçi seasonality + Q4 amplitude + Ramazan.Adım 1 — Upload
/dashboard/data adresine gidin → “Veri Yükle” butonu:
CSV Drag & Drop
Dosyanızı yükleme alanına sürükleyin veya “Dosya Seç” butonuyla yükleyin.Maks dosya boyutu: 50 MB
Preview
Sistem ilk 10 satırı önizleme olarak gösterir. Sütun adları ve veri tipleri doğru mu kontrol edin.
Kampanya Etiketi (Opsiyonel)
F4 Campaigns feature’ı ile kampanyaya bağlamak için
?campaign_id=<uuid> query parametresi veya UI dropdown.Detay: KampanyalarAdım 2 — DQS (Data Quality Score) Kontrolü
Upload tamamlanınca DQS otomatik hesaplanır:| Tier | Skor | Anlam | Etki |
|---|---|---|---|
| 🥇 Gold | 90-100 | Çok kaliteli veri | Model kararsızlığı düşük, sonuç güvenilir |
| 🥈 Silver | 70-89 | Kabul edilebilir | Bazı zayıflıklar, bağlam değişkeni eklenmesi önerilir |
| 🥉 Bronze | 50-69 | Düşük kalite | Model çalışır ama R-hat veya MAPE eşiği aşabilir |
| ❌ Below Min | < 50 | Yeterli değil | Yükleme reddedilir, eksik kanal/hafta uyarı verilir |
DQS Faktörleri
DQS skorunuza katkı eden 5 faktör:Hafta Sayısı
52+ hafta → tam puan, 26 hafta minimum.
Kanal Çeşitliliği
En az 4 kanal önerilir. Tek kanalda model güvenilirliği düşer.
Eksik Veri Oranı
%5 altında olmalı. Eksik haftalar interpole edilemez (NaN bırakılır).
Outlier Tespit
Z-score > 3 olan haftalar uyarı. Düzeltme veya manuel onay gerekir.
DQS İyileştirme Önerileri
Bronze veya Silver aldıysanız DQS panel’ı iyileştirme önerilerini gösterir:Adım 3 — Bağlam Değişkenleri (Opsiyonel)
Modelin dış faktörleri (FX, enflasyon, Ramazan, rakip aktivite) dikkate alması için bağlam değişkenleri eklenir:Otomatik (Sistem Tarafından)
Sistem bu değişkenleri otomatik ekler:- FX (USD/TRY) → TCMB haftalık veri (Pazartesi)
- CPI (Enflasyon) → TCMB EVDS3 aylık endeks
- Ramadan Index → 9-hafta amplitude (Türkiye takvimi)
- Public Holidays → Türkiye resmi tatiller flag
Manuel (Kullanıcı Tarafından)
Custom değişkenler için CSV’nize ek sütun:Sonraki Adım
DQS Gold veya Silver aldınız mı? L2 Model Studio’da blueprint oluşturma zamanı: İlk MMM Modelinizi Çalıştırın →Sık Karşılaşılan Hatalar
❌ 'PII detected' hatası alıyorum
❌ 'PII detected' hatası alıyorum
CSV’nizde TCKN/email/isim sütunu var. Bunları çıkarın, sadece agregat haftalık spend + KPI bırakın.Detay: Sorun Giderme — Upload Errors
❌ 'Insufficient weeks' hatası
❌ 'Insufficient weeks' hatası
Minimum 26 hafta gerekli. Haftalık değil günlük veri varsa Excel’de pivot ile haftalık aggregate edin (haftanın başı Pazartesi).
❌ 'Encoding error' hatası
❌ 'Encoding error' hatası
CSV UTF-8 encoding’de olmalı. Excel’den export ederken “CSV UTF-8” formatını seçin.
DQS skoru Bronze, devam edeyim mi?
DQS skoru Bronze, devam edeyim mi?
Evet, Bronze ile model çalışır ama R-hat veya MAPE eşiği aşabilir. Silver veya üzeri tavsiye edilir. DQS panelindeki önerileri uygulayıp tekrar yükleyebilirsiniz.