CtrlK
BlogDocsLog inGet started
Tessl Logo

dpearson2699/swift-ios-skills

Agent skills for iOS, iPadOS, Swift, SwiftUI, and modern Apple framework development.

71

Quality

89%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

product-page-variants.mdskills/app-store-optimization/references/

Product Page Variants

Custom Product Pages, product page optimization (A/B testing), and in-app event configuration for App Store discoverability and conversion.

Contents

  • Custom Product Pages
  • Product Page Optimization Tests
  • In-App Event Configuration
  • Screenshot Caption Copywriting

Custom Product Pages

Setup in App Store Connect

  1. Navigate to App Store Connect > App > Custom Product Pages.
  2. Create a new Custom Product Page -- each page needs a reference name (internal only) and a locale.
  3. Customize screenshots, app preview videos, and promotional text for the target audience.
  4. Submit the page for review -- Custom Product Pages go through App Review like regular submissions.
  5. Once approved, the page receives a unique URL.

URL structure

Custom Product Pages use the format:

https://apps.apple.com/app/id{APP_ID}?ppid={CUSTOM_PAGE_ID}

The ppid parameter directs users to the custom page instead of the default product page. Use these URLs in:

  • Apple Search Ads ad group URLs
  • Social media campaign links
  • Email marketing campaigns
  • Web landing pages
  • QR codes in physical marketing

Campaign-to-page mapping

Plan Custom Product Pages around distinct acquisition channels:

ChannelPage name conventionScreenshot strategy
Search Ads -- brand termsSearch-BrandHighlight brand trust and breadth
Search Ads -- feature termsSearch-{Feature}Lead with the specific feature the user searched for
Search Ads -- competitor termsSearch-CompetitorEmphasize differentiators vs. category norms
Social -- Instagram/TikTokSocial-VisualVisual-first screenshots matching social creative style
Social -- Twitter/XSocial-UtilityFeature-focused, less visual polish
Email -- existing usersEmail-UpgradeNew feature highlights for re-engagement
Web -- blog/PRWeb-EditorialAward badges, press quotes, credibility signals

Management

  • Audit Custom Product Pages quarterly. Remove pages for ended campaigns.
  • Track performance per page in App Analytics -- compare conversion rates against the default page.
  • Custom Product Pages count toward the 35-page limit per app. Reserve capacity for seasonal or ad-hoc campaigns.

Product Page Optimization Tests

Test design patterns

Each test compares the default product page (control) against one treatment. Only one test runs at a time.

Icon test

  • Hypothesis: A revised icon with [specific change] will increase tap-through rate by improving shelf appeal.
  • Treatment: Alternate app icon that [describes the specific difference].
  • Duration: 7-14 days minimum.
  • Success metric: Conversion rate (impressions to first-time downloads).

Screenshot order test

  • Hypothesis: Leading with [screen X] instead of [screen Y] will increase conversion by showing the primary value proposition sooner.
  • Treatment: Reorder the first 3 screenshots.
  • Duration: 7-14 days minimum.
  • Success metric: Conversion rate.

Screenshot content test

  • Hypothesis: Benefit-oriented captions will outperform feature-descriptive captions.
  • Treatment: Replace captions on the first 3 screenshots with benefit-focused copy.
  • Duration: 7-14 days minimum.
  • Success metric: Conversion rate.

Running a test

  1. In App Store Connect, go to Product Page Optimization.
  2. Choose the element to test (icon, screenshots, or preview video).
  3. Upload the treatment assets.
  4. Set traffic allocation (typically 50/50 for fastest results, or 70/30 to limit risk).
  5. Start the test and wait for statistical significance.

Interpreting results

  • App Store Connect reports conversion rate for control vs. treatment with a confidence interval.
  • Do not apply a treatment until the result shows 90%+ confidence.
  • A 2-5% conversion lift is meaningful at scale -- do not dismiss small wins.
  • If the test is inconclusive after 14 days, the variants are likely equivalent. Move to a different hypothesis.
  • After applying a winner, wait at least one release cycle before starting the next test to establish a clean baseline.

Limitations

  • Only one test at a time per app.
  • Tests run on the default locale only and affect only that locale.
  • The minimum meaningful test requires several thousand daily impressions. Low-traffic apps may need 3-4 weeks.
  • Icon changes via Product Page Optimization do not affect the icon inside the app -- only the App Store listing.

In-App Event Configuration

Event metadata template

FieldLimitGuidelines
Event name30 charsKeyword-rich, action-oriented. "Spring Fitness Challenge" not "Our Spring Event"
Short description50 charsOne compelling sentence visible on the event card
Long description120 charsExpand on what the user will experience or win
Event card image1920x1080 (16:9)High-contrast, legible at small sizes, no text smaller than 24pt
BadgePreset optionsMatch badge type to event nature (see SKILL.md table)
Deep linkURLOptional. Links to the in-app event content

Scheduling strategy

Plan events to maintain continuous App Store visibility:

Week 1-2:  [Event A -- "Spring Challenge" (Challenge badge)]
Week 3-4:  [Event B -- "New Workout Library" (Major Update badge)]
Week 5-6:  [Event C -- "Summer Kickoff" (Special Event badge)]

Overlap the end of one event with the start of the next by 1-2 days. This prevents gaps where the app has no event card in search results.

Event timing rules

  • Events can be published up to 14 days before they start.
  • Events are visible in search results and on the product page during their active window.
  • Ended events are removed from the store automatically.
  • Schedule events around real moments (feature releases, content drops, seasonal relevance) -- manufactured events without real in-app content feel hollow and may be rejected by App Review.

Maximizing search impact

  • Use the event name and short description as keyword surfaces. Include terms that complement (not duplicate) the app's keyword field.
  • Choose a badge type that matches the actual event nature -- the badge appears prominently on the event card and affects how the App Store surfaces the event editorially.
  • In-app events can appear on the Today tab, in search results, and on the app's product page. Apple's editorial team curates which events are featured.

Screenshot Caption Copywriting

Benefit-oriented vs. feature-descriptive

Feature-descriptive (weak)Benefit-oriented (strong)
Calendar ViewNever miss a deadline
Dark ModeEasy on your eyes, day or night
Cloud SyncYour data, everywhere
Analytics DashboardSee what is working
Collaboration ToolsBuild together in real time
Offline ModeWorks without internet
Custom ThemesMake it yours
Push NotificationsStay in the loop

Caption structure

The strongest captions follow one of three patterns:

  1. Outcome-first: State the result the user gets. "Track every mile" > "GPS Running Tracker".
  2. Problem-solver: Name the pain point and imply the solution. "No more forgotten passwords" > "Password Manager".
  3. Social proof: Imply scale or trust. "Join 10M users" > "Popular App".

Per-audience caption variants

Different Custom Product Pages should use different captions for the same screenshots:

ScreenshotSearch Ads -- fitness termsSocial -- visual audienceEmail -- lapsed users
Workout screen"Hit your goals every week""Your workout, beautifully tracked""We added 50 new workouts"
Progress chart"See your streak grow""Watch your progress unfold""Your history is still here"
Social feature"Challenge your friends""Share your wins""Your friends are still active"

Tailor the emotional angle to the acquisition channel while keeping the screenshot content consistent.

skills

CHANGELOG.md

README.md

tile.json