Adding a new app

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.

To add an app to your AppsFlyer account:

1. Select the app platform and enter the required details, as listed below:

   Android, AndroidTV, Fire

   Use this option for the following platforms:

   • Android (mobile)
   • AndroidTV
   • Amazon Fire
   • Amazon Fire TV
   • Kindle

   Google Play status	When to use it	Required details
   In store	Your app is currently available in the Google Play store	Google Play URL (copied from Google Play) Example: https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest
   Pending approval/not published	Your app is not yet published or is pending approval from Google Play	Android package name Example: com.appsflyer.adNetworkTest Note: Package name is case sensitive Format: At least two segments (one or more dots) Each segment must start with a letter All characters must be alphanumeric or underscore (a-z, A-Z, 0-9, or _) Maximum length of 100 characters For more information, see Android developer documentation
   3rd-party store/out-of-store	Your app is in an Android app store other than Google Play, and/or it can be downloaded from a location other than an app store	Android package name For detailed requirements, see previous row (Pending approval/not published)   Channel name: a unique name you set for each 3rd-party store/location in the individual APK prepared for that store/location Example: Amazon Format: Upper or lower-case letters only (a-z or A-Z). No other characters, such as hyphen (-) or underscore (_), are permitted.   App URL (copied from the 3rd-party app store or out-of-store location)    Important! If your app is available from more than one source (in other words, any combination of Google Play, 3rd-party stores, or out-of-store locations), 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.

   ioS, tvOS, MacOS

   Use this option for the following platforms:

   • iOS
   • tvOS
   • MacOS

   App Store status	When to use it	Required details
   In store	Your app is currently available in the App Store	App Store URL (copied from the App Store) Example: https://apps.apple.com/us/app/partner-integrations/id1543229303 Notes: Be sure that the URL includes the 2-letter country code of the store (for example, us in the URL above) An app added to the App Store prior to June 14, 2019, may contain itunes.apple.com in its URL (instead of apps.apple.com).
   Pending approval/not published	Your app is not yet published or is pending approval from the 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 Format: 9 or 10 numeric characters, 0-9

   Windows Phone, Xbox

   Use this option for the following platforms:

   • Windows Phone
   • Xbox
   • Windows (desktop)

   Microsoft Store status	When to use it	Required details
   In store	Your app is currently available in the Microsoft Store	Microsoft Store URL (copied from the Microsoft Store) Example: https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg Note: The URL above is an example for a Windows Phone app. URL format varies for Xbox and Windows desktop apps.
   Pending approval/not published	Your app is not yet published or is pending approval from the store	App ID assigned by the Microsoft Store Example: 9wzdncrfhwfg Note: App ID is case sensitive

   Roku

   App name: channel name copied from the Roku Developer Dashboard.

   • Example: My Roku channel
   • Format:
     • Maximum length of 100 characters
     • XSS tags not permitted

    

   Channel ID: numeric ID assigned to the channel by Roku

   • Example: 1234567
   • Format:
     • Numeric characters, 0-9
     • Maximum length of 50 characters
   • How do I find it?
     • From the Roku Developer Dashboard, click on the name of the channel you are adding to AppsFlyer. This opens the Roku Preview & Publish page for the channel.
     • The number at the end of the page's URL in your browser is the Channel ID:

       

   Vizio SmartCast

   App name: the name you have chosen for your app

   App ID: the ID of the app as recognized by Vizio (usually starting with the letters vz). If you need to confirm the app ID, check with your Vizio representative.

   Samsung Tizen

   App name: the name you have chosen for your app

   App ID: the Bundle ID assigned to your app by Samsung. You can find it at the end of the app store URL of your app:

   

   Web

    Note

   A web app is where you define a website to include in a brand bundle for our People-Based Attribution (PBA) feature.

   • This option is available only to customers who have subscribed to PBA.
   • Learn more about PBA and attributing web visits, web events, and website-assisted installs to obtain a unified view of customer journeys across channels, platforms, and devices.

    

   Full URL: the full URL of the website for which you want to measure traffic. This is the website on which you have implemented (or will implement) the PBA Web SDK.

   

   Include –

   • scheme
   • subdomain [optional]
   • domain name
   • top-level domain
   • path [optional] – the address of a specific directory or page on your website

    

   App name: the name you have chosen for your app 

   • Maximum length = 100 characters
   • XSS tags not permitted

    

    Important!

   Once you create a web app, you are not able to edit its properties (URL and app name) without deleting it and re-creating it, which means you also must delete the brand bundle of which it is a part.

    

   Next steps:

   • Add your newly-created web app to a PBA brand bundle to see it on the PBA dashboard.
     • Make sure all the mobile apps you want to include in the brand bundle have been added to your account before creating the bundle.
   • Integrate the PBA Web SDK to the website specified in the web app to get the measurement data flowing.
2. Set timezone and currency (not applicable to web apps):

    

   

   Timezone: Align the timezone you select here with the timezone 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 timezone 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.

   Important!

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

About pending apps

Working with an app in pending status can be useful when you are debugging it to test the AppsFlyer SDK.

The status of the app as pending on the dashboard has no effect on data collection and measurement. Whether an app is pending or live on an app store, if users install and interact with it, install and in-app event data is recorded on the dashboard just the same.

Once your pending app goes live, AppsFlyer will detect and automatically update its status, so you don't need to add it again. Learn more about pending apps and the optional procedure for manually refreshing status.

Troubleshooting

Find solutions for some common issues: