skills.rest
rudrankriyam
rudrankriyamCOMMUNITY
Explore all skills by this author →
Website𝕏@rudrankGitHub

asc-apple-ads

Manages Apple Ads campaigns, targeting, reports, and assets through the asc CLI Platform API v1.

1.0k|57|Updated Jan 27, 2026
Search Tags:#ad automation#asc cli#Apple Ads#JSON reports#oAuth#Campaign Management#platform API
One-click install
npx skills add https://github.com/rudrankriyam/app-store-connect-cli-skills --skill asc-apple-ads
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: asc-apple-ads
Source: https://github.com/rudrankriyam/app-store-connect-cli-skills/tree/main/skills/asc-apple-ads
Command: npx skills add https://github.com/rudrankriyam/app-store-connect-cli-skills --skill asc-apple-ads

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running Apple Ads operations through the asc CLI requires choosing between Platform API v1 and the deprecated Campaign Management API v5, handling separate OAuth credentials and ad-account contexts, and avoiding accidental spend from unguarded mutations. This Skill provides the exact command patterns, payload shapes, and safety rules to do that work correctly.

Core Features & Use Cases

  • Authentication and account discovery: Configure Apple Ads OAuth profiles, CI environment variables, and ad-account selection via ACL discovery before any operation.
  • Read-first campaign management: Query campaigns, ad groups, keywords, reports, recommendations, and assets with JSON-first output and correct pagination.
  • Guarded mutations: Create paused test campaigns, apply recommendations, and manage budget orders with explicit confirmation gates and cleanup procedures.
  • v5 to v1 migration: Map deprecated Campaign Management API v5 commands to their Platform API v1 equivalents before Apple's January 2027 retirement.
  • Use Case: An agent discovers your ad account, queries all campaigns as JSON, drafts a paused test campaign with a timestamped name, and only creates it after you approve the payload.

Quick Start

Ask the agent to discover your Apple Ads ad account and list all campaigns as JSON using the asc ads commands.

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 Apple Ads with the asc CLI?▼

Run asc ads auth login with your client ID, team ID, key ID, private key path, and ad account. Apple Ads credentials are separate from App Store Connect, so asc auth login alone does not configure Ads access.

How do I list Apple Ads campaigns as JSON?▼

Use asc ads campaigns find with your ads profile and ad account, passing --output json. Control pagination through a query file with offset, pageSize, and fetchTotalCount since the command has no --paginate flag.

What is the difference between Apple Ads Platform API v1 and v5?▼

Platform API v1 commands live directly under asc ads and use an ad account ID, while deprecated v5 commands under asc ads v5 use an organization ID. Apple retires v5 on January 26, 2027, and the two APIs use different payload schemas.

Can I create an Apple Ads campaign without it spending money?▼

Yes. Create the campaign with an explicit top-level status of PAUSED in the JSON payload, which runs without --confirm. Any omitted or non-paused status requires explicit confirmation before the CLI proceeds.

Why does my asc ads command reject my v5-style payload?▼

Platform v1 uses singular value filters and wrapper objects like KeywordCreateBulkRequest, while v5 Selector fields such as conditions or plural values are rejected before auth. Run the exact leaf command with --help to check the expected schema.

Related Skills

Explore More Marketing & Sales Skills→
pixiesgeosunpixiesgeosun

goal-decompose-schedule

Break down personal goals into daily tasks and add them to Apple Reminders.

Community
Intermediate
sachacoldiqsachacoldiq
242

linkedin-ads-bidding

Configure LinkedIn Ads bidding strategies and budget allocation for B2B campaigns.

Community
Intermediate
venomez-vipervenomez-viper
1

custom-product-pages

Generate audience-targeted Custom Product Page metadata templates for Apple App Store.

Community
Advanced
TrebuhSTrebuhS
5

Apple-Search-Ads

Manage Apple Search Ads campaigns, keywords, and reports via asa-cli.

Community
Intermediate