Apple Ads

Apple Ads promotes apps within the App Store through targeted campaigns. Create and manage ads to enhance app visibility and user acquisition.

Data Model

• Campaigns are top-level. Ad groups belong to campaigns. Keywords are ad-group-scoped.
• Hierarchy: Campaign → Ad Group → Ad/Keyword. Create in order.
• Reports (campaign, ad group, keyword, search term) require date range. Org context required.
• Apps: Search apps, check eligibility, get details before creating campaigns.
• Creatives, product pages, rejection reasons: Reference data for ad creation.

Gotchas

• X-AP-Context: Report endpoints need org_id in header. From Apple Ads URL.
• adam_id: App identifier for app-scoped operations. From search_apps.
• Setup: EC P-256 keypair; upload public key to Apple Ads; get client_id, team_id, key_id.