LICENSE

# 매드업 광고행동유도요소 인식 모델 (MADUP Ad Action Element Detection Model)

## 공공 기여 프로젝트

이 프로젝트는 **매드업(MADUP)** 에서 개발한 광고행동유도요소 인식 모델로, 국내 광고 산업의 발전과 연구 커뮤니티의 성장을 위해 공공에 기여하고자 공개합니다.

## 성과

**한국정보통신기술협회(KOTCA) 인증 데이터셋** 에서 자체 평가 기준:

| 지표 | 성과 | 비고 |
|------|------|------|
| **mAP@50** | **0.81** | 리더보드 상위권 성능 |
| Precision | 0.83 | 높은 정확도 |
| Recall | 0.79 | 우수한 재현율 |
| 최적화 시도 | 211회 | Optuna 하이퍼파라미터 튜닝 |

## 모델 소개

광고 이미지에서 행동유도요소(Call-to-Action Elements)를 자동으로 인식하는 딥러닝 모델입니다.

### 주요 특징
- **고성능**: mAP@50 0.81 달성
- **최적화**: 211회 Optuna 하이퍼파라미터 튜닝
- **실용성**: 광고 디자인 분석 및 자동화에 활용 가능
- **개방성**: 연구 목적 무료 공개

### 인식 가능한 요소
- **텍스트**: 광고 문구 및 행동유도 텍스트
- **사각형**: 버튼 및 클릭 가능 영역
- **배너**: 프로모션 배너
- **캡슐**: 알약 형태의 UI 요소

## 빠른 시작

### 설치

```bash
pip install -r requirements.txt
```

### 기본 사용법

```python
from inference import AdElementDetector

# 모델 초기화
detector = AdElementDetector(model_path="best_model.pt")

# 이미지 분석
results = detector.predict("광고이미지.jpg")

# 결과 추출
boxes = detector.get_boxes(results)
print(f"검출된 광고요소: {len(boxes)}개")
```

### CLI 사용

```bash
# 기본 추론
python inference.py --image 광고이미지.jpg

# 시각화 저장
python inference.py --image 광고이미지.jpg --save 결과.jpg
```

## 모델 상세 정보

### 아키텍처
- **베이스 모델**: Deep Learning Object Detection
- **입력 크기**: 486x486 pixels
- **학습 에폭**: 120
- **최적화**: Optuna 211회 시도

### 최적화된 하이퍼파라미터

```yaml
imgsz: 486
lr0: 0.000515
dropout: 0.1
mixup: 0.15
copy_paste: 0.1
mosaic: 0.0
```

## 파일 구조

```
├── best_model.pt       # 학습된 모델 가중치 (50MB)
├── inference.py        # 추론 스크립트
├── config.yaml        # 모델 설정
├── data.yaml          # 데이터셋 설정
├── requirements.txt   # Python 의존성
└── README.md         # 문서
```

## 요구사항

- Python 3.8+
- PyTorch 1.8+
- CUDA 지원 GPU (권장)
- 4GB+ RAM

## 라이센스

**Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)**

- **허용**: 연구, 교육, 개인 프로젝트
- **금지**: 상업적 사용
- 상업적 사용 문의: pr_chapter@madup.com

## 기여

매드업은 한국 광고 기술 발전을 위해 이 모델을 공개합니다.

### 공공 기여 목적
- **연구 지원**: 학계 연구 활성화
- **산업 발전**: 광고 기술 혁신 촉진
- **커뮤니티 성장**: 오픈소스 생태계 기여

## 인용

연구에 사용하실 경우 아래와 같이 인용해 주세요:

```bibtex
@misc{madup_ad_detection_2024,
  title={MADUP 광고행동유도요소 인식 모델},
  author={MADUP Research Team},
  year={2024},
  publisher={HuggingFace},
  note={KOTCA 데이터셋 mAP@50: 0.81}
}
```

## 매드업 소개

**매드업(MADUP)** 은 데이터 기반 광고 기술 전문 기업으로, AI를 활용한 광고 최적화 솔루션을 제공합니다.

- 웹사이트: [https://www.madup.com](https://www.madup.com)
- 연구팀 문의: pr_chapter@madup.com
- LinkedIn: [MADUP Company](https://www.linkedin.com/company/madup)

## 문의

- 버그 리포트: Issues 탭
- 개선 제안: Pull Request
- 일반 문의: pr_chapter@madup.com

---

**Made with dedication by MADUP Research Team for the Korean AI Community**