Apple Ads 是 Adapty CLI 中用于操作 Apple Search Ads 账户的技能，面向已连接 Apple Ads 账户的日常运营场景。
用途 适用于通过 Adapty CLI 操作已连接的 Apple Ads 账户，包括每周检查、群组与关键词出价审查、竞品关键词机会挖掘等重复性运营任务。对于账户结构规划、初始关键词选择等尚无账户时的前置问题，应使用 apple-ads-strategy 技能；对于实时账户健康检查、重复 Exact 归属、缺失交叉否定词等问题，应使用只读的 apple-ads-audit 技能。
主要能力 覆盖账户与发现（whoami、connect、orgs list、apps list）、管理与写入（campaigns、ad groups、ads、keywords、negative keywords、product pages、creatives、automations）、指标分析（metrics、metrics overview、search-terms list、competitors summary）等。读取与自动化命令使用 --dry-run 不产生费用；其他 asa 命令会在数秒内触达 Apple 并花费真实资金，且创建的内容无法删除或撤销。
使用方式 每次会话首先运行预检命令（adapty asa whoami 包装脚本），根据返回状态判断：READY_AUTHED 表示就绪；READY_AUTHED_SYSTEM_CA_OFF 表示后续调用需加 NODE_USE_SYSTEM_CA=0；NEED_SETUP 表示需打开 adapty-cli-setup 技能；402 ads_manager_subscription_required 表示无 Ads Manager 订阅；NETWORK_BLOCKED 表示网络不可达。写入命令需使用 --idempotency-key，且用户自行运行的命令不应加 --yes，由用户终端确认；由代理运行则需先获得明确同意再加 --yes。关键词批量添加单次不超过 15 个。
适用场景 适用于已连接 Apple Ads 账户的周期性运营、指标报告、活动创建与出价调整等。
限制 无删除操作，--status PAUSED 是唯一停止方式；指标预算为每分钟 5 次调用；分析池每公司 2 个并发查询；窗口上限为日粒度 90 天、周粒度 180 天、月粒度 365 天；不得猜测指标名称或编造 id、adam-id、预算或出价；低置信度不得产生写入。