下面给你一份 全面、专业、可直接用于开发的《Yandex Ads 自动化管理：API + 工具使用指南》。
涵盖：API 能做什么、常用 SDK、常用自动化场景、具体调用方式、权限说明、脚本示例、无代码工具等。

内容基于 Yandex Advertising Network 最新结构（Yandex Direct API + AppMetrica API）。

⭐ 总览：Yandex Ads 的自动化方式

Yandex 广告自动化有 4 条路径：

1. Yandex Direct API → 广告创建、管理、报告数据

2. AppMetrica API → 移动应用数据、事件归因

3. Yandex DataLens → 自动化数据分析与 Dashboard

4. 脚本（Python / PHP）或第三方工具 → 自动化日常任务

——————————————————————

1. Yandex Direct API（主广告 API）

——————————————————————

Direct API 是负责管理 搜索广告 + RSYA 广告 + App 推广 的核心接口。

官方文档：
https://yandex.ru/dev/direct/

✔ Direct API 能做什么？

① 自动创建广告

• 创建 Campaign（广告系列）

• 创建 Ad Groups（广告组）

• 上传 Ads（广告）

• 上传 Creatives（图片 & 视频）

• 添加 Keywords、否定关键词

② 调整出价与预算

• 修改 CPC

• 修改预算上限

• 调整设备/时间段投放

③ 自动拉取报表

• 展示、点击、花费

• 安装事件（链接 AppMetrica）

• 转化数据

④ 自动检测异常

• 自动暂停高 CPA 的广告

• 自动提高高 ROI 广告预算

• 自动过滤“违规创意”

⑤ 批量操作（批量更新成千上万个广告）

✔ 常用 API 接口清单（投放最常用 7 个）

✔ API 鉴权方式

使用 OAuth Token。

步骤：

1. 在 Yandex OAuth Console 创建 App

2. 获取 OAuth Token

3. 使用 HTTP Header：

Authorization: Bearer <TOKEN>
Client-Login: <账号ID>

✔ Python 调用示例（可直接使用）

 请求示例：获取 Campaign 列表

import requests
import json

TOKEN = "YOUR_OAUTH_TOKEN"
CLIENT = "your-login"

headers = {
    "Authorization": f"Bearer {TOKEN}",
    "Client-Login": CLIENT,
    "Accept-Language": "ru",
}

body = {
    "method": "get",
    "params": {
        "SelectionCriteria": {},
        "FieldNames": ["Id", "Name", "Status"]
    }
}

r = requests.post(
    "https://api.direct.yandex.com/json/v5/campaigns",
    headers=headers,
    json=body
)

print(json.dumps(r.json(), indent=2, ensure_ascii=False))

✔ 批量修改出价（常用场景）

body = {
    "method": "set",
    "params": {
        "Bids": [
            {"KeywordId": 12345, "Bid": 50000000},
            {"KeywordId": 12346, "Bid": 60000000}
        ]
    }
}

——————————————————————

2. AppMetrica API（App 商务必用）

——————————————————————

AppMetrica 是 Yandex 的 AppsFlyer/Adjust。

API 功能包括：

• 获取安装/注册/活跃/付费数据

• 获取事件属性

• 导出 cohort 数据

• 自动化监控留存

官方文档：
https://appmetrica.yandex.com/docs/api/

✔ 常用 AppMetrica API 场景

——————————————————————

3. 自动化广告管理的典型场景

——————————————————————

下面是跨境电商和 App 最常做的自动化任务：

⭐ ① 自动暂停成本过高的广告

逻辑：

如果
CPA > 设定阈值（例如 300 ₽）
→ 自动暂停广告
→ Slack/Telegram 发警报

⭐ ② 夜间预算清零（俄区常用）

俄罗斯凌晨流量质量差。自动脚本：

00:00 → 将 Campaign 预算设置为 0
07:00 → 恢复预算

⭐ ③ 新关键词自动扩展（搜索广告）

脚本：

1. 拉取搜索词报告

2. 提取高 CTR 的新关键词

3. 自动加入 Campaign

自动扩量效果极好。

⭐ ④ RSYA 自动优化（高频任务）

自动操作包括：

• 提升高 CTR 图文创意的预算

• 移除点击率差的创意

• 批量上传新图片

• 自动测试 A/B 创意

⭐ ⑤ 自动生成日报 / 周报

使用 API → Google Sheet / Excel → 自动推送 Telegram/邮箱。

——————————————————————

4. 无代码自动化工具（不写代码也能用）

——————————————————————

如果你不写代码，可以用：

✔ Yandex DataLens

• 自动报表

• Dashboard

• KPI 预警

• SQL 数据分析（连接 Direct 和 AppMetrica）

✔ Kommo / Roistat / OWOX

这些工具可集成 Yandex Ads，进行自动：

• 报表

• 自动调价

• 转化跟踪

• 营销归因模型

——————————————————————

5. 完整自动化架构示例（最推荐的组合）

——————————————————————

下面是俄罗斯本地代理和大广告主最常用的架构：

Yandex Direct API ——→ 广告创建/修改
           ↓
AppMetrica API ——→ 转化/事件/ROI 数据
           ↓
Python 任务脚本 ——→ 预算控制/出价调整/告警
           ↓
DataLens ——→ 可视化 Dashboard

这是目前 最稳、最高效的 Yandex 自动化投放体系。