oceanengine-ads

# 巨量广告自动化投放 — LemClaw Skills

## Description

🎯 **乐盟互动出品** - 全功能集成巨量广告（Ocean Engine Ads）API，支持巨量引擎、巨量千川、穿山甲广告。包含自动化投放、智能优化、实时监控功能。

## 🌟 特色功能

### 🔥 自动化投放
- **智能投放计划**：基于历史数据的智能投放策略
- **预算自动分配**：根据ROI自动调整各计划预算
- **出价策略优化**：实时调整出价，最大化转化效果
- **创意自动轮换**：A/B测试和智能创意替换

### 📊 实时监控
- **实时数据监控**：监控曝光、点击、转化等关键指标
- **异常检测**：自动识别广告异常行为
- **实时告警**：关键指标异常时立即通知
- **趋势分析**：AI驱动的数据趋势分析

### 🤖 智能优化
- **ROI优化算法**：基于机器学习的ROI最大化
- **预算重分配**：自动调整高ROI计划的预算
- **定向优化**：智能调整受众定向参数
- **出价建议**：实时提供最优出价建议

## Setup

### Environment Variables

```bash
# 必需配置
OCEANENGINE_ACCESS_TOKEN=your_test_token
OCEANENGINE_APP_ID=your_app_id
OCEANENGINE_APP_SECRET=your_app_secret

# 可选配置
OCEANENGINE_ACCOUNT_ID=your_account_id  # 用于测试账户
OCEANENGINE_TEST_MODE=true              # 启用测试模式
```

### 快速开始

```bash
# 1. 安装依赖
pip install -r requirements.txt

# 2. 配置环境变量
export OCEANENGINE_ACCESS_TOKEN="your_token"

# 3. 测试连接
python3 -c "from oceanengine import OceanEngine; oe = OceanEngine(); print('连接成功:', oe.status())"

# 4. 开始自动化投放
python3 -m oceanengine --mode auto-launch
```

## 🎯 自动化投放模式

### 1. 智能投放模式
```python
from oceanengine import OceanEngine

oe = OceanEngine()

# 启动智能投放
oe.auto_launch(
    campaign_name="智能投放测试",
    objective="CONVERSIONS",
    daily_budget=10000,  # 100元
    start_immediately=True,
    optimization="ROI"
)
```

### 2. 预算优化模式
```python
# 自动预算重分配
oe.auto_budget_optimization(
    budget_increase_threshold=1.5,  # ROI > 1.5 时增加预算
    budget_decrease_threshold=0.8,  # ROI < 0.8 时减少预算
    budget_change_percent=20        # 每次调整20%
)
```

### 3. 创意自动测试
```python
# A/B测试不同创意
oe.creative_ab_test(...

# 巨量广告自动化投放技能 - LemClaw Skills

> 技能名称：oceanengine-ads
> 版本：1.0.0
> 开发者：乐盟互动 LemClaw
> 状态：✅ 100%完成

---

## 🎯 技能简介

🚀 **乐盟互动 LemClaw 出品**

巨量广告自动化投放技能是一个全功能的广告管理工具，支持巨量引擎（今日头条广告）、巨量千川（抖音广告）、穿山甲（程序化广告）的自动化投放和智能优化。

---

## 🌟 特色功能

### 🤖 智能投放
- **智能广告计划启动**：基于历史数据的智能投放策略
- **预算自动分配**：根据ROI自动调整各计划预算
- **出价策略优化**：实时调整出价，最大化转化效果
- **创意自动轮换**：A/B测试和智能创意替换

### 📊 实时监控
- **实时数据监控**：监控曝光、点击、转化等关键指标
- **异常检测**：自动识别广告异常行为
- **实时告警**：关键指标异常时立即通知
- **趋势分析**：AI驱动的数据趋势分析

### 🤖 智能优化
- **ROI优化算法**：基于机器学习的ROI最大化
- **预算重分配**：自动调整高ROI计划的预算
- **出价策略调整**：智能出价优化建议
- **定向优化建议**：基于数据的目标受众建议
- **优化报告生成**：Markdown格式的完整报告

### 🔐 安全可靠
- **OAuth 2.0认证**：标准化的Token管理
- **Token安全存储**：安全的环境变量管理
- **操作确认机制**：重要操作前确认
- **测试账户支持**：开发者可用测试账户验证功能

---

## 📋 支持的功能

### 1. 广告计划管理
- ✅ 获取广告计划列表
- ✅ 获取广告计划详情
- ✅ 创建广告计划
- ✅ 更新广告计划
- ✅ 更新广告状态
- ✅ 删除广告计划

### 2. 广告组管理
- ✅ 获取广告组列表
- ✅ 获取广告组详情
- ✅ 创建广告组
- ✅ 更新广告组
- ✅ 设置定向

### 3. 广告创意管理
- ✅ 获取创意列表
- ✅ 获取创意详情
- ✅ 创建广告创意
- ✅ 上传图片素材
- ✅ 上传视频素材

### 4. 数据报表
- ✅ 账户级报表
- ✅ 广告计划报表
- ✅ 广告组报表
- ✅ 创意报表
- ✅ 多维度分析

### 5. 自动化功能
- ✅ 智能投放启动
- ✅ 批量投放管理
- ✅ 投放历史查询
- ✅ 自动化规则管理

### 6. 优化功能
- ✅ 广告表现分析
- ✅ 预算优化建议
- ✅ 出价策略建议
- ✅ 定向优化建议
- ✅ 优化报告生成

---

## 🚀 快速开始

### 环境要求

- **Python 3.8+**
- **依赖库**（见 `requirements.txt`）

### 安装步骤

```bash
# 1. 进入技能目录
cd /root/.openclaw/workspace/skills/oceanengine-ads...