Back to Skills

ads-apple

Audit Apple Ads measurement, AdServices and AdAttributionKit, campaign and keyword structure, Search Match, App Store placements, custom product pages, bidding, budgets, MMP reconciliation, and policy. Use for Apple Ads, Apple Search Ads, App Store ads, Search Match, custom product pages, AdServices, or Apple app-install campaigns.

7,013stars1,040forksUpdated 7/14/2026

Security Assessment

Safe(100/100)
Security Score100/100

About ads-apple

ads-apple provides a structured, deep-analysis framework for advertisers running Apple Ads (formerly Apple Search Ads, ASA) to promote mobile apps on iOS. It solves the problem of evaluating an Apple Ads account holistically rather than metric-by-metric: it takes account exports or pasted metrics, identifies which placement types are active, runs each applicable check as PASS, WARNING, or FAIL, calculates an overall ASA Health Score from 0 to 100, and produces a findings report with an action plan. The skill reflects Apple's 2025 rebrand and recent platform changes such as Creative Sets deprecation and the Maximize Conversions bidder.

The analysis is organized into weighted areas. Campaign Structure (25%) checks bottom-, middle-, and top-of-funnel design, including brand, competitor, and category campaigns, plus keeping Search Match ad groups isolated from Exact Match. Bid Health (20%) reviews CPT (Cost Per Tap), TTR (Tap-Through Rate) benchmarks, conversion rates, and the Maximize Conversions auto-bidder (GA February 26, 2026) with its Target CPA, recommended daily budget of at least 5x target CPA, and two-week learning period. Custom Product Pages (15%) covers CPP variant testing (up to 70 per app as of October 2025) and asset alignment to keyword themes. Attribution & MMP Health (15%) covers AdAttributionKit, SKAN/AAK dual attribution, MMP integration (AppsFlyer, Adjust, Branch, Singular) and ATT opt-in. Budget Pacing (10%) and TAP Coverage across the four placement types (Search Results, Search Tab, Today Tab, Product Pages) round out the checks.

The skill targets mobile app advertisers and ASA/UA managers who need to audit iOS ad accounts, diagnose underperformance, or plan optimizations. It is triggered by terms like Apple Ads, Apple Search Ads, ASA, App Store ads, AdAttributionKit, and view-through attribution. A stated limitation is that Maximize Conversions currently optimizes only for installs, not post-install events such as trials, subscriptions, or ROAS. The skill is marked user-invokable: false and expects account data to be supplied for analysis.

FAQ

What does the ASA Health Score measure?

It is a 0-100 score calculated after evaluating all applicable checks as PASS, WARNING, or FAIL across weighted areas: Campaign Structure (25%), Bid Health (20%), Custom Product Pages (15%), Attribution & MMP Health (15%), Budget Pacing (10%), and TAP Coverage (10%).

What input data does the skill need?

Apple Ads account data, either exports from the Apple Ads dashboard or pasted metrics. From there it identifies active placement types and runs the applicable checks.

What is the limitation of Maximize Conversions bidding?

According to the doc, Maximize Conversions (GA February 26, 2026) currently optimizes only for installs, not post-install events; there is no trial, subscription, or ROAS optimization yet. It uses a weekly-average Target CPA, recommends a daily budget of at least 5x target CPA, and needs a two-week minimum learning period.

How does the skill treat Custom Product Pages versus Creative Sets?

Creative Sets are fully deprecated, so CPPs are the sole ad variation mechanism. The CPP limit was doubled to 70 per app in October 2025, and the skill checks that at least 3 CPP variants are tested per campaign type with assets aligned to ad group keyword themes.

Which attribution technologies does it evaluate?

It reviews AdAttributionKit and SKAN/AAK dual attribution (registered April 10, 2025), MMP integration with AppsFlyer, Adjust, Branch, or Singular, ATT opt-in rates, SKAdNetwork conversion value configuration, and attribution windows including WWDC 2025 configurable and overlapping re-engagement windows.

Install ads-apple

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill