# Ads Analytics Service - Dịch vụ Phân tích Quảng cáo

> Microservice cung cấp báo cáo, dashboard và insights cho chiến dịch quảng cáo.

## Tổng Quan

Ads Analytics Service tổng hợp và phân tích dữ liệu quảng cáo:

- **Real-time Reporting** - Báo cáo thời gian thực
- **Custom Reports** - Báo cáo tùy chỉnh theo nhu cầu
- **Audience Insights** - Phân tích đối tượng
- **Performance Insights** - Khuyến nghị tối ưu hóa

## Yêu Cầu

| Yêu cầu | Phiên bản |
|---------|-----------|
| .NET SDK | 10.0.101+ |
| Docker | 24.0+ |
| ClickHouse | 23.8+ (khuyến nghị) |
| PostgreSQL | 15+ |

## Bắt Đầu Nhanh

```bash
cd services/ads-analytics-service-net
docker-compose up -d
```

## Cấu Trúc Dự Án

```
ads-analytics-service-net/
├── src/
│   ├── AdsAnalyticsService.API/
│   │   ├── Controllers/
│   │   │   ├── MetricsController.cs
│   │   │   ├── ReportsController.cs
│   │   │   └── InsightsController.cs
│   │   └── Application/
│   │
│   ├── AdsAnalyticsService.Domain/
│   │   └── AggregatesModel/
│   │       ├── MetricsAggregate/
│   │       ├── ReportAggregate/
│   │       └── InsightAggregate/
│   │
│   └── AdsAnalyticsService.Infrastructure/
│
└── AdsAnalyticsService.slnx
```

## Metrics

| Metric | Mô tả |
|--------|-------|
| **Impressions** | Số lần hiển thị |
| **Clicks** | Số lần click |
| **CTR** | Click-through rate |
| **CPC** | Cost per click |
| **CPM** | Cost per 1000 impressions |
| **Conversions** | Số chuyển đổi |
| **CPA** | Cost per acquisition |
| **ROAS** | Return on ad spend |

## API Endpoints

### Metrics

| Method | Endpoint | Mô tả |
|--------|----------|-------|
| `GET` | `/api/v1/ads-analytics/campaigns/{id}/metrics` | Metrics chiến dịch |
| `GET` | `/api/v1/ads-analytics/adsets/{id}/metrics` | Metrics Ad Set |
| `GET` | `/api/v1/ads-analytics/ads/{id}/metrics` | Metrics Ad |

### Reports

| Method | Endpoint | Mô tả |
|--------|----------|-------|
| `GET` | `/api/v1/ads-analytics/reports` | Danh sách báo cáo |
| `POST` | `/api/v1/ads-analytics/reports` | Tạo báo cáo custom |
| `POST` | `/api/v1/ads-analytics/reports/schedule` | Lên lịch báo cáo |
| `GET` | `/api/v1/ads-analytics/reports/{id}/export` | Export báo cáo |

### Breakdown Dimensions

| Method | Endpoint | Mô tả |
|--------|----------|-------|
| `GET` | `/api/v1/ads-analytics/campaigns/{id}/breakdown?by=age` | Phân tích theo tuổi |
| `GET` | `/api/v1/ads-analytics/campaigns/{id}/breakdown?by=gender` | Phân tích theo giới tính |
| `GET` | `/api/v1/ads-analytics/campaigns/{id}/breakdown?by=placement` | Phân tích theo vị trí |
| `GET` | `/api/v1/ads-analytics/campaigns/{id}/breakdown?by=device` | Phân tích theo thiết bị |

### Insights

| Method | Endpoint | Mô tả |
|--------|----------|-------|
| `GET` | `/api/v1/ads-analytics/insights/audience` | Audience insights |
| `GET` | `/api/v1/ads-analytics/insights/performance` | Khuyến nghị tối ưu |

## Tích Hợp

| Service | Tích hợp |
|---------|---------|
| **ads-serving-service** | Consume impression/click data |
| **ads-tracking-service** | Consume conversion data |
| **ads-manager-service** | Campaign metadata |

## Cấu Hình

| Biến | Mô tả |
|------|-------|
| `DATABASE_URL` | PostgreSQL/ClickHouse connection |
| `RABBITMQ_URL` | RabbitMQ connection |

## Giấy Phép

Độc quyền - GoodGo Platform
