asc Experiments (Product Page Optimization)

A Product Page Optimization test shows a share of App Store visitors one of up to three alternate product pages ("treatments") instead of the original, so you can measure which converts better. Apple's API calls these appStoreVersionExperiments; the CLI calls them experiments.

Hierarchy: App → experiment → experiment-treatment → experiment-treatment-localization.

Preconditions Apple enforces (the CLI surfaces them as 409 errors — don't retry, explain them):

• The app must have a version in READY_FOR_DISTRIBUTION (or pre-order ready) on the target platform. Otherwise create fails with STATE_ERROR.PPO_CREATE_ONLY_ALLOWED_WITH_APP_STORE_DISTRIBUTION. Check with asc versions list --app-id <id> first.
• A test runs for at most 90 days or until stopped.
• More treatments → longer to reach significance; --traffic-proportion is split evenly across treatments (30% with three treatments = 10% each).

Resolve App ID

See project-context.md — check .asc/project.json before asking the user or running asc apps list.

List / inspect