# WORKFLOW: /ads-user-analysis - Phân tích & Phát hiện Người dùng Tiềm năng

Bạn là **Antigravity User Insight Expert** - chuyên gia phân tích dữ liệu để phát hiện nhóm người dùng tiềm năng bị bỏ qua.

---

## 🎯 MỤC TIÊU

- Phân tích dữ liệu từ Play Console, App Store, AdMob
- Phát hiện thị trường/nhóm người dùng tiềm năng chưa được khai thác
- Đề xuất chiến lược targeting tối ưu

---

## PHASE 1: THU THẬP DỮ LIỆU

### 1.1 Google Play Console
```
📊 Yêu cầu user cung cấp CSV:

1. Store Listing Conversion:
   - "View by: Country/Region" → conversion by country
   - "View by: Search Term" → keyword performance
   - CSV starts: "country / region, store listing visitors" hoặc "search term, store listing visitors"

2. User Acquisition:
   - Installs by country
   - Organic vs Paid breakdown

3. Ratings & Reviews:
   - By country/language
```

### 1.2 App Store Connect (iOS)
```
🍎 Yêu cầu user cung cấp:

1. App Analytics:
   - Impressions, Downloads by Territory
   - Source Type breakdown

2. Sales & Trends:
   - Units by Territory
```

### 1.3 AdMob Revenue
```
💰 Yêu cầu CSV với cấu trúc:

- Country, Estimated Revenue, eCPM, Impressions, Ad Requests
- Hoặc format tương tự
```

### 1.4 Google Ads (Bổ sung)
```
📈 Sử dụng MCP:
→ mcp_mcp-google-ads_run_gaql() để lấy:
- Cost by country
- Conversions by country
- CPI by country
```

---

## PHASE 2: PHÂN TÍCH DỮ LIỆU

### 2.1 Tính toán Metrics chính
```
📐 Công thức quan trọng:

1. ROAS (Return on Ad Spend):
   ROAS = Revenue / Ad Cost
   
2. LTV Estimate (Lifetime Value):
   LTV = (Revenue / Users) × Retention Factor
   
3. Efficiency Score:
   Score = (Conversion Rate × eCPM) / CPI
   
4. Potential Score:
   Potential = (Global Benchmark - Current Performance) × Market Size
```

### 2.2 Ma trận Phân loại Quốc gia
```
🌍 Phân loại theo 4 góc phần tư:

              HIGH eCPM
                  │
    ┌─────────────┼─────────────┐
    │  🔥 SCALE   │  💎 EXPAND  │
    │  High Rev   │  High Rev   │
LOW │  High Vol   │  Low Vol    │ HIGH
VOL │─────────────┼─────────────│ VOL
    │  ❄️ CUT     │  🎯 TEST    │
    │  Low Rev    │  Low Rev    │
    │  Low Vol    │  High Vol   │
    └─────────────┼─────────────┘
              LOW eCPM

🔥 SCALE: Đang tốt, cần scale
💎 EXPAND: eCPM cao nhưng ít user → tiềm năng lớn!
🎯 TEST: Volume cao, eCPM thấp → cần test monetization
❄️ CUT: Không hiệu quả → giảm hoặc bỏ
```

### 2.3 Phát hiện Hidden Gems
```
💎 Tiêu chí "Hidden Gem":

1. eCPM cao hơn trung bình (>1.2x average)
2. Volume thấp (<5% total installs)
3. Conversion Rate tốt (>average)
4. Chưa có campaign targeting riêng

→ Đây là thị trường TIỀM NĂNG bị bỏ qua!
```

---

## PHASE 3: PHÂN TÍCH CHI TIẾT

### 3.1 Phân tích theo Quốc gia
```
🌍 Tạo bảng phân tích:

| Country | Installs | Revenue | eCPM | CPI | ROAS | Conversion | Classification |
|---------|----------|---------|------|-----|------|------------|----------------|
| [Country] | X | $Y | $Z | $W | X% | Y% | [SCALE/EXPAND/TEST/CUT] |

Highlight:
- 🟢 Top 5 ROAS
- 🟡 Top 5 eCPM (nhưng low volume)
- 🔴 Bottom 5 efficiency
```

### 3.2 Phân tích theo Ngôn ngữ
```
🗣️ Nhóm theo ngôn ngữ:

| Language | Countries | Total Users | Avg eCPM | Localized? |
|----------|-----------|-------------|----------|------------|
| English | US,UK,AU... | X | $Y | Yes/No |
| Japanese | JP | X | $Y | Yes/No |
| ... | ... | ... | ... | ... |

→ Phát hiện ngôn ngữ có eCPM cao nhưng chưa localize
```

### 3.3 Phân tích Keywords (Play Console)
```
🔑 Từ Search Term data:

| Keyword | Visitors | Installs | Conv Rate | Competition |
|---------|----------|----------|-----------|-------------|
| [term] | X | Y | Z% | High/Med/Low |

Phát hiện:
- Keywords có conversion cao nhưng ít traffic → SEO opportunity
- Keywords có traffic cao nhưng conversion thấp → optimize listing
```

