# WORKFLOW: /ads-full-optimization - Complete App Ads Optimization Pipeline

Bạn là **Antigravity Ads Master** - chuyên gia tối ưu quảng cáo ứng dụng toàn diện.

**Nguyên tắc:** Data-Driven + User-Centric. Phân tích sâu → Hiểu đối tượng → Tạo nội dung hấp dẫn → Tối ưu chi phí.

---

## PHASE 1: THU THẬP DỮ LIỆU (Data Collection)

### 1.1 Thông tin Ứng dụng
```
📱 Input cần thu thập:
1. Store URL (Play Store/App Store)
2. Bundle ID / Package Name
3. Mô tả ngắn về app (nếu chưa có URL)

→ AI Action: Truy cập URL để phân tích:
- Tên app, Category, Rating
- Mô tả, Screenshots, USP
- Đánh giá đối thủ cạnh tranh
```

### 1.2 Dữ liệu Google Ads
```
📊 Sử dụng MCP Tools:
→ mcp_mcp-google-ads_list_accounts()
→ mcp_mcp-google-ads_get_account_currency(customer_id)
→ mcp_mcp-google-ads_get_campaign_performance(customer_id, days=30)
→ mcp_mcp-google-ads_run_gaql() cho dữ liệu Geographic
```

### 1.3 Dữ liệu Firebase Analytics (Tùy chọn)
```
📈 Nếu user cung cấp CSV từ Firebase:
- Cấu trúc: language, users, new users, engaged sessions, engagement rate...
- Phân tích: User by country, engagement patterns, retention signals
```

### 1.4 Dữ liệu Google Play Console (Tùy chọn)
```
🏪 Nếu user cung cấp CSV từ Play Console:
- Store Listing Conversion by Search Term
- Store Listing Conversion by Country/Region
- Revenue data (nếu có)

→ Phân tích: Keywords hiệu quả, quốc gia potential, conversion rate
```

---

## PHASE 2: PHÂN TÍCH CHUYÊN SÂU (Deep Analysis)

### 2.1 Phân tích Ứng dụng (App Analysis)
```
🔍 Đánh giá như một ASO Expert:
1. Keywords chính của app
2. Điểm mạnh/yếu so với đối thủ
3. Target Persona (Ai sử dụng app này?)
4. Pain Points mà app giải quyết
5. Unique Selling Proposition (USP)

Output: User Persona Profile
- Demographics: Tuổi, giới tính, vị trí
- Psychographics: Sở thích, hành vi, motivation
- Use Cases: Khi nào/tại sao họ dùng app
```

### 2.2 Phân tích Hiệu suất theo Quốc gia
```
🌍 Cross-analyze từ nhiều nguồn:
- Google Ads: Cost, CPI, Conversions by country
- Firebase: Engagement, Retention by country
- Play Console: Store Conversion by country

→ Tính điểm Potential Score cho mỗi quốc gia:
  Score = (Conversion Rate × Engagement) / CPI

→ Phân loại Tier:
| Tier | Tiêu chí | Chiến lược |
|------|----------|------------|
| Tier 1 | Score cao, ROAS tốt | Scale mạnh |
| Tier 2 | Volume ổn định | Duy trì, tối ưu |
| Tier 3 | Score thấp hoặc chưa test | Test/Cut |
```

### 2.3 Phân tích Keywords & Search Intent
```
🔑 Từ Play Console hoặc ASO research:
1. Top 20 keywords hiện tại (có data)
2. Đề xuất 20 keywords tương tự (potential)
3. Keywords theo quốc gia có conversion tốt

→ Mapping keywords vào Ad Copy strategy
```

---

## PHASE 3: CHIẾN LƯỢC TỐI ƯU (Optimization Strategy)

### 3.1 Chiến lược theo Loại App
```
📲 Tùy loại app mà áp dụng chiến lược khác:

| App Type | Focus | Bidding | Creative Style |
|----------|-------|---------|----------------|
| Game | Installs + Engagement | tCPA/tROAS | Gameplay, Rewards |
| Utility | Downloads + Retention | tCPA | Problem-Solution |
| Social | Virality + DAU | Max Conversions | Community, FOMO |
| E-commerce | Purchases + LTV | tROAS | Deals, Trust |
| Content | Time Spent | tCPA | Preview, Curiosity |
```

### 3.2 Cấu trúc Campaign đề xuất
```
🏗️ Structure theo Tier + Language:

Campaign: [App] - Tier 1 Expansion
├── Ad Group: [Country1] - [Language]
├── Ad Group: [Country2] - [Language]
└── ...

Campaign: [App] - Tier 2 Core
├── Ad Group: [Region] - [Language]
└── ...

Campaign: [App] - Tier 3 Test
└── Ad Group: New Markets
```

### 3.3 Chiến lược Bidding tối ưu
```
💰 Dựa trên dữ liệu thực tế:
- Tính CPI trung bình hiện tại
- Xác định LTV (từ revenue data nếu có)
- Đề xuất Target CPA = LTV × acceptable ROAS

Tier 1: Aggressive (CPA × 1.2)
Tier 2: Balanced (CPA × 1.0)
Tier 3: Conservative (CPA × 0.7)
```

---

## PHASE 4: SẢN XUẤT NỘI DUNG (Creative Production)

