Docs

App Store Connect

Connect your Apple developer account so Fload can pull sales reports, subscription data, analytics, and app store reviews.


What it pulls

DataDescription
Net revenue (Proceeds)Your take after Apple's 15–30% cut
Gross revenueTotal customer spend
Downloads / UnitsFirst-time downloads and re-downloads
Page views & impressionsApp Store product page traffic
Active subscriptionsCurrent active sub count by product and country
New trialsTrial starts
Trial conversion rate% of trials that converted to paid
Subscription retention rateRenewal rate by cohort
Sessions & active devicesEngagement metrics
CrashesCrash count (requires analytics opt-in)
Paying usersUnique users who made a purchase
ReviewsEvery App Store review for use by the Review Agent

All metrics support dimensional breakdown by country, region, source, platform, app version, product, and referrer (where Apple provides it).


Setup method: invitation-based

Fload uses invitation-based setup — you invite Fload's service account to your App Store Connect team, and Fload handles authentication automatically. You do not need to create API keys.

Steps

  1. In Fload, go to Connectors → Add connector → App Store Connect.
  2. Search for your app by name or your developer name.
  3. Fload shows you the email address to invite.
  4. In App Store Connect, go to Users and Access → People → Invite People.
  5. Enter the email address Fload showed you.
  6. Set these roles:
  • Finance — required for sales and revenue reports
  • Customer Support — required for reading and replying to reviews
  • Sales (optional) — for some analytics access
  1. Click Invite.
  2. Back in Fload, click Continue — Fload will detect the invitation and activate automatically.

Required roles

RoleWhy it's needed
FinanceDownload financial sales reports
Customer SupportRead reviews, post replies
SalesAdditional analytics coverage

The Admin role is not required and should not be granted.


What features this enables

  • Metrics dashboard (revenue, downloads, subscriptions)
  • AI chat — query your app data
  • Anomaly detection on all supported metrics
  • Revenue forecasting
  • Review Agent (requires Customer Support role)
  • Weekly digest email and Slack notifications

Troubleshooting

Connector shows as "error" or "unhealthy" Apple may have revoked the invitation or the session expired. Go to Connectors, click the connector, and check the health status message. Re-inviting the account usually fixes it.

No data after 24 hours App Store Connect reports are delayed by 1–2 days (Apple's reporting lag). Financial reports are typically available by 8 AM Pacific the following day.

Reviews aren't showing up Reviews require the Customer Support role. Check your team's roles in App Store Connect.

Subscription metrics are empty Active subscription counts require subscription products in your app. If you only use one-time purchases, these fields will be zero.