Skip to main content

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.

​
L1 — Data Hub

/dashboard/data adresindeki ilk istasyon. Tüm MMM yolculuğunun temeli — veriniz buradan başlar.

​
Ne Yapar?

  • CSV upload — haftalık medya + KPI agregat verinizi yükler
  • PII detection — TCKN/email/isim/telefon içeren CSV’leri reddeder (KVKK)
  • DQS (Data Quality Score) — Gold/Silver/Bronze/Below-min tier hesaplar
  • Bağlam değişkenleri — FX, CPI, Ramadan otomatik enrichment
  • Kampanya etiketleme — F4 ile veri kampanya bazında organize edilebilir

​
CSV Format Şartları

SütunTipZorunlu
weekISO 8601 date (Pazartesi)✅
<kpi>numerik (registrations, unit_sales, vb.)✅
<channel>_spend (en az 2 kanal)numerik (TL veya USD)✅
<context_var> (custom)numerik veya stringOpsiyonel
Detaylı format kılavuzu →

​
Sekmeler

L1 Data Hub’ın 4 sekme yapısı vardır:

Veri Yükleme

CSV drag-and-drop + preview + DQS hesaplama. Yeni dataset eklemek için ana sekme.

Veri Kalitesi (DQS)

Mevcut datasetinizin DQS breakdown’ı (5 faktör) + iyileştirme önerileri. Tier histogram.

Bağlam Değişkenleri

Otomatik FX/CPI/Ramadan + manuel custom değişkenleri yönet. Backfill durumu (last sync).

Kampanyalar

F4 — kampanya CRUD, dataset’lere kampanya etiketi atama. Engine filter ile çalışır.

​
DQS — Detaylı Bakış

DQS skorunun 5 faktörü:
FaktörAğırlıkHesaplama
Hafta Sayısı25%26 hafta = 50, 52+ hafta = 100, lineer interpolasyon
Kanal Çeşitliliği20%2 kanal = 50, 6+ kanal = 100
Eksik Veri Oranı25%%0 = 100, %5 = 75, %10 = 50, %20+ = 0
Outlier Ratio15%Z-score > 3 hafta sayısı / toplam (ters orantılı)
Bağlam Değişken Coverage15%FX + CPI + Ramadan otomatik = 60, custom +40
Toplam = ağırlıklı toplamı. Tier mapping:
  • 90-100 → 🥇 Gold (model güvenilir)
  • 70-89 → 🥈 Silver (kabul edilebilir, öneriler var)
  • 50-69 → 🥉 Bronze (R-hat eşiği aşabilir, dikkatli yorumla)
  • < 50 → ❌ Below Min (yükleme reddedilir)

​
DQS Tier Önerileri

Tebrikler! Modeliniz çok güvenilir sonuç verir.
  • R-hat < 1.05 yüksek olasılık
  • MAPE genelde < 15-20%
  • Her istasyon yeşil indicator

​
Bağlam Değişkenleri (Contextual Variables)

MMM’nin doğru çalışması için dış faktörler kritik:

​
Otomatik Backfill

Sistem her hafta otomatik günceller:
DeğişkenKaynakCadence
FX (USD/TRY)TCMB EVDSPazartesi 06:00 UTC
CPI (Enflasyon)TCMB EVDS3Ayın 5’i 07:00 UTC
Ramadan IndexDiyanet takvim + 9-hafta amplitudePazartesi 06:30 UTC
Public HolidaysTürkiye resmi tatillerYıllık update
Yeni brand yarattığınızda 18-24 ay geriye doğru otomatik backfill yapılır.

​
Manuel Bağlam Değişkenleri

CSV’nize ek sütun olarak ekleyebilirsiniz: 
week,registrations,tv_spend,...,competitor_launch,promo_active
2025-03-15,180,...,1,0
2025-03-22,165,...,0,1
Bu sütunlar:
  • competitor_launch — rakip yeni model lansmanı (binary 0/1)
  • promo_active — kendi promosyon dönemi
  • weather_index — sıcaklık/yağış (Retail için)
  • interest_rate — faiz oranı (Finans için)
L2 Model Studio’da seçilebilir hale gelirler.

​
Veri Silme & Güncelleme

​
Tek Hafta Düzeltme

Yanlış girilmiş bir hafta varsa:
  1. L1 Data Hub → “Veri Yönetimi” sekmesi
  2. İlgili haftayı seç → “Düzelt”
  3. Yeni değerleri gir → kaydet
  4. Audit log otomatik update

​
Tüm Dataset Sil

destek@mmmytics.com üzerinden talep. KVKK Madde 5/2 kapsamında 48 saat içinde tüm copy’ler silinir (DB + storage + cache).

​
API Endpoint’leri

İleri seviye kullanıcılar için (programmatic upload): 
# Upload
curl -X POST https://api.mmmytics.com/api/v1/data/upload \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@my-data.csv" \
  -F "brand_id=$BRAND_UUID" \
  -F "campaign_id=$CAMPAIGN_UUID"

# DQS check
curl https://api.mmmytics.com/api/v1/data/dqs/$BRAND_UUID \
  -H "Authorization: Bearer $TOKEN"
Detay: API Reference (FastAPI Swagger)

​
Sonraki Adım

DQS Silver+ aldınız mı? L2 Model Studio’da blueprint zamanı: L2 Model Studio →