SuperAPI AI 工具集

ads-manager

营销与增长

查看项目

更新于 10-15 10:54

技能介绍

ads-manager 是一个通过 Adapty CLI 管理 Apple Search Ads 的技能,归属于 adaptyteam/adapty-skills。它的核心用途是让使用者以命令行方式读取和修改 Apple Search Ads 账户中的广告资产与效果数据。

主要能力包括:读取广告系列、广告组、关键词或广告的表现;修改出价或预算;获取关键词推荐;管理否定关键词;管理产品页、素材以及自动化。参考资料分为两个文件:references/asa-management.md 覆盖广告系列、广告组、广告、关键词与关键词推荐、否定关键词、产品页、素材和自动化;references/asa-metrics.md 覆盖指标、指标总览、搜索词列表和竞对摘要。

使用方式上,技能要求在首次调用 asa 命令前解析一次 $ADAPTY,并对后续所有命令复用。CLI 版本下限为 0.8.7。安装方式为 npm i -g adapty@latest,若全局前缀不可写则回退为 npx --yes adapty@latest。命令执行遵循两种模板:列表查询需要填充该列表对应的作用域过滤条件,写入操作需要携带 --idempotency-key。技能还给出了账户发现流程:先运行 whoami,若 Apple 未关联则运行 connect,然后读取 orgs list 和 apps list。

适用场景为通过命令行进行 Apple Search Ads 的日常投放管理与效果查询,包括查看总量与趋势、找出表现最好或最差的 N 个实体、统计实体数量、按作用域聚合指标,以及创建广告系列、广告组和关键词等写操作。

限制与注意事项:读取和自动化的 --dry-run 不产生费用,其他 asa 命令会在数秒内到达 Apple 并花费真实资金,且创建的内容无法删除或撤销。没有删除命令,--status PAUSED 是唯一的停止方式。一次 keywords add 或 negative-keywords add 调用不得超过 15 个关键词(上限为 100)。指标调用受公司级预算限制,默认每分钟 15 次、每 10 秒最多 5 次,遇到 429 不应循环重试。金额使用广告系列组的货币而非美元。不得自行定义“表现最好”“亏损”“糟糕 ROAS”等业务含义,需先明确指标和时间窗口并获得用户确认后再写入。关于该技能的收费、价格、具体效果等信息,资料暂未提供。