【免费下载链接】app-store-connect-cli-skillsSkills to automate app store deployed and everything related to it using the asc cli项目地址https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills点击查看免费下载app-store-connect-cli-skills 是一套基于asc CLI的 Agent Skills 技能包帮你用命令行自动化 App Store 发布全流程。其中 asc-apple-ads 技能专注Apple Ads 管理从 OAuth 授权、广告账户发现到 Campaign 投放与效果报告全部在终端完成适合想让广告投放可自动化、可审计的开发者与增长团队。为什么用 asc 管理 Apple Ads 和手动在网页控制台点来点去相比asc ads子命令有这些优势痛点asc 的解法OAuth 凭证到处拷贝、CI 难复用凭证以 named profile 持久保存CI 用环境变量注入数据只能截图看报表所有资源与报告命令输出无损 JSON直接喂给脚本或jq分析误点按钮导致预算失控高危变更删除、加预算、调定向强制--confirm确认新旧 API 混用易踩坑v1 / v5 命令严格分离迁移路径清晰快速安装技能包如果你已经在使用asc一条命令即可装好全部技能asc install-skills也可以不依赖asc直接用 Agent Skills 安装器从仓库安装npx skills add rorkai/app-store-connect-cli-skills更多安装方式含 Claude Code / Codex 插件市场见 README.md。第一步Apple Ads OAuth 授权与账户绑定关键认知Ads 凭证独立于 App Store ConnectApple Ads 使用独立的 OAuth 凭证asc auth loginApp Store Connect 登录不会为 Ads 配置任何权限。Ads 凭证要通过asc ads auth login单独管理asc ads auth login \ --name Marketing \ --client-id $ASC_ADS_CLIENT_ID \ --team-id $ASC_ADS_TEAM_ID \ --key-id $ASC_ADS_KEY_ID \ --private-key $ASC_ADS_PRIVATE_KEY_PATH \ --ad-account 987654 \ --org 123456⚠️ad account ID 与 org ID 是两套体系v1 命令用 ad account ID遗留 v5 命令用 org IDCLI 严格分开保存绝不能互相替代。CI 环境用环境变量替代钥匙串CI 上无法使用本机 keychain设置 Ads 专用变量并显式绕过即可export ASC_ADS_CLIENT_IDSEARCHADS_CLIENT_ID export ASC_ADS_TEAM_IDSEARCHADS_TEAM_ID export ASC_ADS_KEY_IDKEY_ID export ASC_ADS_PRIVATE_KEY_PATH$HOME/.asc/apple-ads-private-key.pem export ASC_ADS_AD_ACCOUNT_ID987654 export ASC_ADS_BYPASS_KEYCHAIN1验证授权并发现广告账户asc ads auth status --validate --output json asc ads auth discover --ads-profile Marketing --output json asc ads auth doctor --output jsonauth discover会调用 Platform API v1 的GET /v1/me与GET /v1/acls列出所有可访问的广告账户、组织与角色。建议人工核对每个账户的 ID、名称、组织与角色后再选用不要盲选第一条结果。当存在多个 profile 或账户时后续命令都应显式带上--ads-profile Marketing和--ad-account 987654。第二步只读探查摸清 Campaign 家底 动任何数据前先用只读命令验证自己操作的是正确的账户asc ads me view --ads-profile Marketing --output json asc ads acls list --ads-profile Marketing --output json asc ads apps search --ads-profile Marketing --ad-account 987654 \ --query Example --limit 1 --output json确认无误后用各资源的find子命令盘点家底盘点目标命令广告系列asc ads campaigns find广告组asc ads ad-groups find --file query.json投放的广告asc ads ads find --file query.json投放关键词asc ads targeting-keywords find --file query.json否定关键词asc ads negative-keywords find --file query.json 小贴士v1 查询的过滤器、排序、分页都写在 JSON 查询文件里pagination.offset/pageSize/fetchTotalCountfind类命令没有--paginate标志v1 过滤器字段用单数value不要照抄 v5 的conditions/values写法当前版本会直接拒绝。第三步Campaign 投放与受保护变更创建 Campaign从暂停状态开始最安全创建 Campaign 可能立即开始花钱。技能推荐的稳妥做法先建一个显式status: PAUSED的 Campaign验证无误后再恢复投放。CampaignCreate载荷必须包含adAccountId、billingEvent、dailyBudget、name、promotedObjectId、promotedObjectType、targeting字段。asc ads campaigns create --ads-profile Marketing \ --ad-account 987654 --file paused-campaign.json⚠️ CLI 会原样发送 JSON 文件--ad-account只决定请求上下文不会替你往载荷里注入adAccountId字段一个都不能漏。暂停、恢复与删除asc ads campaigns pause --ads-profile Marketing --ad-account 987654 --campaign campaign-id asc ads campaigns resume --ads-profile Marketing --ad-account 987654 --campaign campaign-id --confirm asc ads campaigns delete --ads-profile Marketing --ad-account 987654 --campaign campaign-id --confirm变更安全分级一览操作类型是否要求--confirm显式 PAUSED 的 Campaign 创建否唯一的安全例外仅改名 / 改名 置为 PAUSED否恢复投放、调整预算、定向、出价、日期是删除、批量创建/更新、应用建议是共享预算budget-orders增删改是第四步报告与优化建议 拉取 Campaign 报告报告请求体是端点专属的 JSON日期区间写在timeRange下分页用offset/pageSizeCampaign ID 写在filters里{ pagination: {offset: 0, pageSize: 20}, filters: [ {field: campaignId, operator: EQUALS, value: [campaign-id]} ], groupBy: [countryOrRegion], timeRange: { start: 2026-08-01, end: 2026-08-14, timeZone: ORTZ, granularity: DAILY } }asc ads reports apps campaigns --ads-profile Marketing \ --ad-account 987654 --file report.json --output json不同报告实体接受的groupBy值不同执行前用对应叶子命令的--help确认。应用优化建议Apple Ads 会给出预算等优化建议。查看建议没有风险但应用或忽略建议可能改变花费必须加--confirmasc ads recommendations daily-budgets find --ads-profile Marketing \ --ad-account 987654 --file query.json asc ads recommendations daily-budgets apply --ads-profile Marketing \ --ad-account 987654 --file recommendations.json --confirmv5 → v1 迁移旧命令对照表 已弃用的 Campaign Management API v5 命令位于asc ads v5 ...下Apple 将于2027 年 1 月 26 日正式下线 v5。迁移原则是逐条命令替换每个脚本先有审核过的 v1 请求体和响应解析器再切过去。已弃用 v5 命令Platform API v1 对应asc ads v5 campaigns listasc ads campaigns findasc ads v5 apps localized-detailsasc ads apps locales findasc ads v5 product-pages listasc ads product-pages findasc ads v5 reports campaignsasc ads reports apps campaignsasc ads v5 campaigns pause / resumeasc ads campaigns pause / resume注意v1 与 v5 的载荷和响应结构不同CLI 不会替你翻译。有 7 个 v5 叶子命令没有一对一的 v1 替代如 product-page countries/devices、部分批量删除、impression-share 报告等迁移时需要单独设计替代方案。实战安全检查清单 ✅用auth discover 一次单结果 app search 证明操作的是正确账户测试 Campaign 使用唯一时间戳命名 显式PAUSED状态把测试中创建的每个 ID 从 JSON 输出里保存下来任何操作前先暂停可能产生花费的资源只删除测试自己创建的 Campaign再复查一次确认已清理参考资料skills/asc-apple-ads/SKILL.md — Apple Ads 完整操作指南skills/asc-cli-usage/SKILL.md — asc 命令规范、标志约定与输出格式README.md — 技能全览与安装方式赞分享【免费下载链接】app-store-connect-cli-skillsSkills to automate app store deployed and everything related to it using the asc cli项目地址https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills点击查看免费下载相关推荐QtScrcpy终极权限管理指南Android投屏权限请求与用户授权完全解析QtScrcpy终极权限管理指南Android投屏权限请求与用户授权完全解析 QtScrcpy作为一款强大的Android实时投屏软件其权限处理机制是确保设桌面应用音视频告别频繁授权弹窗Pearcleaner HelperTool权限管理全攻略告别频繁授权弹窗Pearcleaner HelperTool权限管理全攻略 你是否还在为清理Mac应用时反复输入密码而烦恼每次执行系统级清理操作都需要授权确桌面应用系统工具Ceph 用户管理实战指南认证授权、能力Capabilities与 Keyring 管理全解析Ceph 用户管理实战指南认证授权、能力Capabilities与 Keyring 管理全解析 导读 本文基于 Ceph 官方运维手册中关于用户管理Us存储分布式文件系统对象存储后端高可用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/16 2:23:26 · 阅读 1.2k 用 asc 管理 Apple Ads：OAuth 授权、Campaign 投放与报告全解析
【免费下载链接】app-store-connect-cli-skillsSkills to automate app store deployed and everything related to it using the asc cli项目地址https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills点击查看免费下载app-store-connect-cli-skills 是一套基于asc CLI的 Agent Skills 技能包帮你用命令行自动化 App Store 发布全流程。其中 asc-apple-ads 技能专注Apple Ads 管理从 OAuth 授权、广告账户发现到 Campaign 投放与效果报告全部在终端完成适合想让广告投放可自动化、可审计的开发者与增长团队。为什么用 asc 管理 Apple Ads 和手动在网页控制台点来点去相比asc ads子命令有这些优势痛点asc 的解法OAuth 凭证到处拷贝、CI 难复用凭证以 named profile 持久保存CI 用环境变量注入数据只能截图看报表所有资源与报告命令输出无损 JSON直接喂给脚本或jq分析误点按钮导致预算失控高危变更删除、加预算、调定向强制--confirm确认新旧 API 混用易踩坑v1 / v5 命令严格分离迁移路径清晰快速安装技能包如果你已经在使用asc一条命令即可装好全部技能asc install-skills也可以不依赖asc直接用 Agent Skills 安装器从仓库安装npx skills add rorkai/app-store-connect-cli-skills更多安装方式含 Claude Code / Codex 插件市场见 README.md。第一步Apple Ads OAuth 授权与账户绑定关键认知Ads 凭证独立于 App Store ConnectApple Ads 使用独立的 OAuth 凭证asc auth loginApp Store Connect 登录不会为 Ads 配置任何权限。Ads 凭证要通过asc ads auth login单独管理asc ads auth login \ --name Marketing \ --client-id $ASC_ADS_CLIENT_ID \ --team-id $ASC_ADS_TEAM_ID \ --key-id $ASC_ADS_KEY_ID \ --private-key $ASC_ADS_PRIVATE_KEY_PATH \ --ad-account 987654 \ --org 123456⚠️ad account ID 与 org ID 是两套体系v1 命令用 ad account ID遗留 v5 命令用 org IDCLI 严格分开保存绝不能互相替代。CI 环境用环境变量替代钥匙串CI 上无法使用本机 keychain设置 Ads 专用变量并显式绕过即可export ASC_ADS_CLIENT_IDSEARCHADS_CLIENT_ID export ASC_ADS_TEAM_IDSEARCHADS_TEAM_ID export ASC_ADS_KEY_IDKEY_ID export ASC_ADS_PRIVATE_KEY_PATH$HOME/.asc/apple-ads-private-key.pem export ASC_ADS_AD_ACCOUNT_ID987654 export ASC_ADS_BYPASS_KEYCHAIN1验证授权并发现广告账户asc ads auth status --validate --output json asc ads auth discover --ads-profile Marketing --output json asc ads auth doctor --output jsonauth discover会调用 Platform API v1 的GET /v1/me与GET /v1/acls列出所有可访问的广告账户、组织与角色。建议人工核对每个账户的 ID、名称、组织与角色后再选用不要盲选第一条结果。当存在多个 profile 或账户时后续命令都应显式带上--ads-profile Marketing和--ad-account 987654。第二步只读探查摸清 Campaign 家底 动任何数据前先用只读命令验证自己操作的是正确的账户asc ads me view --ads-profile Marketing --output json asc ads acls list --ads-profile Marketing --output json asc ads apps search --ads-profile Marketing --ad-account 987654 \ --query Example --limit 1 --output json确认无误后用各资源的find子命令盘点家底盘点目标命令广告系列asc ads campaigns find广告组asc ads ad-groups find --file query.json投放的广告asc ads ads find --file query.json投放关键词asc ads targeting-keywords find --file query.json否定关键词asc ads negative-keywords find --file query.json 小贴士v1 查询的过滤器、排序、分页都写在 JSON 查询文件里pagination.offset/pageSize/fetchTotalCountfind类命令没有--paginate标志v1 过滤器字段用单数value不要照抄 v5 的conditions/values写法当前版本会直接拒绝。第三步Campaign 投放与受保护变更创建 Campaign从暂停状态开始最安全创建 Campaign 可能立即开始花钱。技能推荐的稳妥做法先建一个显式status: PAUSED的 Campaign验证无误后再恢复投放。CampaignCreate载荷必须包含adAccountId、billingEvent、dailyBudget、name、promotedObjectId、promotedObjectType、targeting字段。asc ads campaigns create --ads-profile Marketing \ --ad-account 987654 --file paused-campaign.json⚠️ CLI 会原样发送 JSON 文件--ad-account只决定请求上下文不会替你往载荷里注入adAccountId字段一个都不能漏。暂停、恢复与删除asc ads campaigns pause --ads-profile Marketing --ad-account 987654 --campaign campaign-id asc ads campaigns resume --ads-profile Marketing --ad-account 987654 --campaign campaign-id --confirm asc ads campaigns delete --ads-profile Marketing --ad-account 987654 --campaign campaign-id --confirm变更安全分级一览操作类型是否要求--confirm显式 PAUSED 的 Campaign 创建否唯一的安全例外仅改名 / 改名 置为 PAUSED否恢复投放、调整预算、定向、出价、日期是删除、批量创建/更新、应用建议是共享预算budget-orders增删改是第四步报告与优化建议 拉取 Campaign 报告报告请求体是端点专属的 JSON日期区间写在timeRange下分页用offset/pageSizeCampaign ID 写在filters里{ pagination: {offset: 0, pageSize: 20}, filters: [ {field: campaignId, operator: EQUALS, value: [campaign-id]} ], groupBy: [countryOrRegion], timeRange: { start: 2026-08-01, end: 2026-08-14, timeZone: ORTZ, granularity: DAILY } }asc ads reports apps campaigns --ads-profile Marketing \ --ad-account 987654 --file report.json --output json不同报告实体接受的groupBy值不同执行前用对应叶子命令的--help确认。应用优化建议Apple Ads 会给出预算等优化建议。查看建议没有风险但应用或忽略建议可能改变花费必须加--confirmasc ads recommendations daily-budgets find --ads-profile Marketing \ --ad-account 987654 --file query.json asc ads recommendations daily-budgets apply --ads-profile Marketing \ --ad-account 987654 --file recommendations.json --confirmv5 → v1 迁移旧命令对照表 已弃用的 Campaign Management API v5 命令位于asc ads v5 ...下Apple 将于2027 年 1 月 26 日正式下线 v5。迁移原则是逐条命令替换每个脚本先有审核过的 v1 请求体和响应解析器再切过去。已弃用 v5 命令Platform API v1 对应asc ads v5 campaigns listasc ads campaigns findasc ads v5 apps localized-detailsasc ads apps locales findasc ads v5 product-pages listasc ads product-pages findasc ads v5 reports campaignsasc ads reports apps campaignsasc ads v5 campaigns pause / resumeasc ads campaigns pause / resume注意v1 与 v5 的载荷和响应结构不同CLI 不会替你翻译。有 7 个 v5 叶子命令没有一对一的 v1 替代如 product-page countries/devices、部分批量删除、impression-share 报告等迁移时需要单独设计替代方案。实战安全检查清单 ✅用auth discover 一次单结果 app search 证明操作的是正确账户测试 Campaign 使用唯一时间戳命名 显式PAUSED状态把测试中创建的每个 ID 从 JSON 输出里保存下来任何操作前先暂停可能产生花费的资源只删除测试自己创建的 Campaign再复查一次确认已清理参考资料skills/asc-apple-ads/SKILL.md — Apple Ads 完整操作指南skills/asc-cli-usage/SKILL.md — asc 命令规范、标志约定与输出格式README.md — 技能全览与安装方式赞分享【免费下载链接】app-store-connect-cli-skillsSkills to automate app store deployed and everything related to it using the asc cli项目地址https://gitcode.com/gh_mirrors/ap/app-store-connect-cli-skills点击查看免费下载相关推荐QtScrcpy终极权限管理指南Android投屏权限请求与用户授权完全解析QtScrcpy终极权限管理指南Android投屏权限请求与用户授权完全解析 QtScrcpy作为一款强大的Android实时投屏软件其权限处理机制是确保设桌面应用音视频告别频繁授权弹窗Pearcleaner HelperTool权限管理全攻略告别频繁授权弹窗Pearcleaner HelperTool权限管理全攻略 你是否还在为清理Mac应用时反复输入密码而烦恼每次执行系统级清理操作都需要授权确桌面应用系统工具Ceph 用户管理实战指南认证授权、能力Capabilities与 Keyring 管理全解析Ceph 用户管理实战指南认证授权、能力Capabilities与 Keyring 管理全解析 导读 本文基于 Ceph 官方运维手册中关于用户管理Us存储分布式文件系统对象存储后端高可用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考