At a glance: Learn how to add your app to AppsFlyer so you can get attribution data on installs and in-app events, and analyze the data using the different tools on AppsFlyer.
Overview
If you haven't yet added an app to your dashboard, the app onboarding page will display when you log into AppsFlyer. App onboarding guides you through all the steps to add your app and also get it ready for attribution.
Entering the wizard for adding an app
You can enter the wizard for adding apps from the platform or you can add your app via the app onboarding page (for Android and iOS apps only).
To enter the wizard from the app onboarding page:
- In the Add your app step, click Add app and follow the instructions for adding an app.
Note
If the onboarding page isn't already open, from the top menu bar > email address dropdown, click App onboarding.
To enter the Add an app wizard from the platform:
- From the top menu bar > My Apps, click + Add app
- From the AppsFlyer Homepage, click + Add app
- From the top menu bar > email address dropdown > App onboarding, click + Onboard another app
Adding an app
After you've entered the Add an app wizard, follow these steps:
- Enter the app details.
- Enter additional information.
- Click Add my app.
- Copy the Dev key, to be used in the SDK integration (you can retrieve it later from the App Settings page).
- Click Done or + Add another app for adding more apps.
Note
- Only admins and account users with the necessary permissions are able to add apps.
- As you follow the steps for adding an app (below), the available options will vary depending on the previous options you've selected.
After registering the app, it will appear on the dashboard. To have installs and in-app events recorded and attributed to the correct media sources, you'll need to:
- Integrate the SDK
- Connect the app to partners in the Partner Marketplace
See all the steps for completing the onboarding process.
Enter app details
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)
|
|
Pending approval/not published |
Your app is not yet published or is pending approval from Google Play |
Android package name
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
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)
|
| 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
|
Windows
Use this option for the following platforms:
- Windows Phone
- 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)
|
| Pending approval/not published |
Your app is not yet published or is pending approval from the store
|
App ID assigned by the Microsoft Store
|
Web (PBA)
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.
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:
LG WebOS
App name: The name you have chosen for your app
App ID: The LG WebOS app ID
PlayStation
App name: The name you have chosen for your app
App ID: The PlayStation concept ID, a unique identifier assigned to a game or other content concepts. It appears as a 5-9 digit number in the PlayStation store URL:
Vidaa
App name: The name you have chosen for your app
App ID: The Vidaa app ID
Steam
App name: The name you have chosen for your app
App ID: The Steam app ID. This is the 5-8 digit number that appears in the Steam store URL:
Meta Quest (Oculus)
App name: The name you have chosen for your app
App ID: The Meta Quest app ID (as it appears in the store from which the app is downloaded)
- Example: 1903584373052986
Nintendo Switch
App name: The name you have chosen for your app
App ID: The Nintendo Switch app ID (as it appears in the store from which the app is downloaded)
Xbox
App name: The name you have chosen for your app
App ID: The Xbox app ID (as it appears in the store from which the app is downloaded)
- Example: 9wzdncrfhwfg
- Note: App ID is case sensitive
Epic Games
App name: The name you have chosen for your app
App ID: The Epic Games app ID (as it appears in the store from which the app is downloaded)
Native PC
App name: The name you have chosen for your app
App ID: The Native PC app ID (possible charachters: A-Z a-z 0-9 . _ -)
Enter additional information (not applicable to web apps):
-
Select 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.
-
Select timezone
Align the timezone you select here with the timezone you set with other attribution partners (such as Meta ads 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.
-
Select indication of a child-directed app
Select Yes or No to indicate whether or not your app is directed to children or to a mixed audience (both children and adults).
If you've selected Yes:- Open and read the guide about implementing compliance with child-directed apps.
- Select the box to confirm you've read the guide and will implement the controls it specifies.
Note
Two weeks after adding the app, you'll get a notification asking you to confirm you've implemented privacy controls for your child-directed apps. After confirming, you'll get a confirmation message. You can always access the confirmation message from the Notification center or see the confirmation details in the Audit log.
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:
App wasn't added
If this error occurs, contact your CSM or send an email to hello@appsflyer.com.
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:
- Add the app with a status of Pending approval/not published, as described above.
- Go to the AppsFlyer App settings page.
- Change the App store country to the correct country (for example, Japan).
Something went wrong. Please try again.
One possible reason for this error is trying to add an Android app without a country code (for apps not listed in the US Google Play Store). See full details for resolving this issue above.