README.md

---
title: AdCopy MAB OptimizerPro
emoji: ⚡
colorFrom: yellow
colorTo: gray
sdk: docker
pinned: false
---

# AdCopy MAB Optimizer Pro（FastAPI on HF Spaces）

## 起動チェック
- /api/health → {"status":"ok"}

## データ投入
POST /api/ingest に以下形式で投入：
{
  "rows": [
    {"date":"YYYY-MM-DD","medium":"FB","creative":"A1","is_control":1,"impressions":1000,"clicks":25,"conversions":3,"cost":800,"features_json":"{}"},
    ...
  ]
}

## 集計・最適化・因果
- GET  /api/aggregate
- POST /api/optimize  （Thompson Sampling 配分 + stop/boost判定）
- POST /api/uplift    （PyMC 階層ロジスティック uplift）

## UI
- ルート（/）で Gradio Dashboard
  - Data: Refresh で投入・集計を表示
  - Bandit: Suggest Allocation (TS)
  - Uplift (Causal): Fit Uplift Model

## ストレージ
- 既定の保存先: /tmp/adcopy_data（揮発）
- 永続化する場合: HF Spaces の Settings → Persistent Storage を ON
  - Variables に DATA_DIR=/data/adcopy_mab を追加

## 依存・ビルド
- Dockerfile は python:3.11-slim ベース、OpenBLAS/LAPACK を導入
- PyMC サンプリングはCPUで数十秒かかる場合があります