apple-ads-audit

Diagnoses Apple Search Ads account health and structure through read-only CLI queries.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/adaptyteam/apple-ads-cli --skill apple-ads-audit-adaptyteam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-ads-audit
Source: https://github.com/adaptyteam/apple-ads-cli/tree/main/skills/apple-ads-audit
Command: npx skills add https://github.com/adaptyteam/apple-ads-cli --skill apple-ads-audit-adaptyteam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Apple Search Ads accounts accumulate structural problems—duplicate exact keywords, missing cross-negatives, non-serving ads, and unexplained gaps between Apple and Adapty install counts—that are hard to spot without a systematic review. This Skill performs a read-only diagnostic of a connected account and reports findings with evidence, without ever changing anything. ## Core Features & Use Cases - Account Health Audit: Checks serving status, spend without results, performance against user-defined limits, and inventory readiness across campaigns, ad groups, ads, and keywords. - Structure Audit: Detects duplicate exact keyword owners, missing cross-negatives, positive-negative collisions, mixed-intent ad groups, orphan entities, and budget fragmentation. - Apple vs Adapty Install Comparison: Compares total installs from both systems over the same date window and reports the absolute and relative gap with a plain-language explanation. - Use Case: Ask "audit my Apple Ads account" and receive a severity-ordered findings report where every claim maps to evidence IDs from actual CLI reads, plus a safe handoff plan for fixes. ## Quick Start Ask the agent to audit your Apple Ads account health for the last 30 days and list which campaigns need attention.

Frequently Asked Questions about apple-ads-audit

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

FAQPage Schema
How do I audit my Apple Search Ads account for problems?▼

Connect your account with the adapty CLI, then ask for an account audit. The skill runs read-only list and metrics queries, checks serving status, spend, and performance against your limits, and returns findings ordered by severity with evidence for each claim.

How to find duplicate exact keywords in Apple Search Ads?▼

The structure audit playbook groups active exact keywords by normalized text and country, then flags any text with more than one active owner as a duplicate_exact_owner conflict. It names every conflicting ad group and recommends an owner without making changes.

Why are Apple and Adapty install numbers different?▼

Apple and Adapty use different attribution and event definitions, so an exact match is not expected. The skill compares total_installs from Apple with adapty_installs over the same date window and reports the absolute and relative gap without assigning fault.

Can this skill change bids or pause campaigns in Apple Ads?▼

No. The audit skill is strictly read-only and forbids any create, update, pause, or automation mutation. When you choose a fix, it hands the finding off to the separate apple-ads operator skill, which re-resolves IDs and asks for its own confirmation.

What happens if my Apple Ads account is not connected?▼

The preflight runs adapty asa whoami first. If the CLI, authentication, subscription, or Apple connection is unavailable, the audit stops and hands off to setup. For designing a new account without a connection, it routes to the apple-ads-strategy skill instead.