Adding a new app

At a glance: Add your app to AppsFlyer to record its installs and in-app events and attribute them to the correct media sources.

Adding an app

If you haven't yet added an app to your dashboard, the first screen you see will ask you to add one. To add additional apps after the first, go to the My Apps page, and click the Add app button. Then, just follow the wizard steps as described in the tabs below.

Note: Only the account admin and team members who have been assigned add app permissions are able to add apps.

1Select app status

add an app step 1


Status When to use it

In store

Your app is currently available in one of the proprietary app stores: iOS App Store, Google Play, Windows Phone Store.


Your app is not yet published or is pending approval from the store. (This is useful when you are debugging the app to test the AppsFlyer SDK).

Once your pending app goes live, AppsFlyer will automatically update its status, so you don't need to add it again.

3rd-party app store

Your app is in an Android app store other than Google Play


If your app is available in more than one Android app store (namely, in any combination of Google Play and/or 3rd-party stores), it is vital to consider the options for setting up multi-store Android attribution. Proper implementation from the beginning will ensure that you can access the data that you need in the format that you need it. 

2Add store details

add an app step 2.png


App status
(from step 1)
Store Details
In store iOS App Store App Store URL (copied from the App Store)
  • Example:

    An app added to the App Store prior to June 14, 2019, may contain in its URL (instead of

Google Play

Google Play URL (copied from Google Play)

  • Example:

Windows Phone Store

Windows Phone Store URL (copied from the Windows Phone Store)

  • Example:

iOS App Store

Country of the App Store to which the app has been submitted


App ID assigned by the App Store, without the prefix id

  • Example: 1543229303

Google Play

Android package name

  • Example: com.appsflyer.adNetworkTest
  • Note: Package name is case sensitive

Windows Phone Store

App ID assigned by the Windows Phone Store

  • Example: 9wzdncrfhwfg
  • Note: App ID is case sensitive
3rd-party app store

Android package name

  • Example: com.appsflyer.adNetworkTest
  • Note: Package name is case sensitive

Channel name (for example, Amazon)


App URL (copied from the 3rd-party app store)


3Set time zone and currency

add an app step 3

Time zone: Align the time zone you select here with the time zone you set with other attribution partners (such as Facebook and Google Ads). This ensures the closest match between the data reported in the AppsFlyer dashboard and the data you receive from these partners. Learn more about an app's time zone setting and its impact.

Currency: Select the currency in which this app's data will be displayed in the dashboard. Revenue and spend events are converted to this currency using the exchange rate in effect at the event time. Learn more about an app's currency setting and its impact.


Use care in selecting the currency you want to use for this app. You won't be able to change it once cost and revenue have been recorded.


Find solutions for some common issues: 

App wasn't added

If this error occurs, contact your CSM or send an email to

App not in the store

Confirm that you have copied the store URL correctly, using the appropriate app name/ID.

Can't access marketplace

This error sometimes occurs when adding an Android app from a non-US store. Follow these steps to resolve it:

  1. Add the app with a status of Pending, as described above.
  2. Go to the AppsFlyer App settings page.
  3. Change the App store country to the correct country (for example, Japan).

Once the app has been added, AppsFlyer will automatically detect that the app is live and update its status accordingly.

Was this article helpful?