SuperAPI AI 工具集

linkfox-amazon-ads-manager

设计与创作

查看项目

更新于 10-16 00:00

技能介绍

用途:管理亚马逊广告(Amazon Ads)实体,支持 list(查询)与 create/update(创建、修改),覆盖 SP(Sponsored Products)v3、SB(Sponsored Brands)V3 Legacy 与 V4、SD(Sponsored Display)v3。

主要能力:SP 覆盖 campaigns、adGroups、keywords、negativeKeywords、productAds、targets、budgetRules 等;SB V4 覆盖 campaigns、adGroups、ads、keywords、targets、creative versions、budgetRules,V3 仅兼容 Legacy;SD 覆盖 campaigns、adGroups、productAds、targets、negativeTargets、creatives、budgetRules。自动分页(fetchAll 默认 true,maxPages=50 兜底),对常见过滤器格式做兜底规范化。返回实体字段(id、名称、状态、匹配类型等),不含曝光/点击/花费/转化等指标,指标需调 linkfox-amazon-ads-report 按 id join。

使用方式:依赖 linkfox-amazon-ads-auth(未安装时 exit 42)。调用前须先经 ads-auth 的 authorized_stores.py 解析数字 profileId,多账号同站点须向用户澄清,禁止让用户直接报 profileId。API 端点 POST /amazonAds/developerProxy;脚本用法 python scripts/<脚本名>.py '<JSON 参数>' [--inline],SB 新调用须显式用 scripts/sb/v3/ 或 scripts/sb/v4/。共用参数含 profileId、region(NA/EU/FE)、fetchAll、maxResults、includeExtendedDataFields、locale。响应默认落盘到 <cwd>/linkfox/<日期>/<session>/data/,大于 8 KB 时 stdout 只输出摘要。

适用场景:查询与批量创建/修改广告活动、广告组、关键词、定向、商品广告、预算规则等。

限制:不支持 DELETE(可 update state 为 ARCHIVED,不可逆);SB 不支持 V4 Multi-Ad-Group 降级 V3;SB negativeKeywords/negativeTargets/themes/recommendations 与 Legacy→V4 迁移不在范围;SD 非基础实体接口、DSP/ST 实体不在范围。写操作立即生效且不可撤回,未获授权时须先输出确认摘要。连续异常会触发 450/453/454/459 保护冷却,须停止自动重试。本技能不消耗算力。