跳到正文
asc-cli 技能手冊

asc-apple-ads

Apple Ads 投放管理

Apple Ads 驗證、帳號發現、Platform API v1 的廣告系列、定向、報表與資產管理。

覆蓋 Apple Ads 獨立 OAuth 驗證與廣告帳號發現、基於 Platform API v1 的廣告系列與定向管理、報表與素材操作、有防護的變更操作(guarded mutations)、原始 API 呼叫,以及從廢棄的 v5 自動化遷移到 Platform API v1 的路徑。

適用場景

  • 需要用 asc ads 讀取或修改 Apple Ads 資源時
  • 需要 Apple Ads 的 OAuth、Profile、廣告帳號上下文或 ASC_ADS_* 相關指引時
  • 需要在修改真實廣告帳號前先制定只讀的安全計畫時
  • 需要把廢棄的 asc ads v5 自動化遷移到 Platform API v1 時

命令示例

大寫佔位符(如 APP_ID、BUILD_ID)請替換為你自己的值;標有「對智慧代理說」的行是給 AI 智慧代理的提示詞,不會被複制。

zsh
# 登入 Apple Ads、發現帳號並查詢廣告系列
$asc ads auth login --name Marketing --client-id SEARCHADS_CLIENT_ID --team-id SEARCHADS_TEAM_ID --key-id KEY_ID --private-key ./ads-key.pem --ad-account 987654
$asc ads campaigns find --ad-account 987654 --file query.json --output json

安裝此技能

安裝 asc 後執行下面的命令即可一次性安裝全部技能,其中包含 asc-apple-ads。

zsh
$asc install-skills