breakaway 发表于 2026-7-9 17:13:30

开源一个 Apple Ads CLI,顺便解决官方看不到广告投放收入的问题

最近一直在给自己的几个 iOS App 跑 Apple Search Ads 。

官方后台其实已经能完成大部分投放工作,但有两个问题一直让我很头疼。

第一,也是最大的一个问题:看不到 关键词 收入归因。

Apple Ads 可以告诉你:

Impressions

Taps

Installs

CPA

CPT

但回答不了最重要的问题:

哪个关键词真正赚到了钱?

真正做优化的时候,我每天都要在 Apple Ads 和 RevenueCat (或者其他订阅平台)之间来回切换,再导出 CSV 自己对数据。

没有 Keyword Revenue ,很多 Bid 调整其实都是在”猜”。

第二个问题就是日常操作比较重复:

查看 Campaign

调整 Keyword Bid

查询 Search Terms

下载 Report

创建新的 Campaign

如果每天都要做这些事情,GUI 就没那么高效了。

于是,我把内部一直在使用的工具整理了一下,开源成了一个 Apple Ads CLI 。

GitHub: https://github.com/crevas/Apple-Ads-CLI

目前支持

OAuth 登录

Campaign / Ad Group 管理

Keyword 管理

Search Terms

Negative Keywords

Reports

Bid 调整

Apple Ads API v5

Apple Ads Platform API 1.0

例如:
appleads campaign list
appleads keyword list
appleads report keyword
appleads keyword update-bid

比官方后台多了什么?

除了把 Apple Ads API 做成 CLI ,我也把自己每天都会用到的一些能力加了进去。

目前已经支持:

Keyword Revenue Attribution

Keyword ROAS

Apple Ads × RevenueCat 数据关联

AI Bid Suggestions

自动优化 Workflow

终于可以直接看到类似这样的数据:
Keyword          Spend   Revenue   ROAS
photo editor   $120      $540      4.5x
remove object    $85       $63         0.74x
ai image         $210      $980      4.67x

这样 Bid 应该加还是减,一眼就能判断,而不用在 Apple Ads 、Claude Code, RevenueCat 和 Excel 之间来回切换。

CLI 只是第一步。

我的目标其实是把 Apple Search Ads 做成一个更适合开发者和 AI Agent 使用的工具链,而不是仅仅把官方 API 包一层。

如果这里也有做 iOS 、每天投 Apple Search Ads 的朋友,欢迎提建议或者一起完善。
页: [1]
查看完整版本: 开源一个 Apple Ads CLI,顺便解决官方看不到广告投放收入的问题