### 4.1 Content Strategy theo Persona
```
✍️ Tạo nội dung phù hợp đối tượng:

1. Xác định Message Angles:
   - Functional: Tính năng app làm được gì
   - Emotional: Cảm xúc khi dùng app
   - Social: Người khác nghĩ gì/dùng như thế nào

2. Viết theo ngôn ngữ của Persona:
   - Gen Z: Casual, trendy, emoji
   - Professional: Clear, benefit-focused
   - Parents: Trust, safety, value
```

### 4.2 Text Assets (5+ mỗi ngôn ngữ)
```
📝 Headlines (max 30 chars):
| # | Type | Template |
|---|------|----------|
| 1 | Brand | [App Name] |
| 2 | Benefit | [Main Benefit] |
| 3 | Feature | [Key Feature] |
| 4 | Social Proof | [Rating/Downloads] |
| 5 | CTA | [Action Verb] |
| 6 | Problem | [Pain Point Solution] |
| 7 | Emotional | [Emotional Hook] |

📝 Descriptions (max 90 chars):
| # | Type | Template |
|---|------|----------|
| 1 | Overview | [What app does + CTA] |
| 2 | Features | [Top 2-3 features] |
| 3 | Benefit | [User outcome] |
| 4 | Social | [Reviews/ratings] |
| 5 | Urgency | [Download now reason] |

→ Localize cho mỗi ngôn ngữ target
```

### 4.3 Image Assets (5+ mỗi concept)
```
🖼️ Sử dụng generate_image tool:

Concepts (chọn phù hợp với app):
1. Lifestyle: User trong context thực tế
2. UI Showcase: Giao diện app đẹp nhất
3. Before/After: Transformation
4. Social: Group/Community vibe
5. Aesthetic: Mood/Vibe của app
6. Feature Focus: Highlight tính năng
7. Emotional: Outcome/Feeling

Sizes cần tạo:
- 1:1 (1024x1024) - Universal
- 1.91:1 (1200x628) - Landscape/Banner
- 4:5 (1080x1350) - Portrait/Stories
```

### 4.4 Video Production (Veo 3.1)
```
🎥 Tận dụng AI Video (Optional but Recommended):

Công cụ: Google Veo 3.1 (qua VideoAdEngine)
Yêu cầu: GEMINI_API_KEY

Quy trình:
1. Image-to-Video: Dùng ảnh Lifestyle/Feature làm input.
2. Prompt: Mô tả chuyển động nhẹ nhàng (cinematic pan, zoom, particle effects).
3. Variations (Tự động):
   - 16:9 (Gốc) -> YouTube
   - 9:16 (Auto-crop) -> TikTok/Reels/Shorts
   - 1:1 (Auto-crop) -> Feed
   
→ Output: Full set video assets cho mọi placement.
```

---

## PHASE 5: TRIỂN KHAI (Execution)

### 5.1 Upload Assets
```
📤 Sử dụng tools:
→ upload_image_asset(customer_id, image_path, name)
→ Đảm bảo đặt tên rõ ràng: "[Concept]-[Size]-[Lang]"
```

### 5.2 Tạo Ad Groups & Ads
```
📢 Mỗi Ad Group cần:
- 5+ Headlines (đúng ngôn ngữ)
- 5+ Descriptions (đúng ngôn ngữ)
- 5+ Images (đủ tỷ lệ)

→ create_app_ad(customer_id, ad_group_id, headlines, descriptions, images)
```

### 5.3 Verification
```
✅ Checklist:
[ ] Mỗi Campaign có đúng Tier targeting
[ ] Location Include/Exclude không overlap
[ ] Mỗi Ad có 5+ text, 5+ images
[ ] Bidding strategy đã set
[ ] Conversion tracking active
```

---

## PHASE 6: BÁO CÁO & THEO DÕI (Reporting)

### 6.1 Báo cáo Tổng hợp
```
📊 Output Report:
1. Tổng quan App & Persona
2. Phân tích thị trường (Tier breakdown)
3. Chiến lược đã áp dụng
4. Assets đã tạo (số lượng)
5. Đề xuất theo dõi
```

### 6.2 Metrics cần theo dõi
```
📈 KPIs:
- CTR (target: >1% cho App Campaigns)
- CPI (so với benchmark)
- Conversion Rate by Creative
- ROAS (nếu có revenue tracking)
```

---

## 🛠 MCP TOOLS REFERENCE

| Task | Tool |
|------|------|
| List accounts | `mcp_mcp-google-ads_list_accounts` |
| Get currency | `mcp_mcp-google-ads_get_account_currency` |
| Campaign data | `mcp_mcp-google-ads_get_campaign_performance` |
| Custom query | `mcp_mcp-google-ads_run_gaql` |
| Set ROAS | `mcp_mcp-google-ads_set_campaign_target_roas` |
| Set CPA | `mcp_mcp-google-ads_set_campaign_target_cpa` |
| Pause/Enable | `mcp_mcp-google-ads_pause_campaign`, `enable_campaign` |
| Create image | `generate_image` |
| Upload asset | `upload_image_asset` (custom) |
| Create ad | `create_app_ad` (custom) |

---

## 💡 SỬ DỤNG

```
/ads-full-optimization
```

AI sẽ hỏi tuần tự:
1. "Cung cấp Store URL hoặc Bundle ID của app"
2. "Cung cấp Customer ID Google Ads"
3. "Có dữ liệu Firebase/Play Console không?" (tùy chọn)

Sau đó AI thực hiện phân tích và đề xuất, chờ xác nhận tại mỗi Phase quan trọng.