[titerman]

App Store setup: rework the guide, the key articles, and the screenshots

1. Outdated content, now current

• Screenshots: All 25 setup screenshots are new. The old set included a 2021 dashboard, a 2023 settings page with the sections in the wrong order, and App Store Connect pages from before the 2025 sidebar changes.
• iOS SDK settings page: The ios-settings table now lists every section in page order. SDK status, the App Store Connect API key, Retention Messaging, and the forwarding URL were missing. The shared secret no longer carries a "Legacy" label.
• App Store Connect paths: The guide sent readers to a Team keys item under Integrations and to an API keys table. Team keys are on the Team Keys tab of App Store Connect API, and every key is in the Active list.
• Server notifications: All four statuses are documented: Waiting, Active, Delayed, and Stalled.
• Forwarding article: It showed Version 1 payloads, and no article linked to it. It's now App Store only, describes the Version 2 body, and is in the sidebar.
• Transfers: The App Store section named only the App Store Connect API key, and it said the shared secret keeps purchases validating during a transfer. It now covers both keys and the shared secret, in the order that keeps purchases working.
• Troubleshooting: The claim that unsigned Apple agreements are the most common reason products don't appear is gone.
• Making-purchases articles: The StoreKit 1 shared-secret note is removed from all six platforms.

2. Changes driven by support traffic

What support saw	What changed
Products missing or blank in Adapty, often from a missing or wrong App Store Connect API key	A new article for the App Store Connect API key, a troubleshooting section with causes in order, and a check of the key in the main guide
Purchases unvalidated after an app moved to another Apple developer account	The transfer steps split into before and after Apple completes the transfer, with a warning to save the new In-App Purchase key right away. Both key articles link to it.
Notifications shared with another server	Steps to set up forwarding, the sandbox case, and a warning against forwarding loops
"Is my setup complete?"	"Check that each credential works" in the main guide, with one check per credential
More trials than installs right after setup	An explanation of transactions without profiles, in the main guide, how-profiles-work, cohorts, and LTV
What breaks without notifications	The notifications article opens with the events only notifications report, refund requests for Refund Saver included
The notification URL of one app pasted into another app	The steps say each Adapty app has its own URL
A revoked In-App Purchase key	"Save a new key in Adapty before you revoke the old one"
Setup by someone who can't generate keys	The required role at the generation step, and what to do without it
One key for several apps	"One key serves every app of your App Store Connect team"
Promotional offers failing with a key that saved	A note that a different key saves without an error but breaks promotional offers
Retention Messaging without the promotional offers key	The Retention Messaging prerequisites list every value it uses
Family Sharing turned on by a push	A callout in the product creation article
Apple rejects a key with correct values	Troubleshooting says to contact support

3. Other improvements

• Main guide structure: Prerequisites first, then a numbered overview of the seven steps. One H2 per credential, in App Store Connect page order. "Next steps" comes last.
• Key generation: The main guide covers only adding each key to Adapty and links to the key articles for generating one, which keeps the guide shorter.
• One copy of each step: Five new snippets (AppStore*.mdx) hold the steps that the guide and the key articles share.
• Sidebar: "Configure App Store integration" is now a category with the four single-purpose articles under it.
• Steps and screenshots: Each step works in one console, App Store Connect or Adapty, and has its own screenshot. A purple outline marks the element the step names, and real account data is blurred.
• Wording: Conditions come before instructions, every action has a named actor, and terms match the docs and the UI throughout.
• Links: Links in about 30 articles point to the new sections. Old step anchors are gone.