asc-apple-ads

1# asc Apple Ads
2 
3Run Apple Ads work through `asc ads`. Apple Ads credentials are separate from App Store Connect credentials; `asc auth login` does not configure Ads.
4 
5## Pick the API first
6 
7- Direct `asc ads <resource> ...` commands use Apple Ads Platform API v1 and an ad account ID.
8- Deprecated Campaign Management API v5 commands live under `asc ads v5 ...` and use an organization ID. Apple retires v5 on January 26, 2027.
9- Never substitute an org ID for an ad account ID. The CLI keeps them separate.
10- Run the exact leaf command with `--help` before building a request file. Platform v1 payloads and response envelopes differ from v5; the CLI does not translate them.
11- For non-interactive pipelines, pass `--file -` to read a JSON request body from stdin; the CLI rejects it when stdin is a terminal.
12- Resource, report, upload, and raw commands emit lossless JSON. Use `jq` for projections instead of asking for table or markdown output.
13 
14## Authenticate and pin the account
15 
16Store both contexts when a profile must support v1 and legacy v5:
17 
18```bash
19asc ads auth login \
20  --name "Marketing" \
21  --client-id "$ASC_ADS_CLIENT_ID" \
22  --team-id "$ASC_ADS_TEAM_ID" \
23  --key-id "$ASC_ADS_KEY_ID" \
24  --private-key "$ASC_ADS_PRIVATE_KEY_PATH" \
25  --ad-account "987654" \
26  --org "123456" \
27  --network
28```
29 
30For CI, set Ads-specific variables and bypass the host keychain:
31 
32```bash
33export ASC_ADS_CLIENT_ID="SEARCHADS_CLIENT_ID"
34export ASC_ADS_TEAM_ID="SEARCHADS_TEAM_ID"
35…