> ## 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 MMM Modelinizi Çalıştırın

> L2 Model Studio'da blueprint oluştur, L3 Engine'de Bayesian MCMC run, L4-L7 ile sonuçları yorumla.

# İlk MMM Modelinizi Çalıştırın

Verileriniz L1 Data Hub'da yüklü. Şimdi sırada **ilk Marketing Mix Modeli'nizi** canlı çalıştırmak — yaklaşık **10 dakika** içinde sonuç alacaksınız.

## Genel Akış

```
L2 Model Studio    →    L3 Engine    →    L4 Channels    →    L5 Budget    →    L7 Reports
   (5 dk setup)         (~3 dk MCMC)        (analiz)             (10 dk)         (1 dk PDF)
```

## Adım 1 — L2 Model Studio: Blueprint Oluştur

`/dashboard/model` adresine gidin → **"Yeni Blueprint Oluştur"**.

### Sektör Template Seçimi

<CardGroup cols={3}>
  <Card title="Otomotiv">
    KPI: registrations, dealer\_inquiries
    Kanallar: TV, YouTube, Google, Meta, OOH, Print
    Bağlam: FX, Ramadan, competitor\_launch
  </Card>

  <Card title="FMCG">
    KPI: unit\_sales, market\_share
    Kanallar: TV, OLV, CTV, Shopper, Trade
    Bağlam: Ramadan amplitude (yüksek), promo\_active
  </Card>

  <Card title="Retail">
    KPI: gross\_sales, footfall
    Kanallar: TV, Display, Search, Email, OOH
    Bağlam: holiday\_flag, weather\_index
  </Card>

  <Card title="Telco">
    KPI: net\_subs\_gain, mnp\_in
    Kanallar: TV, Digital, Out-of-Home, Print
    Bağlam: competitor\_promo, churn\_pressure
  </Card>

  <Card title="Finans">
    KPI: applications, funded\_loans
    Kanallar: TV, Search, Display, OOH, Branch
    Bağlam: interest\_rate, fx\_volatility
  </Card>

  <Card title="Hizmet (B2C)">
    KPI: bookings, conversions
    Kanallar: Search, Social, Display, OOH
    Bağlam: weather, seasonal\_index
  </Card>
</CardGroup>

<Tip>
  Sektörünüz listede yoksa **"Özel Sektör (Custom)"** seçin. 3-step wizard ile kendi kanal config'inizi oluşturabilirsiniz. [Custom Sector →](/docs/mintlify/custom-sector)
</Tip>

### Adstock & Saturation Defaults

Her sektör template'i için **adstock** (etkinin zaman boyunca azalması) ve **saturation** (artan harcamanın azalan getirisi) varsayılanları otomatik gelir:

| Kanal      | Adstock (decay)               | Saturation (S-shape steepness) |
| ---------- | ----------------------------- | ------------------------------ |
| TV         | 0.7 (yavaş azalır, uzun etki) | 0.5 (orta)                     |
| YouTube    | 0.4 (orta)                    | 0.6 (orta-yüksek)              |
| Google Ads | 0.2 (hızlı, instant)          | 0.7 (hızlı doygun)             |
| Meta Ads   | 0.3 (hızlı)                   | 0.6                            |
| OOH        | 0.6 (yavaş)                   | 0.4 (geç doygun)               |
| Print      | 0.5 (orta)                    | 0.3 (geç doygun)               |

Bu değerler **ileri seviye kullanıcı** tarafından customize edilebilir (Detay panel → "Advanced Settings").

### Bağlam Değişkenleri Confirm

Sistem otomatik (FX, CPI, Ramadan) + sizin manuel eklediğiniz değişkenleri listeler. Tick ile model'a eklenir.

### Blueprint Save

**"Initialize MMM"** → blueprint kaydedilir, L3 Engine'e geçilir.

## Adım 2 — L3 Engine: Bayesian MCMC Run

`/dashboard/engine` adresine gidin → **"Run Model"** butonu.

### Run Trigger

```
Status timeline (sayfada canlı):
  📤 Queued (5 saniye içinde)
  ⚙️  Running (~2-3 dk L4 GPU MCMC)
  ✅ Completed (sonuç hazır)
```

<Frame>
  <Tip>
    İlk run **L4 GPU cold-start** için 30-60 saniye uzayabilir. İkinci run sıcak makine kullanır, daha hızlıdır (\~90 saniye).
  </Tip>
</Frame>

### Diagnostics — Sonuç Güvenilir mi?

Run tamamlandığında 3 kritik metrik kontrol edin:

| Metrik                   | Hedef   | Anlamı                           |
| ------------------------ | ------- | -------------------------------- |
| **R-hat (Gelman-Rubin)** | \< 1.05 | MCMC zincir converge mı?         |
| **MAPE**                 | \< 30%  | Tahmin hatası ne? Düşük daha iyi |
| **HMC tree depth**       | \< 10   | Sampler verim nasıl?             |

