asc-apple-ads

Manage Apple Ads campaigns, keywords, and reports through the asc CLI.

70|4|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/AlexW00/Zettel --skill asc-apple-ads-alexw00
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: asc-apple-ads
Source: https://github.com/AlexW00/Zettel/tree/main/.agents/skills/asc-apple-ads
Command: npx skills add https://github.com/AlexW00/Zettel --skill asc-apple-ads-alexw00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Ads through the web console is slow and hard to automate. This Skill provides structured guidance for operating the asc ads CLI so you can authenticate, inspect, create, update, and report on Apple Ads resources from the command line with safe, repeatable workflows. ## Core Features & Use Cases - Authentication & Org Resolution: Configure Apple Ads auth via stored profiles, environment variables, or short-lived tokens, and resolve org IDs with asc ads acls. - Read & Reporting Workflows: List campaigns, ad groups, apps, product pages, creatives, and geo targets, and run campaign or keyword reports with JSON output for automation. - Safe Mutations & Live Testing: Create and update campaigns, ad groups, and targeting keywords from JSON payload files, with guardrails like --confirm for deletes and a checklist for paused, uniquely named live-test resources. - Use Case: A marketer wants to audit all active campaigns and pull a keyword performance report. Use this Skill to authenticate, resolve the org ID, list campaigns with pagination, and submit a reporting request via a JSON file. ## Quick Start Ask the assistant to use the asc ads CLI to list the first ten campaigns for your Apple Ads org in JSON format.

Frequently Asked Questions about asc-apple-ads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate the asc CLI with Apple Ads?▼

Apple Ads auth is separate from App Store Connect auth, so `asc auth login` does not configure it. Use `asc ads auth login` with client ID, team ID, key ID, and private key, or set the ASC_ADS_CLIENT_ID, ASC_ADS_TEAM_ID, ASC_ADS_KEY_ID, and ASC_ADS_PRIVATE_KEY_PATH environment variables.

How do I find my Apple Ads org ID?▼

Run `asc ads acls --output json` to list the organizations your credentials can access and read the org ID from the response. Pass it with `--org` per command or set ASC_ADS_ORG_ID for a scoped session.

How do I create Apple Ads campaigns from the command line?▼

Write the Apple Ads request JSON to a file and run `asc ads campaigns create --org <id> --file campaign.json --output json`. Never guess payload fields; use the exact Apple Ads request structure in the file.

Can I run Apple Ads reports with the asc CLI?▼

Yes, use `asc ads reports campaigns` or `asc ads reports keywords` with a reporting request JSON file and `--output json`. Pagination for reporting and find endpoints is handled inside the JSON body.

How do I safely test changes on a live Apple Ads account?▼

Start with read-only checks like `asc ads me view` and `asc ads acls`, then create paused or future-dated resources with unique test names. Delete only the test parent campaign or ad group afterward, and confirm cleanup with a final list query.

When should I use raw Apple Ads API requests instead of built-in commands?▼

Use `asc ads api request` when Apple adds a field before the first-class command surface supports it. Raw requests accept only Apple Ads v5 paths or full api.searchads.apple.com URLs, and DELETE still requires `--confirm`.