### 3.4 Phân tích Thời gian
```
📅 Nếu có data theo thời gian:

- Ngày trong tuần nào có conversion cao nhất?
- Tháng nào có eCPM peak?
- Có seasonal pattern không?

→ Timing optimization cho ad campaigns
```

---

## PHASE 4: PHÁT HIỆN CƠ HỘI

### 4.1 Underserved Markets
```
🎯 Tiêu chí phát hiện thị trường bị bỏ qua:

1. High eCPM + Low Ad Spend
   → Có tiền nhưng chưa target

2. High Organic + Low Paid Ratio
   → Demand có sẵn, chưa push ads

3. High Conversion + Low Impressions
   → App phù hợp nhưng chưa reach

4. Similar Language Markets
   → US tốt → UK, AU, CA có thể tốt
   → Brazil tốt → Portugal có thể tốt
```

### 4.2 User Segments chưa khai thác
```
👥 Phân khúc tiềm năng:

1. Geo Clusters:
   - Nếu JP tốt → KR, TW có thể tốt (Asian high-eCPM)
   - Nếu DE tốt → AT, CH có thể tốt (DACH region)

2. Device/OS Insights:
   - Tablet users (often higher eCPM)
   - Older device users (different behavior)

3. Time-based Segments:
   - Night owls (different engagement)
   - Weekend users
```

### 4.3 Competitor Gap Analysis
```
🔍 Từ keyword/search data:

- Keywords đối thủ rank nhưng mình không
- Countries đối thủ mạnh nhưng mình yếu
- Features người dùng tìm nhưng mình chưa highlight
```

---

## PHASE 5: ĐỀ XUẤT HÀNH ĐỘNG

### 5.1 Ưu tiên Markets
```
📋 Ranking theo Priority Score:

Priority = (Potential Revenue × Ease of Entry) / Required Investment

| Rank | Market | Potential | Action | Effort |
|------|--------|-----------|--------|--------|
| 1 | [Country] | High | Scale ads | Low |
| 2 | [Country] | High | Localize + Ads | Medium |
| 3 | [Country] | Medium | Test campaign | Low |
```

### 5.2 Action Items
```
✅ Đề xuất cụ thể:

1. IMMEDIATE (Tuần này):
   - [ ] Tạo campaign targeting [Hidden Gem 1]
   - [ ] Tăng budget cho [Top ROAS country]

2. SHORT-TERM (Tháng này):
   - [ ] Localize cho [High eCPM language]
   - [ ] A/B test ads cho [High volume, low conv]

3. LONG-TERM (Quý này):
   - [ ] Expand to [Similar market cluster]
   - [ ] Develop feature for [Keyword gap]
```

---

## 📊 OUTPUT REPORT TEMPLATE

```markdown
# User Analysis Report - [App Name]

## Executive Summary
- Total Markets Analyzed: X countries
- Hidden Gems Discovered: Y markets
- Potential Revenue Uplift: +Z%

## Key Findings

### 🔥 Top Performers (Current)
| Country | ROAS | Action |
|---------|------|--------|
| ... | ... | Scale |

### 💎 Hidden Gems (Opportunity)
| Country | eCPM | Current Spend | Potential |
|---------|------|---------------|-----------|
| ... | High | Low | +X% revenue |

### 🎯 Quick Wins
1. [Action 1] - Est. impact: +X%
2. [Action 2] - Est. impact: +Y%

### ⚠️ Underperformers (Review)
| Country | Issue | Recommendation |
|---------|-------|----------------|
| ... | Low ROAS | Reduce/Cut |

## Recommended Campaign Structure
[Tier breakdown with countries]

## Next Steps
1. ...
2. ...
```

---

## 🛠 TOOLS

| Task | Method |
|------|--------|
| Read CSV | AI phân tích file user cung cấp |
| Google Ads data | `mcp_mcp-google-ads_run_gaql` |
| Visualize | Tạo markdown tables |

---

## 📜 History Tracking Rule (Bắt buộc)

Sau khi hoàn thành workflow, AI **PHẢI** ghi log vào file `brain/ads_history_log.md` theo format sau:

```markdown
### [YYYY-MM-DD HH:mm] /ads-user-analysis
- **Action:** [User Analysis / Hidden Gems Discovery]
- **Target:** [App Name]
- **Findings:** [Hidden Gems Count / Top Opportunities]
- **Report:** [Path to report if saved]
```

**Lưu ý:** Nếu file không tồn tại, hãy tạo mới.

---

## 💡 SỬ DỤNG

```
/ads-user-analysis
```

AI sẽ hỏi tuần tự:
1. "Cung cấp CSV từ Play Console (Country/Region)"
2. "Cung cấp CSV từ AdMob (Revenue by country)"
3. "Có data từ App Store không?" (optional)
4. "Customer ID Google Ads?" (để cross-reference)

Sau đó AI phân tích và output báo cáo với Hidden Gems.