广告账户审计

ads-audit

粘贴你自己的广告平台报表导出，得到带证据引用的审计：浪费、结构、创意、出价，以及下一步该导出什么。

价格与运行时

当前价格: 每次运行 25 Credits
超时上限: 最长 1500 秒
品牌上下文: 可选——传入 brand_context_id

价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。

输入参数

以 input 对象传入 POST /api/v1/runs。

键	类型	必填	标签与说明
platform	select	可选	平台哪个广告平台。可选值：Google Ads
campaign_objective	short_text	必填	目标这个账户要达成什么。
conversion_definition	short_text	可选	转化定义什么算一次转化、如何追踪。
account_context	long_text	可选	账户背景账龄、地区、日期窗口、币种、花费量级。
targets	short_text	可选	目标值CPA / ROAS 目标。
export_data	long_text	必填	报表导出粘贴你自己的导出：广告系列、搜索词、关键词。
interaction_language	select	可选	报告语言控制最终报告的输出语言。可选值：英文, 中文

请求示例

示例覆盖全部必填字段，可选字段按同样方式传入。

curl -X POST https://api.TODO-APP-DOMAIN/api/v1/runs \
  -H "Authorization: Bearer $SUPAMARKETERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_slug": "ads-audit",
  "input": {
    "campaign_objective": "example text",
    "export_data": "example text"
  }
}'

返回内容

201 响应返回 run_no、credit_cost、stream_url 与 result_url（相对路径）。从 stream_url 订阅进度，从 result_url 取回终态结果（summary 与 output）。结果在 App 的保留窗口内可取（默认 30 天）。