Prerequisites
Before continuing, make sure you have:- Completed the Superwall setup guide
- Set up Google Play Console
- Created Android products in Google Play Console
- Set up a Google Cloud project (or be ready to create one)
Important Information Before Starting:
- Google Play revenue tracking is currently in private beta with Superwall
- This integration is complex - follow all steps exactly as described
- After configuration, it may take up to 36 hours for the keys to start working
Configure revenue tracking
1
Access or create a Google Cloud project
- Visit the Google Cloud Console
- If you’ve already set up Push Notifications for Android, or Google Authentication, use that same project
- Otherwise, click Create Project and follow the prompts to create a new one
2
Enable required Google APIs
- Enable Google Play Android Developer API
- Enable Cloud Pub/Sub API
- Verify both APIs show a blue Manage button next to the Try this API button and a green API Enabled check
3
Create a new service account
- Visit Service Accounts and create a new user
- Fill in the service account details (name, ID, description)
- For permissions, add:
- Pub/Sub Admin role
- Monitoring Viewer role
- Skip the Principals with access step
4
Download the service account credentials
- Click on the newly created service account
- Go to the Keys tab
- Click Add key
- Select Create new key
- Select JSON
- Click Create
- Save the downloaded JSON key file securely
5
Upload credentials to Superwall
- In Superwall dashboard, go to Settings > Revenue Tracking
- Pick Google Play (Forward events from Google Play)
- Enter your app’s Package Name
- Upload the JSON key file to Google Play JSON Key
- Click Save
- Notice the Topic field that appears below the Save button.
- Click on it and pick the link from the dropdown.
- Copy this generated Topic Name for use in the next step.
6
Add service account to Google Play Console
- Visit Google Play Console
- Select Users and Permissions
- Click Invite new users
- Paste in the email address of the service account you created
- Select Account Permissions
- Add the following permissions:
- View app information and download bulk reports
- View financial data, orders, and cancellation survey responses
- Manage orders and subscriptions
- Click Invite
7
Configure Pub/Sub in Google Play Console
- Go to your app within the Google Play Console
- Select Monetize with Play > Monetization setup
- Under Google Play Billing, check Enable real-time notifications
- Under Notification content, select Subscriptions, voided purchases, and all one-time products
- Paste the copied Topic Name from Superwall into the Topic name field
- Click Save
Your Superwall revenue tracking is now configured for Android. Note that it may take up to 36 hours for the keys to start working properly.
Next steps
After completing revenue tracking setup, continue with:- Configure Superwall products for Android - Set up entitlements, products, and paywalls