Adding New App
This guide describes how to add your app to Apphud
To add a new app, click on "Add new app" at the top:
Or just register and application create screens will show automatically. Fill the information about the app.

App Name

This is a name of the app that will be used in reports.
Then you will have options to configure iOS and Android apps accordingly.

Add iOS App

Bundle ID

To get Bundle ID open App Store Connect, go to "My Apps" and choose your app. At the app page find “Your Bundle ID”.

App Store Shared Secret

How to find App-Specific Shared Secret
Create and copy App-Specific Shared Secret
To get Shared Secret:
  1. 1.
    Open App Store Connect, go to my "My Apps" and choose your app.
  2. 2.
    Select "Manage" under the In-App Purchases heading.
  3. 3.
    Click on the "App-Specific Shared Secret" link on the right.
  4. 4.
    Create and copy the Shared Secret.
Please make sure that App Store Shared Secret you pasted to Apphud is correct.

Add Android App

Package Name

Enter your app's package name.

Service Account JSON

Please provide contents of your Google Play Service Account JSON as described here.

App Store Server Notifications

Providing App Store Server Notifications URL is important. It helps to detect cancellations, refunds and other events in real-time.
In App Store Server Notifications in the server URL window choose the "v1" option for your notifications.
  1. 1.
    Copy your URL for App Store Server Notifications from Apphud. It can be found when adding new app in a wizard or in Apphud > Settings > iOS app settings.
  2. 2.
    Open App Store Connect, go to “My Apps” and choose your app.
  3. 3.
    Under "App Information" find "App Store Server Notifications", paste generated URL under Production Server URL and choose Version 1 Notifications.
Already using App Store Notifications? Not a problem, take a look at our App Store Server Notifications Proxy feature.
If App Store Server Notifications block is missing in App Store Connect, try to create in-app purchases first.
If everything is set up correctly, you should see in Apphud Settings last time when notification is received from Apple. You can read more about App Store Notifications here.
Displays last time when Apple notification is received

App Store Server Notifications Proxy

If you already use App Store Server Notifications and can't paster URL provided by Apphud, you can use App Store Server Notifications Proxy feature. Apphud will automatically send all incoming server-to-server webhooks from Apple to your server.
  1. 1.
    Configure App Store Server Notifications URL for your app.
  2. 2.
    Go to "App Settings" in Apphud.
  3. 3.
    Paste your subscription status URL into "Proxy App Store Server Notifications to this URL" field:

Google Play Service Credentials

This is a difficult process but it is required in order for us to validate in-app purchases in Google Play.
Go to Settings page in your Google Play Console and Open API Access tab:
Click on a "Choose a project to link" button:
Agree to Terms:
Next let's create a service account.

Create Service Account

Click on "Create new service account":
Navigate via link to Google Cloud Platform:
Enter the name of your service account and click "CREATE":
Select "Owner" for this account permissions:
Next you will need to create a new private key for this account:
Select "JSON" key type and click "CREATE":
After that you will need to grant financial access to this account.

Grant Permissions to Service Account

Click on "Grant permissions" button:
Select "Account permissions" and grant the following permissions:
  • View app information and download bulk reports (read-only)
  • View financial data, orders, and cancellation survey responses
  • Manager orders and subscriptions
Click on "Invite User" and "Send Invite".

Grant Permissions to your App

In the Users and Permissions page in App permissions tab select your app and Apply permissions:
Your App permissions should be automatically granted by account permissions. Click on "Apply":

Upload Service Account JSON to Apphud

Upload Service Account JSON file or enter JSON contents to Apphud when creating new app or if you already have created app, then in "Settings > Android app settings" page:
You're done!

Google Real-time Developer Notifications

Configuring Google Real-time Developer Notifications is important. It helps to detect cancellations, refunds and other events in real-time.
Step 1
Step 2
Step 3
Step 4
Step 5
Ensure that Cloud Pub/Sub API is enabled for your project. You can check here.
Ensure Google Play Service Credentials are correctly set up.
In Apphud Settings > Android app settings page click Connect to Google button. After that copy Topic name value show up. Copy entire Topic string.
Go to Google Play Console > Your app > Monetization setup and paste Topic into Topic name field. Click on Send test Notification.
Go back to Apphud settings. If everything set up correctly you should see Last received at date. All done!