-
How are my log in credentials stored and used?
We use advanced encryption to store the credentials of your linked accounts and we only use these credentials when syncing your account.
-
Why isn't my data being automatically imported?
If you'd like your data to be automatically imported, then you must enable auto import. Any user with admin privileges can enable auto import by visiting Account Settings (top right corner)> Linked Accounts and checking the Auto Import checkbox. Auto import is not available in the Starter plan. If you are still having issues, Get in Touch.
-
What role should I assign my sub user in iTunes Connect?
iTunes Connect offers several roles a sub-user can have, each providing access to different parts of the platform. While we support several different roles, we highly suggest selecting the Finance role. This is the only role that provides us with access to all necessary reporting areas while limiting access to most other areas of iTunes Connect. Supported roles: Role Sales reports Usage Analytics Financial reports Payments Recommended - This role provides exactly the access we need to reports while limiting access to everything else we don't need." data-toggle="tooltip">Finance (recommended) Admin Legal Sales + Reports Important note: Sales and Reports are separate roles, however both are required for proper syncing.
-
Is auto import secure?
Yes. Auto import runs over secure SSL and only connects directly to the reporting area of the app stores. The data is then imported and saved securely on our own servers.
-
I just linked my iTunes Connect account, however, I can only see the last 365 days of daily data, why is this?
iTunes Connect retains a limited number of daily, weekly, and monthly reports. When you link your iTunes Connect account, we'll attempt to sync as many reports as we can get, but depending on when your app went live we may not be able to get all historic data. A different number of reports is available for each granularity: Daily: 365 days* Weekly: 26 weeks Monthly: 12 months Yearly: All * Although daily reports are reported to go back a full year we've found out that reports for dates prior to November 27th 2014 are not available. FYI - we never delete any reports from your account, so going forward you will always have access to all of your reports inside your Archive.
-
Why is Appfigures payment data “estimated,” despite the fact that Apple creates these reports?
First and foremost: currency conversions. Apple does NOT give conversions for daily, weekly, or financial data. Apple does provide developers with the amount of yen, dollars, or pounds that they’ve made, but all of this data is in it’s original raw currency. Apple converts currencies only once, at the end of each payment cycle. At appFigures, our goal is to create a platform that’s useful. Seeing how much money you’ve made in a handful of different currencies is not all that useful. So, we decided to provide conversions for daily, weekly and financial data. These conversions provide real time estimations of the amount that you are making. However, please keep in mind that this data must remain an estimate since it relies upon fluctuating currencies. Another wrinkle is that Apple’s payment reports are generally released much after the fact—it’s not unusual for these reports to be finalized a month, or two after the downloads for which they compensate.
-
I migrated from a personal account to a business account in iTC, now what?
During the migration, Apple separates your accounts and in some situations publishes reports for both. In this case, we will need to manually combine the reports. After migrating the accounts, it usually takes three full days for Apple to receive accurate data.
-
Can I track my iBooks?
Yes!
-
Can I track Mac Apps?
Yes!
-
Can I link multiple app store accounts to my appFigures account?
Absolutely! To link an external store account select Account Settings (top right corner)> Linked Accounts> Link an Account. * Note: You will need owner, or admin privileges to perform this action. If you are set up as a viewer and need to link an account, please contact the account admin(s).
-
How can I link my Google Play account without sharing my private credentials?
We recommend that you create a read-only sub-user in your Google Play Developer Console dedicated exclusively to your Appfigures account. This way you won't have to share your personal credentials, which most likely have access to sensitive features we don't need access to (such as banking information and control over your apps). We require credentials because Google does not provide any other way for us to connect to Google Play (such as OAuth). If you already have a set of credentials for your Google Play Developer Console go ahead and link your account by visiting Account settings → Linked Accounts → Link an Account. Creating a sub user in the Google Play Developer Console To create a sub-user, start by logging into your Google Play Developer Console. FYI - You'll need to have admin privileges to continue with this process. Click Settings → User Accounts & Rights. Select Invite new user at the top of the page. Give the sub-user and email that isn't your main email but you have access to. If you don't have a separate email you can use your own email with a +appfigures before the @ (Ex. hello@app.com → hello+appfigures@app.com) which will send emails to your regular inbox, but will look like a unique address. This is called Plus Addressing and works with most major email providers. Set Access expiry date to Never. Set the role to Finance. This role provides read-only access to reports without the ability to manage your apps or banking information. Select Send invitation. Google will send an email to the address you provided. Follow the instructions in the email to complete the setup. When setting up your password we suggest using a complex password since you won't really have to remember it after entering it into your Appfigures account. Once the account is ready head back into your Appfigures account and into Account settings → Linked Accounts → Link an Account.
-
How can I link my iTunes Connect account without sharing my credentials?
We recommend that you create a read-only sub-user in your iTunes Connect account dedicated exclusively to your Appfigures account. This way you won't have to share your personal credentials, which most likely have access to sensitive features we don't need access to (such as banking information and control over your apps). We require credentials because Apple does not provide any other way for us to connect with iTunes Connect (such as OAuth). If you already have a set of credentials for an iTunes Connect account go ahead and link your account by visiting Account settings → Linked Accounts → Link an Account. Creating a sub user in iTunes Connect To create a sub-user, start by logging into your iTunes Connect. FYI - You'll need to have admin privileges to continue with this process. Select Users and Roles and then select the + option at the top of the page. Set the First Name and Last Name fields to to Appfigures Set the email field to an email that isn't your main email but you have access to. Select Next to select permissions. Select the Finance OR Sales and Reports permissions. More details Select Next and then Save. Apple will send an email to the address you provided. Follow the instructions in the email to complete the setup. When setting up your password we suggest using a complex password since you won't really have to remember it after entering it into your Appfigures account. Once the account is ready head back into your Appfigures account and into Account settings → Linked Accounts → Link an Account.
-
Do I need to add an SDK to my app in order to track it?
No. We pull our data directly from the app stores. To start tracking your sales and downloads simply link your app store account(s) by visiting Account Settings (top right corner)> Linked Accounts> Link An Account.
-
If I have a universal app is there a way of knowing which device the download came from?
At the moment, no. If stores decide to publish this data then we'll be able to import it into appFigures, but at the moment, this data is not shared. The only way to know the breakdown of device downloads is to make device-specific apps.
-
How often is the featured data updated?
The positions of featured apps change about once a day (unlike ranks, for example, which change much more often). We fetch this information several time a day to ensure that we have the latest data. To ensure that you're looking at the most up to date info in the featured report, choose Today from the date selection drop-down at the top of the page.
-
When will my apps sync after linking my external store account(s)?
A sync will start in the background automatically when an external store account is successfully linked. Syncing may take some time depending on the source, the number of products, and the size of the dataset. Most syncs complete within a few minutes, but in some cases, it may take several hours for a full sync to complete.
-
After transferring an app from one iTunes Connect developer account to another, how do I ensure appFigures coverage?
As long as the account the app is moving into is also linked up to your appFigures account, then you'll continue to pull in data for the app. The app will simply stop getting data from the old linked account and start getting data from the new one. The change will be seamless within your appFigure account and all historical data will remain in your Archive.
-
My reports are missing data, why is this?
This tends to happen when automatic importing is no longer active. Automatic importing will fail when the saved credentials on your external store account are either old, or incorrect. Users with admin privileges can resolve this issue by visiting the [sync page].(http://appfigures.com/account/externals) Select the account that is not syncing and click on the edit button to update your credentials. Once these credentials have been updated, data should become available within the hour. _Protip: if you do not wish to wait for the auto import to complete, you can sync your account on demand by visiting the sync tab on any of your sales reports. _
-
What is the store status report?
iTunes Connect and Google Play release new reports daily. However, the release times for these reports vary. As a result it's tough to predict exactly when these numbers will be published. If your email report hasn't arrived yet, or if your appFigures sales data doesn't reflect your app's most recent transactions, the store status page is a good place to check.
-
Mapping ad units and usage properties to apps
We import data from a variety of data sources and display that data by app. Some data sources, specifically ad and usage networks use their own convention for reporting data which sometimes use names and ids that aren't those of the parent app the data belongs to. In order for us to match data from those sources directly to apps we need to connect them directly. We use information from the data source to tell us which app the imported data belongs to. Some data sources do a great job at this (those units are mapped automatically), while others don't so we can't match them automatically (we don't like guessing). To get those units mapped we created a page that lists all available units (ad units, Google Analytics properties, etc.) where you can match them to their parent apps. Visit the Unit Mapping page → Mapping units to apps Your unit matching page contains three different lists: Unmatched, Matched, and Ignored. Each list can be filtered by source and also name of the ad unit or property for quick navigation. Matching is simple: Select the parent app for each unmatched unit from the list on the right. If you don't want a specific unit to be associated with any app (ex. test ad units, units for apps you're not tracking, etc.) simply select ignore. Once you select an app the match will be saved and data will be available in your reports reports right away. If you made a mistake, or want to make a change simply re-visit the page at any time and change the mapping.
-
Why am I receiving the message
While rare, this message means that the app store is currently unavailable. This is usually a temporary issue, but if it persists, please let us know.
-
Where can I find my legacy AdMob API password and key?
This FAQ only applies to old (legacy) AdMob accounts. API password Log into your AdMob account From the main menu select Account → Account Information Your API password will be at the bottom of the page. You may need to enable API access to your account if this is your initial setup. Creating an API key Log into your AdMob account From the main menu select Tool's → API Create new API key Type in a name you'll remember, and select 'Publisher' as the type. The new key will appear in the list immediately. Copy it and continue to link your account. _ Note: We highly recommend creating a separate key for each app or service that has access to your account._
-
Can I link my AdMob account if I have 2-step authentication?
Unfortunately not. The nature of 2-step authentication does not allow syncing with your account automatically. Instead, we recommend setting up a sub user with a strong password and using those credentials to link the account. You can find more details on enabling sub-user access to your AdMob account at https://support.google.com/admob/v2/answer/2784628?hl=en&ref_topic=2784623
-
Linking your InMobi account
Linking your InMobi account requires that the account have API access enabled. To enable access and get a secret key you'll need to contact InMobi directly. Once API access is enabled InMobi will provide you with the secret key for the account. Once you have the credentials ready follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API credentials collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your Chartboost account
To link your Chartboost account start by looking up your Chartboost API User ID and User Signature. Both are available inside the API explorer page of your account: https://dashboard.chartboost.com/tools/api. The top of the API Explorer page should have something like this: Once you have the credentials ready follow the steps below: Log into your Appfigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API credentials collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your Tapjoy account
First, locate your API key by following the steps below: Log into your Tapjoy account Click the Reporting tab Click the Reporting API link that's below the date picker. Your API key will be displayed at the top of the page The API key is a long string of letters and numbers Once you have the API key ready, follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API credentials collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your Vungle account
Linking your Vungle account requires getting an API key for your account. To get the necessary key you'll need to contact Vungle directly through the email account-managers@vungle.com. Once API access is enabled Vungle will provide you with the API key for the account. Once you have the credentials ready follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API credentials collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your AdColony account
To link your AdColony account start by looking up your AdColony API Key. The key is available at the bottom of the Account settings section of the publisher dashboard (https://clients.adcolony.com/users/edit). Once you have the credentials ready follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter your API key collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your RevMob account
The credentials required to link your RevMob account are the same credentials you use to log into the your account. Once you have the credentials ready follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter your credentials. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your Unity Ads account
To link your Unity Ads account start by looking up your API Key. Your API key is displayed in the API tab that's inside the Settings page of your Unity Ads account. Once you have your API Key handy, follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API Key collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your Supersonic account
To link your Supersonic account start by looking up your API User name and Secret key. Both are available inside your Account Details page. The page should have something like this: Once you have the credentials ready follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API credentials collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking your MdotM account
To link your MdotM account start by looking up your API Account ID and Secret key. Both are available inside your Profile page. The page should have something like this: Once you have the credentials ready follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API credentials collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Connecting to Adobe's Marketing Cloud
Adobe's Marketing Cloud is a powerful tool for business intelligence. Connecting your Appfigures account to the Adobe Marketing Cloud will push your app sales and downloads, ranks, ratings, and reviews (all metrics) automatically into your dashboards. To link up your Appfigures account you'll first have to set up one or more integration keys. Integration keys are how you link one or more apps to a reporting suite. A single integration key can be set up for one, some, or all apps in your account and be connected to one reporting suite. There is no limit on the number of integration keys you can make. Enable the add-on Head to Account settings > Add-ons > Adobe Marketing Cloud Click the Enable button at the top of the page. Enterprise Plan is required for this add-on. Contact us to learn more about the Enterprise plan or to upgrade your account. Create a key Click the Create key button. A popup with options will open. Select which apps this integration key will include: All apps in this account - select this option to include all existing apps as well as any new apps that you add to your account Some apps - select this option to set a specific set of apps. Once you select this option an app picker will appear and allow you to select the apps to include. Open the picker by clicking on the app and highlight all of the apps you want to included. When you've selected all of them, click the select button at the bottom of the list. Click Create to generate the key. Once the key is created it will be displayed. Copy the key by clicking the Copy button so it's ready for the next step. Head over to your Adobe Marketing Cloud account and follow these instructions to complete the integration. If you're stuck or need help getting set up don't hesitate to get in touch.
-
Can I link a Google Play account with 2-Step Authentication?
Yes. When linking a Google Play account you'll go through Google's standard 2-step authentication form. Once confirmed we'll be able to securely sync reports for your account. Note about account-specific passwords: appFigures connects to Google Play directly so an account-specific password isn't necessary. Important note: In most cases, your 2-step token will have no expiration. However, if your Google account is an administrator account, your link will only work for 30 days. This is a limitation forced by Google and means that every 30 days you'll have to login into your appFigures account and update your 2-step token, which isn't ideal and may lead to temporary data loss. We recommend that instead of linking your administrator account you create a sub user. That sub user may have 2-step authentication turned on, but because it isn't an administrator won't have the 30 day limitation.
-
Linking your iTunes Connect account
Linking your iTunes Connect account provides access to the following: Apps, including: iOS, Mac, and tvOS. iBooks Songs, videos, and TV shows and episodes For each we're tracking: App and IAP Sales (downloads and revenue) Financial reports and payments* iAd publisher performance and revenue (if enabled) * Financial and payment reports require the Finance role to be used. Read more → **Reviews, ranks, and other public data sets don't require an iTunes Connect account to be linked. Secure access We highly recommend setting up a separate sub-user inside of iTunes Connect for us to sync with instead of providing your own credentials. To create a sub user in iTunes Connect: Log into your iTunes Connect account > Users and Roles. Click the + button at the top of the page. Enter the name and email for the new user. You can use the following values: First Name: Appfigures Last Name: Sync Email: enter an email address you own that isn't currently assigned to any other existing sub user. Don't have a free email address, scroll down for other options. Click Next. We recommend selecting the "Finance" role, but support a few others. Click Next. Click Save. You're all done. In a few seconds you will receive an email from Apple with a link to create a password. When you have a password, proceed into your Appfigures account's Linked accounts screen and link the account using the email address and password from the previous steps. Important note about 2 Factor Authentication Due to the manual nature of 2FA it is not supported for automatic syncing. If you enabled 2FA for your iTunes Connect account you'll need to create a sub-account to enable syncing. Using one email address for two iTunes Connect sub users: If you don't have an extra email address to spare, we've found that you can use a period (.) in your email. Most email servers completely ignore it, but to Apple it's unique. . Example: if your email is john@apple.com, enter j.ohn@apple.com as your email.
-
Linking an account with 2FA enabled
2 Factor Authentication is a new feature from iTunes Connect that provides an extra layer of security for your account. When enabled however, 2FA will prevent us from syncing your account regularly and is not supported by the platform. The most secure way to link an iTunes Connect account is to set up a limited sub user with a strong password. Check out this article for more details.
-
Setting up a Sync+ account
Some organizations limit the sharing of private app store account credentials directly with 3rd parties. Because none of the major app stores support any other method of account linking, that presents a problem. Sync+ requires an Enterprise plan. Contact us to learn more. To comply with such situations we created the Sync+ system. With Sync+ turned on for your account you'll have a separate user account that is fully managed by us and plugs directly into your app store accounts instead of you having to plug those into your appFigures account. Using Sync+ When you enable Sync+ for your account you'll be given a unique Sync+ email id by your account manager. Use that and the steps below to attach your Sync+ id to all of your app stores account. Important: When you are done let your account manager know so they can verify and complete the setup on our end. iTunes Connect Log into your iTunes Connect account Click on "Users and Roles" from the main menu Click on the + button at the top of the list (next to the user count) Enter the following: First name: aF Last name: Sync+ Email: [Your Sync+ email address] Click on Next. Select the appropriate role. We recommend the Finance role but support a few others. Click Next. Make sure all notifications are turned off (the default). Click Save. Google Play Log into the Google Play Developer Console. Click on the Settings option in the menu on the left and then on "User accounts & rights". Click on Invite new user at the top of the page. Enter the following: Email: [Your Sync+ email address] Access expiry date: Never Role: Finance Click on Save invitation. Almost done! Once we've set up the link on our end you'll need to log back into your account and follow these steps to complete the linkage: Log into the Google Play Developer Console. Click on the Settings option in the menu on the left and then on "User accounts & rights". Click on the gear icon next to the Sync+ entry (it should be the first one in the user list). Click on Grant Access.
-
Linking a new data source
appFigures likes data! We support major app stores, ad networks, and in-app analytics services. Check out the integrations page for a complete list. To link your accounts: Head into Account setting → Linked Accounts. Click the Link an Account button. Give this linked account a nick name. This is the name we'll use internally to refer to this account. Select the source. Enter your credentials. Different sources have different requirements, so pay close attention to the labels. Click Save. Check out the Integrations section of the KB for store-specific instructions.
-
Reimporting Reports
Very infrequently it may be necessary to reimport reports for specific days. We only suggest doing this in cases where it's known that iTunes Connect had issued incorrect data. Apple only makes 1 year of daily data available in iTunes Connect, so this process will not work if the report in question is more than 1 year old and in fact may lead to missing data. Reimporting a report is a two-step process. First you remove the old report from the archive, then resync it. Removing a report from the archive Navigate to the archive and select the relevant Account and date. Then, download the archived report for safe keeping and afterwards delete it. Reimporting a report Now, head on over to the sync page. Select the Account in question and start a sync. In a few moments your data will be updated.
-
How can I link my Smaato account?
To link your Smaato account, you will need to generate a Client ID and Client Secret through the Smaato Dashboard. In to generate these credentials follow this link to your Smaato Account or when already in your Smaato dashboard hover/click on your email on the top right hand side corner and click OAuth API Credentials as shown below: Then click on the Create Client ID button. Once you have your Client ID and Client Secret handy, follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API Key collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
How can I link my ONE by Aol account?
To link your ONE by Aol: Mobile account, you will need to retrieve your Company ID, Company Access Key, and Secret Key. To access this menu, click on the hamburger menu as shown below: Then click Reporting Credentials: You can now access your Company ID and Company Access Key. If you have already received your Secret Key, then continue on. You can generate a new Secret Key by clicking the RESET SECRET KEY button. Once you have your Company ID and Secret Key handy, follow the steps below: Log into your appFigures account and navigate to the Linked Accounts tab inside your Account settings. Click Link an Account at the top of the page. Select a nickname for the account. This is a label you will use internally to identify the account and can be anything you'd like. Enter the API Key collected above. Save the new account. We will verify the credentials and then start syncing all available data from the account in the background. Most background syncs are completed in a few minutes but larger accounts may take up to an hour to complete the initial sync. Once linked the account will be synced several times every day to ensure data is always up to date.
-
Linking a Flurry Analytics account
To link your Flurry Analytics account securely you'll need to create what Flurry calls a "Programmatic User". Instructions →--> Here's how: Start by logging into the User Management section of your Flurry Analytics Account, then select "Programmatic User" There, provide an email address for the programmatic user, and you'll be given an Access Token. You'll need both of these to link your account. Find the account you just created in the user list in Flurry Analytics and set its access to "Viewer". Log into your Appfigures account and go into Account settings → Linked accounts. Click the "+ Link an Account" button, then select "Flurry Analytics" from the for the "Account" and enter the Programmatic User and Access Token you got earlier Click the "Add" button. Your Flurry Analytics account is now linked and is importing all available data automatically in the background. This usually takes a few minutes but in some cases may take up to an hour. We'll email you when the account is fully synced.