Connect App Store and Google Play

1. 1

   Enroll in the Apple Developer Program

   Paid membership with signed agreements in App Store Connect. Without active agreements, Sales and Analytics APIs return 403.

   App Store Connect → Agreements ↗
2. 2

   Create an App Store Connect API key (Admin access)

   Users and Access → Integrations → App Store Connect API → Generate API Key. Select Admin role — required for Analytics report requests. Download the .p8 file immediately; Apple only shows it once.

   Role	What it unlocks
   Adminrequired	Request App Analytics reports (ONGOING + snapshot), commerce & engagement data
   Sales and Reportsrequired	Daily Sales CSV (1F/3F/7F), vendor reports, 120-day backfill
   Finance	Monthly payout / finance reports for proceeds reconciliation
   Developer (minimum)	App metadata only — not sufficient alone for ReveIQ metrics

   App Store Connect → Integrations ↗
3. 3

   Upload your AuthKey .p8 file in ReveIQ

   Filename is usually AuthKey_XXXXXXXXXX.p8 — we auto-fill Key ID from the filename. Paste Issuer ID from the same Integrations page (UUID at the top).

4. 4

   Vendor number + App ID

   Vendor number: Payments and Financial Reports → Payments (numeric). App ID: your app’s App Information page in App Store Connect (numeric Apple ID, not bundle ID).

5. 5

   Allow time for first Analytics

   App Analytics reports take 24–48 hours after first connect. Sales CSV often arrives sooner — ReveIQ imports both automatically.

1. 1

   Create a service account in your Google Cloud project

   IAM & Admin → Service Accounts → Create. Download the JSON key — ReveIQ stores the private key encrypted in Vault. Each customer uses their own GCP project.

   Google Cloud Console → Service Accounts ↗
2. 2

   Enable all three Google Cloud APIs on the same project

   Without these APIs enabled, ReveIQ cannot fetch subscriptions, DAU, or GCS report files — even with correct Play Console permissions.

   • Google Play Android Developer API: App name, live version, subscription products, and replying to reviews
   • Google Play Developer Reporting API: Daily active users, crash and ANR rates, and how fresh Play’s data is
   • Cloud Storage API: Reading the report files Play Console exports: installs, sales and reviews

   Google Cloud → API Library ↗
3. 3

   Link your GCP project in Play Console API access

   Play Console → Setup → API access → Link the same Google Cloud project as your service account JSON. Without this link, Publisher and Reporting API calls return 403 even when Cloud APIs are enabled.

   Play Console → API access ↗
4. 4

   Invite your service account in Play Console

   Play Console → Users and permissions → Invite user → paste your service account email (client_email from JSON). Grant permissions below — account-level permissions must be Global.

   Permission	Why
   View app information and download bulk reports (read-only)required	Account permissions must be Global per Google GCS access rules. Propagation up to 24h.
   View financial data	Required for revenue. Free apps with no IAP may have an empty sales/ folder.
   Reply to reviews	Optional. Historical review text still comes from monthly GCS CSV.
   View app quality information (read-only)	Recommended if DAU / Reporting API data is empty.
   Release manager	Optional.

   Google Play Console → Users and permissions ↗
5. 5

   Copy your Play Developer account ID

   Numeric ID from your Play Console URL (…/developers/6346619589899593870/…) or from a GCS bucket name (pubsite_prod_6346619589899593870). Example ID shown for format only — use your account's number. This is not your GCP project_id.

6. 6

   Copy Cloud Storage URI (recommended)

   Play Console → Download reports → Statistics or Financial → “Copy Cloud Storage URI” (e.g. gs://pubsite_prod_rev_6346619589899593870). Paste the bucket name in ReveIQ connect if auto-detect fails. ReveIQ also accepts the numeric developer ID and probes both pubsite_prod_* layouts.

7. 7

   Allow time for first data

   GCS bulk stats typically post 3–7 days after each calendar day. DAU uses the Reporting API (FreshnessInfo). ReveIQ syncs GCS at 12:00 & 20:00 UTC; API reviews at 11:30 UTC when Reply to reviews is granted. Play invitations expire in 30 days if not accepted.

If you just created or invited this service account, Play Console permissions and GCS bucket access can take up to 24–48 hours to propagate. ReveIQ will keep syncing automatically — empty data usually means Google has not granted access yet, not a broken connection.

Troubleshooting

“No app with ID … in this App Store Connect account”

Use the numeric Apple ID from App Information, not the bundle ID (com.example.app), and make sure the key belongs to the same App Store Connect team as the app.

“This key needs the Admin role”

Keys can’t be changed after creation. Generate a new key with the Admin role and connect again.

“Apple didn’t recognize the vendor number”

Copy it from Payments and Financial Reports. It’s a number, usually 8 digits, shown under your name at the top left.

“That’s an OAuth client file, not a service-account key”

You downloaded an OAuth client from APIs & Services → Credentials. You need the key from IAM & Admin → Service Accounts → your account → Keys.

Google Play connected but shows no installs

New service-account permissions can take 24–48 hours to reach the report bucket, and Play posts daily statistics 3–7 days late. ReveIQ keeps syncing; numbers appear without any action.

Google Play shows installs but no revenue

Grant the service account “View financial data” in Play Console. Free apps with no purchases have no sales files, which is expected.

Still stuck? Email harin.shah@outofbox.solutions with the error message you see.