<AccordionGroup>
  <Accordion title="❌ R-hat > 1.05 alıyorum, ne yapmalıyım?">
    MCMC converge etmemiş. Sebepler:

    * Veri kalitesi düşük (DQS Bronze) → DQS önerilerini uygula, tekrar yükle
    * Adstock/saturation aşırı uç değer → defaults kullan
    * Bağlam değişkeni eksik → CPI/FX/Ramadan otomatik ekli mi kontrol et

    Çözüm: DQS Silver+ ile tekrar çalıştır. Sürekli sorun varsa `destek@mmmytics.com`.
  </Accordion>

  <Accordion title="❌ MAPE > 30%, model güvenilir mi?">
    Hayır, %30+ MAPE büyük tahmin hatası demek. Sebepler:

    * Eksik majör kanal (örn: Influencer veya Affiliate)
    * Yapısal değişiklik (rebrand, fiyat şoku) — modelde yer yok
    * Outlier haftalar var

    L4 Channels Intelligence'da **decomposition incompleteness** uyarısı görürsünüz. Veri zenginleştirmesi gerekli.
  </Accordion>

  <Accordion title="✅ Tüm metrikler yeşil, sonuca güvenebilir miyim?">
    Evet, R-hat \< 1.05 + MAPE \< 30% + HMC depth \< 10 → MCMC zinciri converge etmiş, model güvenilir.
  </Accordion>
</AccordionGroup>

## Adım 3 — L4 Channels Intelligence

`/dashboard/channels` → her kanalın **gerçek katkısını** görün:

<CardGroup cols={2}>
  <Card title="ROI per Channel" icon="dollar-sign">
    Effective marginal ROI: bir TL daha harcasanız beklenen ek gelir.

    **Örnek:** TV ROI 3.18, Google ROI 1.68 → marjinal TL TV'ye gitmeli.
  </Card>

  <Card title="Decomposition" icon="chart-pie">
    Gross sales'in % kaçı her kanaldan? Organik baseline + kanallar.

    **Örnek:** %45 organic, %20 TV, %15 Google, %10 Meta, %10 diğer.
  </Card>

  <Card title="Saturation Curves" icon="curve">
    S-shape: kanal hangi noktadan sonra doygunlaşıyor?

    Saturation curve üstünde **mevcut harcama nokt**ı işaretli — fazlaysa "diminishing return" alanına girmiş demektir.
  </Card>

  <Card title="Adstock Decay" icon="hourglass">
    Bir kampanyanın etkisi kaç hafta sürüyor?

    TV adstock 0.7 → bu hafta etkisinin %70'i sonraki haftaya, %49'u sonraki haftaya...
  </Card>
</CardGroup>

## Adım 4 — L5 Budget Optimizer

`/dashboard/budget` → **"Senaryo Oluştur"** butonu.

### Senaryo Tipleri

<Steps>
  <Step title="Same Total Budget, Optimized Allocation">
    Toplam bütçe değişmeden allocation'ı yeniden dağıt. Saturation + ROI aware.

    **Beklenen output:** "+%15 satış lift" gibi.
  </Step>

  <Step title="Budget +/- %X">
    Toplam bütçe %20 artar/azalırsa kanal allocation nasıl olmalı?

    Örnek: bütçe -%20 → TV'yi %30 azalt, Google'ı sabit tut.
  </Step>

  <Step title="Channel Mix Override">
    "TV bütçesini sabitleyip kalan'ı optimize et" — manuel constraint ile.
  </Step>
</Steps>

### Compare (M8/M16/M17 — Multi-run + Cross-channel)

**"Compare"** butonu ile 2+ senaryo yan yana:

* Channel allocation diff (waterfall chart)
* Beklenen ROI farkı
* Risk uyarısı (saturation aşımı)

Detay: [L5 Budget Optimizer](/docs/mintlify/6-istasyon/l5-budget)

## Adım 5 — L7 Reports: CEO Brief PDF

`/dashboard/reports` → **"Generate CEO Brief"**:

PDF içeriği (10 slayt):

1. Kapak
2. KPI Özeti
3. 3 farklı bulgu (ROI delta, saturation uyarısı, scenario lift)
4. Top 3 channels table
5. Optimum bütçe table
6. Pazar konjonkturu (FX + CPI + holiday)
7. DQS breakdown
8. Model performansı (R-hat + MAPE)
9. Risk uyarıları
10. Sonraki adımlar

**Download** → 1 MB civarı PDF, mail forward'a hazır.

## Tebrikler! 🎉

İlk MMM modelinizi başarıyla çalıştırdınız! Sıradaki adım:

<CardGroup cols={2}>
  <Card title="Daha Derine Git" icon="microscope" href="/docs/mintlify/6-istasyon/overview">
    6 İstasyon her birinin teknik detayı
  </Card>

  <Card title="Senaryo Karşılaştır" icon="scale-balanced" href="/docs/mintlify/6-istasyon/l5-budget">
    L5 Budget Optimizer derin dalış
  </Card>
</CardGroup>

***

## Yardım Lazım?

* 📖 [SSS](/docs/mintlify/faq) — sık sorulan sorular
* 🔧 [Sorun Giderme](/docs/mintlify/troubleshooting) — yaygın hatalar
* 📧 `destek@mmmytics.com` (P1 24h cevap)