> ## 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

> L1 Data Hub'da haftalık medya verinizi yükleyin ve DQS kalite kontrolünü geçin.

# İ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`               |

<Warning>
  **PII YASAK!** Yükleyeceğiniz CSV'de **TCKN, isim, email, telefon, adres** içeren sütun olmamalıdır. KVKK Madde 5/2-c gereği reddedilir. Sadece **agregat haftalık** veri yükleyin.
</Warning>

### 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:

<Card title="Sample MMM Data İndir" icon="download" href="https://mmmytics.com/sample-data/sample-mmm-data.csv">
  52 hafta otomotiv sektör örneği — 6 kanal × `registrations` KPI. Gerçekçi seasonality + Q4 amplitude + Ramazan.
</Card>

```csv theme={null}
week,registrations,tv_spend,youtube_spend,google_ads_spend,meta_ads_spend,ooh_spend,print_spend
2025-01-06,150,99000,15000,30000,18000,30000,3500
2025-01-13,164,97898,16752,29776,20540,30000,700
...
```

## Adım 1 — Upload

`/dashboard/data` adresine gidin → **"Veri Yükle"** butonu:

<Steps>
  <Step title="Brand Seçimi">
    Üst menüden brand seçin (birden fazla brand'iniz varsa).
  </Step>

  <Step title="CSV Drag & Drop">
    Dosyanızı yükleme alanına sürükleyin veya **"Dosya Seç"** butonuyla yükleyin.

    **Maks dosya boyutu:** 50 MB
  </Step>

  <Step title="Preview">
    Sistem ilk 10 satırı önizleme olarak gösterir. Sütun adları ve veri tipleri doğru mu kontrol edin.
  </Step>

  <Step title="Kampanya Etiketi (Opsiyonel)">
    F4 Campaigns feature'ı ile kampanyaya bağlamak için `?campaign_id=<uuid>` query parametresi veya UI dropdown.

    Detay: [Kampanyalar](/docs/mintlify/campaigns)
  </Step>

  <Step title="Yükle">
    **"Yükle ve İşle"** butonuna basın → arka planda ETL pipeline çalışır (\~30 saniye).
  </Step>
</Steps>

## Adı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:

<CardGroup cols={2}>
  <Card title="Hafta Sayısı" icon="calendar">
    52+ hafta → tam puan, 26 hafta minimum.
  </Card>

  <Card title="Kanal Çeşitliliği" icon="layer-group">
    En az 4 kanal önerilir. Tek kanalda model güvenilirliği düşer.
  </Card>

  <Card title="Eksik Veri Oranı" icon="circle-exclamation">
    %5 altında olmalı. Eksik haftalar interpole edilemez (NaN bırakılır).
  </Card>

  <Card title="Outlier Tespit" icon="chart-scatter">
    Z-score > 3 olan haftalar uyarı. Düzeltme veya manuel onay gerekir.
  </Card>
</CardGroup>

### DQS İyileştirme Önerileri

Bronze veya Silver aldıysanız DQS panel'ı **iyileştirme önerilerini** gösterir:

```
🟡 Tier: Silver (78/100)
├─ ⚠️ Eksik kanal: "Affiliate" — eklenmesi önerilir
├─ ⚠️ 3 hafta outlier (2025-W11, W23, W34) — promo dönemi mi?
└─ ✅ Hafta sayısı: 52 (tam puan)

→ "Önerilen aksiyonları otomatik uygula" butonu (mevcut veriyi etkilemez, sadece annotation)
```

## 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:

```csv theme={null}
week,registrations,tv_spend,...,competitor_launch,promo_active
2025-03-15,180,...,1,0
2025-03-22,165,...,0,1
```

Bu sütunlar L2 Model Studio'da **bağlam değişkeni olarak** seçilebilir.

## 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 →](/docs/mintlify/getting-started/first-mmm-run)

***

## Sık Karşılaşılan Hatalar

<AccordionGroup>
  <Accordion title="❌ '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](/docs/mintlify/troubleshooting#upload-errors)
  </Accordion>

  <Accordion title="❌ '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).
  </Accordion>

  <Accordion title="❌ 'Encoding error' hatası">
    CSV UTF-8 encoding'de olmalı. Excel'den export ederken **"CSV UTF-8"** formatını seçin.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Multi-brand kuruluş

Organizasyonunuzda birden fazla marka varsa, ilk veri yüklemesinden önce hangi marka bağlamında çalıştığınızdan emin olun. **Settings → Benchmark Override** sekmesindeki marka seçici aktif bağlamı gösterir; veri yüklemeleri seçili marka altına kaydedilir, cross-brand karışım olmaz.

<Tip>
  Tek markalı organizasyonlarda marka seçici **gizlenir** (backward compatible). Sadece `brands.length > 1` koşulunda dropdown render edilir.
</Tip>

[Multi-brand portföy detayı →](/settings/multi-brand)