-
Linking Your App Store Connect (Previously iTunes Connect) Account Securely
Appfigures connects to your App Store Connect account directly and securely, and collects everything you need to track downloads and revenue for your apps, in-app purchases, and subscriptions. [kb id="685" format="content"] The easiest and most secure way to link your App Store Connect account is by creating an App-Specific Password. Once linked, you will be able to track: Downloads, uninstalls, updates, and other unit-based numbers. Revenue from app purchases, in-app purchases, and subscriptions, refunds, and more than 70 metrics on subscription performance. App usage Apple Search Ads campaign spend and performance Monthly payment reports from Apple Reviews and ratings* Hourly updated category ranks, including past data* When (and where) your apps are featured, including past data* App Store Optimization performance, including the keywords your apps are ranked in* And if you have enough permissions, you will also be able to reply to reviews. We support several different combinations of permissions. Details → Creating an app-specific password for App Store Connect Important: To enable an app-specific password with Apple you first need to have enabled 2FA within App Store Connect. Log into your Apple ID management page (not App Store Connect) Click into the “App Specific Passwords" section. Click on "Generate an app-specific password" in the popup that opened Enter "Appfigures" as the label for this app-specific password and click on "Create". Confirm your password when prompted. The next popup will have your app-specific password. This is the only time Apple will show you the password. Make sure to enter it into your Appfigures account and save/update the linked account to make sure it worked before closing the popup. Next: Head back into your Appfigures account and into Account settings → Linked Accounts to connect the App Store Connect account with the new credentials. Using Apple Ads? Continue to connect your Apple Ads account.
-
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 Play Console You'll need to have admin privileges to continue with this process. Start by logging into your Google Play Developer Console. Click on Users and permissions Select Invite new users Give the sub-user and email that isn't your main email but you have access to. Set Access expiry date to Never Next, set up the permissions for the account through Account permissions tab. Check the box under View app information and download bulk reports (read-only). Under the section for Financial access check the box for View financial data, orders, and cancellation survey responses. These permissions provide read-only access to reports without the ability to manage your apps or banking information. Click on Invite user This is what Account permissions will look like: 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. [kb id="685" format="content"] Once the account is ready head back into your Appfigures account and into Account settings → Linked Accounts → Link an Account. **If you need a secondary email address to create a sub account within Google, you can easily open a new gmail account to get started. Google documents the steps you can take to open a new gmail account here.
-
Connecting Your App Store Connect (Previously iTunes Connect) Account
Linking your App Store Connect (previously iTunes Connect) account provides access to the following: Apps, including: iOS, macOS, and tvOS. Stickers and iMessage apps iBooks Songs, videos, and TV shows and episodes For each we're tracking: App downloads and revenue In-App Purchase downloads and revenue Financial reports and payments Usage data Search Ads spend Hourly ranks Ratings Reviews Featured placements Note: For the most secure access, we recommend setting up a separate sub-user inside of App Store Connect for Appfigures. [kb id="685" format="content"] Connecting Your App Store Connect Account Log into your Appfigures Account Go to your Linked Accounts by clicking on your name (top right) and then on "Link Account" Click on "Link an Account" Select App Store Connect from the list of providers Enter the email address and password for your Apple account Click on "Add" Appfigures will now verify your information and link your account. Your data will begin populating in the next few minutes. Creating a sub user in App Store Connect To create a sub-user: Log into your App Store Connect Click on Users and Access Click the + button at the top of the page. Set the First Name and Last Name fields to to Appfigures and Analytics Set the email field to an email that isn't your main email but you have access to. Select the following permissions from the list: Finance and Customer Support. Click Invite. It should look something like this: We support several different combinations of permissions. Details → Apple will send an email to the address you provided. Follow the instructions in the email to complete the setup. Linking your subaccount with an app-specific password from Apple will be the most reliable. Once the app-specific password is created you will not have to refresh the connection (like you would with 2FA). -> Creating an App-Specific Password with Apple 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.
-
Replying To App Reviews With Google Play
Using Appfigures you can easily read, and reply to app reviews your users are leaving you through Google Play. To be able to reply to reviews you'll need to set up the linked developer account with the Reply to Reviews permission. Log into your Google Play Developer Console Go to Users & Permissions (on the left hand sidebar) Account Permissions > scroll down to User Feedback Check the box for Reply to Reviews. This Google account should also have access to View App Info and View Financial Info as well, for importing sales data. Replying in Appfigures You can reply to reviews directly through the platform, within the reviews report. We've outlined the steps on how to create and delete reviews -> Replying to App Reviews with Appfigures Limits Google imposes limits on the Reply To Reviews API. The limit that's most likely to be hit is the limit for GET requests, which is 60/hour. Each response ends up using two GET requests under the scenes, which means that you will only be able to reply to 30 reviews an hour. If you exceed these limits you'll get notified by Appfigures and will need to wait an hour until the quota resets.
-
Linking a new data source
We support a variety of 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.
-
Connecting Your Google Play Account
Appfigures connects to your Google Play developer account directly and securely, and collects everything to track downloads and revenue for your apps, in-app purchases, subscriptions, and more. Linking your Google Play account will enable you to track the following with Appfigures: App downloads and revenue In-App Purchase downloads and revenue Subscriptions revenue, MRR, Churn, and more Hourly ranks Ratings Reviews Featured placements [kb id="685" format="content"] Connecting Your Google Play Account Log in to your Appfigures Account Click on your avatar (top right) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Google Play from the list of providers Enter the email address and password for your Google account Click on "Add" Important: Once added in Appfigures, you must go back into your Google account and follow these steps: Go into the 'Recent security activity' tab of your Google account: Notifications Check if you have received 'New sign-in' from 'New York, USA` alerts from Google. If yes, open the alert and reassure Google by answering "Yes, it was me". Go back to the Appfigures Linked Accounts page and re-enter the credentials for your Google account. Appfigures will now verify your information and connect your account. You may be asked to verify with Google during this process. To restrict access to only sales data, we recommend creating a separate Google account with limited permissions and using it instead of your main Google account. When creating a new subaccount, Google will take about 24 to 48 hours to fully process the new account + permissions. Downloadable reports will be available once that's completed on Google's end, and importing sales reports will begin once those are detected. This is completely optional, but if you'd like to do it, this is how: Creating a sub user in the Play Console You'll need to have admin privileges with Google to continue with this process. Start by logging into your Google Play Developer Console. Click on Users and permissions Select Invite new users Give the sub-user an email that isn't your main email, but you have access to. Set Access expiry date to Never Next, give the new user permissions through the Account permissions tab: App Access → View app information and download bulk reports (read-only) Financial access → View financial data, orders, and cancellation survey responses User Feedback → Reply to reviews Important: These permissions provide read-only access to reports, so we'll only be able to get reports and won't have the ability to manage your apps or banking information. Click on Invite user Check your email. Google will send an email to the address you provided. Follow the instructions in the email to complete the setup. Head back into your Appfigures account to complete the steps from "Connect Your Google Play account". Go to your profile → Linked Accounts to connect the Google Play account with the new credentials. 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. Linking with Google Workspace (formerly known as GSuite Setup) If you're a part of a Workspace account, you'll need to make sure to whitelist the Appfigures app. Workspace has a standard default period of 14 days. This means, unless you increase the verification window with Google, you will need to re-verify the account every two weeks. You can do that by following these steps: Go to https://admin.google.com/ac/owl/list?tab=apps Click on "Configure new app" -> "OAuth App Name or Client ID" Search for "Appfigures" and select it Select all the OAuth Client IDs presented Select the "Trusted: Can access all Google services" option Click "Configure" Permission checks to run within Google Workspace: Allow Workspace users to access Google Cloud Platform Go to Apps → Additional Google Services Make sure that Google Cloud Platform and Google Play Console are ON for everyone or the accounts you would like to link to Appfigures. With Workspace, you should ensure that Reauthentication is set to allow trusted apps: Google's documentation Go to Security → Google Cloud Session Control If Require reauthentication is set, also set Exempt Trusted apps if Never require reauthentication is set no changes are required. Noteworthy SSO Systems Supported When Connecting to Google's Developer Account Okta OneLogin Entra ID (Azure) JumpCloud While these four systems are supported fully, any other SSO system should work out of the box as well.
-
What role should I assign my sub user in App Store Connect (previously iTunes Connect)?
App Store Connect offers granular roles so sub-accounts don't have more access than they need to. Appfigures supports several options, and here's what you need to get the proper access: To get downloads & revenue data you'll need the Finance role. This is the recommended role, and provides access to all reports and data granularities. Alternatively, you can provide a more limited sub-account that will only have access to downloads and revenue, but not financial reports or payment information by selecting both Sales and Reports roles. For replying to reviews add the Customer Support role. Apple may take about 24 hours to reflect role changes, so if you made a change and can't see the feature you need immediately give it a little bit and try again. Will look something like this:
-
What is the store status report?
App Store Connect (previously iTunes Connect) and Google Play release new reports every day. 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 for the availability of new reports. Related Articles: Why Haven't I Received My Email Report Yet Today
-
Linking your Unity Ads account
Connecting your AppLovin account to Appfigures enables tracking ad revenue and ad spend from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your Unity Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Unity from the list of providers Enter the email address and password for your Unity account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Creating Your Unity API Key for Ad Revenue To link your Unity Ads account, start by looking up your API Key. You can find your key inside your Developer dashboard of your Unity Ads account. Start in the Monetization suite of the Developer Dashboard, working under Organization Settings > Organization Core ID. Next, through the same Monetization suite, go to API Management > Monetization Stats API Access. Once the IDs have been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. Connecting Unity Ad Spend For Ad Spend reporting, you can create a service account and then pull the two keys. To pull the keys: In the Unity Cloud, go to Administration > Service Accounts. Select Create service account to create a new account. In the Keys section, select Create key to generate a key ID and a secret key. Add a role to your service account to allow access to API endpoints. Select Add organization role to grant access to organization-level data that applies to all projects in your organization. Required organization roles: Advertise API Viewer Advertise Stats API Viewer Mediation Reporting API Viewer Once the IDs have been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. Noteworthy Ad revenue and ad spend data from Unity is available starting January 1st, 2014. Data will be available in Appfigures from the start date no matter when the account is added for tracking. .screenshot { border: 1px solid #d1d1d1; border-radius: 5px; }
-
How to Connect Your Apple Ads (formerly Apple Search Ads) Account to Appfigures
In order to track your ad spend metrics from Apple Search Ads, Appfigures will need to have access to your Search Ads account. To enable access to Search Ads, you'll need to link your App Store Connect sub user to your Apple Search Ads accounts. Luckily, Apple made that very easy, and with read-only access, secure. [kb id="685" format="content"] Start by logging into your Apple Ads account. Select your Basic or Advanced account. If you use both select Advanced. You only need to do this once and both will work. Click on your name at the top of the page, and then on Settings next to your company name. Navigate into the User Management tab. Click the Invite Users button, and enter the email of the App Store Connect account that's linked to your Appfigures account. For role, select Account Read Only. Send the invitation, then check your email to accept the invitation. After accepting the invitation, enter the code Apple provided in the invitation email to complete the signup process. Important: Make sure you enter the code after clicking the link in the invitation email. Otherwise we will not be able to sync any data. Once done your Apple Search Ads accounts will be synced with your Appfigures account automatically every day. If you'd rather not wait you can run a manual sync by going into Linked Accounts > Sync, selecting the newly linked account, unchecking all data sets except for Search Ads, and clicking the Sync button.
-
Creating an App-Specific Password with Apple
Appfigures connects to your App Store Connect account directly and securely to collect everything you need to track downloads and revenue for your apps, in-app purchases, and subscriptions. [kb id="685" format="content"] The easiest and most secure way to link your App Store Connect account is by creating an App-Specific Password. Once linked, you will be able to track: Downloads, uninstalls, updates, and other unit-based numbers. Revenue from app purchases, in-app purchases, and subscriptions, refunds, and more than 70 metrics on subscription performance. App usage Apple Search Ads campaign spend and performance Monthly payment reports from Apple Reviews and ratings* Hourly updated category ranks, including past data* When (and where) your apps are featured, including past data* App Store Optimization performance, including the keywords your apps are ranked in* Reply to reviews (with the Customer Support role from Apple) An App-Specific Password is a separate password you create that's dedicated for syncing and does not require 2FA. Creating an app-specific password for App Store Connect Important: To enable an app-specific password with Apple you first need to have enabled 2FA within App Store Connect. Log into your Apple ID management page (not App Store Connect) Click into the “App Specific Passwords" section. Click on "Generate an app-specific password" in the popup that opened Enter "Appfigures" as the label for this app-specific password and click on "Create". Confirm your password when prompted. The next popup will have your app-specific password. Important: This is the only time Apple will show you the password and there's no way to get it back, so make sure to enter it into your Appfigures account and save/update the linked account to make sure it worked before closing the popup. Next: Head back into your Appfigures account and into Account settings → Linked Accounts to connect the App Store Connect account with the new credentials.
-
Tracking Downloads & Revenue for Steam Games with Appfigures
Appfigures provides the resources to easily track important app data from multiple app stores, including Steam! Knowing how Steam works is key to understanding how data will appear in reports. What We're Tracking: Purchases and revenue for packages Downloads for titles, DLCs and in-game purchases Reviews How Products Are Reported: Packages - This will include a combination of app + in-app. In Appfigures, they will appear as a bundle. Titles - Appear in reports as an app. In-Game Purchases - In reports, these products are reported as an app + IAP. DLCs - Can be reported two ways, either as an app + IAP when belonging to a Title or as a package when sold individually. Note: In Steam, apps/IAPs can't be purchased directly but rather through a package which means apps/IAPs do not have revenue of their own, just downloads. How Downloads are Reported To provide the most actionable data, downloads for packages are reported when a title is downloaded and play time is recorded. This is done by Steam, so it's accurate. Under the hood, downloads are derived from the “Downloads by Region” report that's available in your Steam developer account. Note: DLCs, titles, and in-app purchases are still derived from the "retail activations" metric in Steams reports, which counts all downloads regardless of usage. That's a limitation of Steam's reporting. To start tracking simply link your Steam developer account. Connecting Your Steam Account Securely We highly recommend setting up a separate group + user inside of Steam to sync with instead of providing your own credentials. To create a group + user in Steam, login to your Steamworks account. FYI - You'll need to have admin privileges to continue with this process. Go to Users & Permissions > Manage Users. Click on Add User. Set the role to view financial info. This role provides read-only access to reports. Since Steam has support for groups + users, both the group and the user need this permission enabled. Once the user has been created, head back into your Appfigures account and into Account settings → Linked Accounts → Link an Account.
-
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.
-
Linking your Tapjoy account
First, locate your API key by following the steps below: Log into your Tapjoy account Click Settings Next, click App Settings in the dropdown. 4.Lastly, click API Keys > Ad Reporting API Keys. 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.
-
Support for Google's Offline One Time Password
Google supports various methods of verification, some more of an operation than others. One of those intricate methods is Google's Offline One Time Password, which Appfigures supports. Detailed below are the steps you can follow to link and verify your Google Play account. Connecting Your Google Play Account Log into your Appfigures Account Go to your Linked Accounts by clicking on your name (top right) and then on "Link Account" Click on "Link an Account" Select Google Play from the list of providers Enter the email address and password for your Google account Click on "Add" Next, you can follow the below steps: .screenshot { max-width: 350px; border: 1px solid #dedede; border-radius: 3px; } Log into your Google app and click on your icon in the top right corner. Click on "Manage Your Google Account". Go to your Security tab. Open the section for "Security Code". Lastly, add the security code from step 4 into the prompt in Appfigures. You're all set! Now that the account is linked and verified we'll begin to sync + import apps and reports.
-
Linking Your Chartboost Account
One of the (many) benefits of Appfigures is having access to all of the data you need to make more informed decisions in a single place. Connecting your Chartboost account to Appfigures enables tracking ad revenue from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your Chartboost Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Chartboost from the list of providers Enter the User ID and User Signature for your Chartboost account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Connecting 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: Explorer page. The top of the API Explorer page should have something like this: Once the user has been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. 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.
-
Apple's Limited Retention Policy With Sales Reports
App Store Connect has a limited retention policy when it comes to sales reports. While Apple's retention policy originally started off with seven days of daily reports, that's now grown to the last 365 days of daily reports. Apple's current retention policy: Daily - last 365 days Weekly - 52 weeks Monthly - last 12 months Yearly - all time 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, even when the raw reports are no longer available in your App Store Connect account. How does this impact App Downloads vs All App Downloads? Depending on when your app was released, and when you initially link your App Store Connect account, this limited retention policy can cause a difference between Net Downloads and All Net Downloads. When looking at Net Downloads this number is specifically based off the imported reports for the selected granularity and date range. Selecting the daily granularity for 2022 would provide the Net Downloads number directly form the daily reports from Jan. 1st, 2022 to today. All App Downloads take into account all granularities (daily/weekly/monthly/yearly) to provide an accurate all time total. If your app was available prior to the daily report start date, the downloads will still be included based on the yearly reports. For example, you released your app on November 1st, 2020 and you link your App Store Connect account for the first time on January 1st, 2022. Daily, weekly, and monthly reports will be available from Apple back to January 2021. Data from November 2020 to December 2020 would not be within Apple's retention policy so daily/weekly/monthly reports would stop in 2021. The yearly report however would be available for 2020. The All Net Downloads total would reflect data back to 2020 because it's taking into account the yearly report from 2020 as well as the more granular reports from 2021.
-
Setting up a Sync+ Account for a Managed Integration
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. 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 Appfigures and plugs directly into your store accounts instead of you having to plug those into your Appfigures account. Note: Managed integrations and Sync+ accounts requires an Enterprise plan. Setting up a Managed Integration with 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. When you are done, let your account manager know so they can verify and complete the setup on our end. App Store Connect Log into your App Store 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: Appfigures 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 Permissions: Account Permissions with View App Info and View Financial Info selected. Click on Save invitation. Amazon Log into your Amazon Developer Account Click on Settings > User Permissions Click the Add New. Enter the following: Set the First Name and Last Name fields to to Appfigures and Sync+ Set email: [Your Sync+ email address] Select the following permissions from the list: Marketer and Analyst. Click Save. Windows Log into your Windows Developer Account Click on Account Settings > User Permissions (of Partner Center) Click the Add New. Enter the following: Set the First Name and Last Name fields to to Appfigures and Sync+ Set email: [Your Sync+ email address] Select the following permissions from the list: Finance Contributor. Click Save. Once you've added any of the above sync+ accounts, reach out to the Support Team with the heads up and we can complete the remaining set up on our end.
-
My reports are missing data, why is this?
This tends to happen when Auto Import is no longer active for one or more of your linked accounts. Automatic importing will fail when the saved credentials of the linked account no longer work. Read more about updating credentials
-
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.
-
Why isn't my data being automatically imported?
When you link an account we start syncing it automatically. Sometimes, the credentials you use to log in change and we're unable to sync your account causing gaps in your reports. When that happens, we'll email you so you can log into your account and update the credentials which will resume syncing and fill in any gaps we can. Any user with the Admin role can enable auto import by visiting Account Settings → Linked Accounts and checking the Auto Import checkbox. Note: If you're on the free plan, auto import requires that the Data Pool option is checked in your Profile If you are still having issues, Get in Touch.
-
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.
-
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, ad networks, and in-app analytics services you connect. This makes setup a breeze, and means you can start seeing data right away. To start tracking your downloads and revenue simply link your app store account(s) by visiting Account Settings → Linked accounts → Link an account.
-
Why is Appfigures revenue 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. Our goal at Appfigures is to create a platform that’s useful. And 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.
-
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.
-
Can I link multiple app store accounts to my Appfigures account?
Absolutely! To link an external store account select Manage (bottom left 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).
-
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.
-
Linking your Appodeal account
Connecting your Appodeal account to Appfigures enables tracking ad revenue from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your Appodeal Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Appodeal from the list of providers Enter the User ID and API Key for your Appodeal account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Locating Your Appodeal API Key To link your Appodeal account, you'll need your API Key Log in to your Appodeal account Go to the [integration page]((https://www.appodeal.com/profile/api_integration) and grab your key. Once you have the ID, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account.
-
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.
-
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 App Store Connect had issued incorrect data. Note: Apple only makes one year of daily data available in App Store Connect, so this process will not work if the report in question is more than a year old and will result in missing data. Reimporting a report is a two-step process. First you remove the old report from the Archive, then re-sync it. 1. Remove the report from the Archive Navigate to the Archive Select the relevant account and date. Select the individual report by clicking the checkbox to its left Optional: Download a copy of the report for safe keeping Delete the report by clicking the "Delete" button at the top of the list 2. Re-import the updated report Now, head on over to the sync page. Select the account in question and click the "Sync" button to start the syncing process. In a few minutes your data will be updated and available in your reports.
-
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.
-
Connecting Your Smaato Account
Connecting your Smaato account to Appfigures enables tracking ad revenue from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your Smaato Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Smaato from the list of providers Enter the email address and password for your Smaato account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Locating Your Client ID and Client Secret To link your Smaato account, you will need to generate a Client ID and Client Secret through the Smaato Dashboard. Log in to your Smaato Dashboard 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. Grab your Client key ID and Client Key Once the IDs have been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the 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.
-
Can I track my iBooks?
Yes!
-
Linking your Leadbolt account
You can find your Leadbolt Publisher ID and Secret key on the Account Settings page in the Leadbolt Publisher Portal.
-
Linking your AppLovin account
One of the (many) benefits of Appfigures is having access to all of the data you need to make more informed decisions in a single place. Connecting your AppLovin account to Appfigures enables tracking ad revenue and ad spend from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your AppLovin Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select AppLovin from the list of providers Enter the email address and reporter key for your AppLovin account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. The account will be synced several times every day to ensure data is always up to date. How to find your AppLovin Reporter Key. Once logged into your AppLovin account, click the Account tab on the left-hand side. Under "General" click "Keys". Once you have the Reporter Key, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. Noteworthy: When an AppLovin account is linked for the first time to Appfigures, the last 45 days of data are available for importing - a limitation from AppLovin.
-
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.
-
Can I track Mac Apps?
Yes!
-
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.
-
I migrated from a personal account to a business account in my App Store Connect account, 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.
-
Linking your Fuse Powered account
You can find your Fuse Powered API Key here.
-
Linking your Amazon Developer Account
Linking your Amazon account will enable you to track the following with Appfigures: App downloads and revenue In-App Purchase downloads and revenue Subscriptions revenue, MRR, Churn, and more Hourly ranks [kb id="685" format="content"] Connecting Your Amazon Developer Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Amazon from the list of providers Enter the Client ID and Client Secret for your Amazon account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Locating your Amazon Client ID and Client Secret Important: An Amazon Admin needs to create the keys for individual sub-user account. Each sub-account needs it's own linked account within Appfigures. Create a Security Profile Login to your Amazon Developer Account console. You will be prompted to create an account if you do not already have one. In the main navigation, click Apps & Services. Click API Access in the sub-menu. Click the API name of the API. Click the Create a new security profile button. Enter a Security Profile Name and Security Profile Description for your new profile, then click Save. Save your Client ID and Client Secret (from the Web Settings tab), as you will need this information to access the Sales Reporting API. Map the Security Profile to the API Return to the API Access page. Click the API name to select the API. Select your new security profile from the drop-down list. Select Attach to associate the security profile with this API. The API name and attached security profile is added to the Security Profile(s) in use panel. Once you have the IDs, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. Noteworthy When linking an Amazon developer account for the first time, we're able to import the last three years of sales data.
-
How to Connect Appfigures to Google Sheets
At the moment, there's no native connector to get data from Appfigures into Google Sheets, but that doesn't mean you can't connect the two! You'll be able to do that with Google's Script Engine and a custom script. Here's how to do that: Open your Google Sheet. A new one is best but not necessary. Open the script editor by navigating to Extensions → Apps Script Give the script a name in the left menu by clicking three dots of Code.gs then rename. AF API is a good default. Copy the following script, as-is, into the editor Set your access token. Click here to learn how to generate it Customize (optional): Days - The number of days you want pulled every time you load data. The default is 7. Grouping - How the data will be broken down. Options include date, country, storefront, and product. Multiple options can be specified, separated by a comma. By default, data will be grouped by date. Products - The Product Ids of the apps you want to pull data for. By default (blank) all apps will be included. Mode - How to introduce new data into the sheet. Options: append, overwrite. Save the project. Select the createMenu function from the top dropdown and hit "Run" to set things up. This one's important. Head back to your Google Sheet and you'll see a new Appfigures option in your menu. All you have to do now is select the data you want to bring into your Google Sheet and vóila! Tinkering further This is a pretty simple and generic way to pull data from the Appfigures API into Google Sheets. It can be further customized and other data sets can be added to it as well beyond the ones available in this script. Check out the API docs to see what the API can do.
-
How to Connect Your Stripe Account to Appfigures Securely
Being able to track all of the revenue your mobile apps and games generate in one place is critical to your business' success. Appfigures' Unified Dashboard automates that for you, regardless of how or where you accept payments. With Appfigures' Stripe integration you can track revenue generated outside of in-app purchases and Apple's and Google's subscription system, right along side everything else. Tracking revenue collected through Stripe is secure and only takes a few steps to set up: [kb id="685" format="content"] Connect Your Stripe Account to Appfigures Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Stripe from the list of providers Enter the email address and API key for your Stripe account Click on "Add" Create a Restricted API Key To restrict access to only sales data, we recommend creating a restricted key with limited permissions for linking. Log into your Stripe account Click on "Developers" (top right) Click on "API keys" from the menu on the left Click "Create restricted key" Name the key "Appfigures" (for the sake of simplicity) Set the following permissions to Read Core Resources: Balance Balance transaction sources Charges Products Billing Resources: Invoices Plans / Prices (some Stripe dashboards may show "Plans" while others see "Prices") Subscriptions All reporting resources Report Runs and Report Types Click on "Create key" Once the key has been created, head back into your Appfigures account and into your Profile → Linked Accounts → Link an Account. Assign Items from Stripe To Apps After the initial sync is complete, you'll be able to attach items from your Stripe account to apps and games in your Appfigures account for accurate reports. Head into the Unit Matching page Select the relevant app for each item Your reports will update automatically. Noteworthy The integration supports invoice billing but not one time payments. We don't collect subscription information, just revenue. We'd love to hear your feedback and suggestions for enhancing the integration. Talk to us
-
Linking Your Mintegral Account
Connecting your Mintegral account to Appfigures enables tracking ad revenue from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your Minetgral Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Mintegral from the list of providers Enter the Publisher SKey and Pubslisher Secret Key for your Mintegral account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Locating your Mintegral Publisher Skey and Secret Key To link your Mintegral Account, start by looking up your Publisher SKey. Start by logging in and going to Account Info > Report > API Tools > Skey. From the same page, you'll pull the Publisher Secret Key as well. Once the user has been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. Noteworthy When linking, you will see optional spaces for Advitiser Access Key and Advitiser API Key. These keys are optional, as they will be for importing ad spend data from the network. Data is not importing for the network yet however, when a beta is available in the future, we'd import data automatically if added ahead of time. These two keys are not required for syncing Mintegral ad revenue. .screenshot { border: 1px solid #d1d1d1; border-radius: 5px; }
-
Connecting Appfigures and Adobe Experience Cloud for App Analytics
The Adobe Experience Cloud is a powerful platform for business intelligence. Appfigures integrates with the Adobe Experience Cloud to bring a wealth of information from your mobile apps, including downloads, revenue, ratings, and much more for rich dashboards. Important: This integration is available on the Amplify and Explore plans. Connecting Appfigures and Adobe requires that you first create a Developer Project Adobe Analytics, connect it to your Appfigures accounts, and then choose which apps to collect data from. 1. Create an Adobe Analytics Developer Project Head into your Adobe Project Dashboard. You'll need to be an admin to do this. Click Create new project. Click Edit project and change the default project name to Appfigures Analytics. If you plan on creating multiple projects for different apps make sure to add that to the name so each project is unique. Click Add to Project and then API. Select Adobe Analytics and then Next. Select OAuth Server-to-Server and name it Appfigures OAuth. Select the Adobe Analytics product profile you would like to see your Appfigures data within and then Save configured API. Click the newly created OAuth credentials in the project Credentials section. Copy the Client Id and Client Secret. You'll need both to connect. 2. Link the Adobe Analytics Developer Project to Appfigures Head into the Linked Accounts section of your Appfigures account. You'll need to be an admin to do this. Click Link an Account and select Adobe Analytics from the dropdown. Add the Client Id and Client Secret obtained in step #8 above. Give the integration a descriptive name pertaining to the Adobe profile that was used to create the Adobe project. Your Appfigures is now connected to your Adobe accounts and can start bringing data from your apps. 3. Assign Apps to a Project Once your account is connected, our enterprise team will help you assign apps to projects so you can view data in your dashboards. While not a requirement, you can set up separate projects for different apps. If you plan on doing that please follow these instructions for every project before reaching out to our enterprise team.
-
Linking Your Windows Developer Account
Linking your Windows account will enable you to track the following with Appfigures: App downloads and revenue IAP purchases and revenue Reviews [kb id="685" format="content"] Connecting Your Windows Developer Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Windows from the list of providers Enter the email address and password for your Windows account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Creating a sub user in your Windows Developer Account For the most secure access, we recommend setting up a separate sub-user inside of your Windows Developer Account for Appfigures. Log in to your Windows Developer Account Click on Account Settings > User Permissions (of Partner Center) Click the Add New. Set the First Name and Last Name fields to to Appfigures and Analytics Set the email field to an email that isn't your main email but you have access to. Select the following permissions from the list: Finance Contributor. Click Save. Windows will send an email to the address you provided. Follow the instructions in the email to complete the setup. Once the user has been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account.
-
How to Connect Your Pangle Account to Appfigures
Connecting your Pangle account to Appfigures enables tracking ad revenue from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your Pangle Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select Pangle from the list of providers Enter the Role ID, Security key, and User ID for your Pangle account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. How to locate your Pagnle IDs You can find your IDs inside your Pangle dashboard. To locate the needed IDs: Find Integrations in the menu on the left-hand side. From there, SDK & API → Pangle Reporting API 2.0 Grab your Security ID, Role ID, and User ID Once you have the IDs, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the account. Noteworthy Data from Pangle's API starts in December 2022, no matter when the account is linked.
-
Adobe Experience Cloud Integration
The Adobe Experience Cloud is a powerful platform for business intelligence. Appfigures integrates with the Adobe Experience Cloud to bring a wealth of information from your mobile apps, including downloads, revenue, ratings, and much more for rich dashboards. Here's a list of all metrics and classifications supported by the integration. Important: This integration is available on the Amplify and Explore plans. Datasets Units Downloads - The number of times the app was downloaded for the first time to a user's device. In-app Purchases - The number of in-app purchases made. Subscription Purchases - The number of new subscriptions purchased. Redownloads - The number of times the app was downloaded by an existing user who deleted the app before. Uninstalls - The number of times the app was deleted. In-app Returns - The number of times a refund for an a non-recurring in-app purchase was issued. Subscription Returns - The number of times a refund for a recurring in-app purchase was issued. Revenue In-app Revenue - The amount of revenue from non-recurring in-app purchases after store fees. Subscription Revenue - The amount of revenue from recurring in-app purchases after store fees. In-app Gross Revenue - The amount of revenue from non-recurring in-app purchases before store fees. Subscription Gross Revenue - The amount of revenue from recurring in-app purchases before store fees. In-app Refunds - The amount of money refunded from non-recurring in-app purchases after store fees. Subscription Refunds - The amount of money refunded from recurring in-app purchases after store fees. In-app Gross Refunds - The amount of money refunded from non-recurring in-app purchases before store fees. Subscription Gross Refunds - The amount of money refunded from recurring in-app purchases before store fees. Subscriptions MRR - Monthly Recurring Revenue Churn - % of users that unsubscribed Active Subscriptions - The number of subscriptions, including free trials and promotional offers. Paying Subscriptions - The number of subscriptions earning revenue (not including trials). Only available for iOS and MacOS apps at this time Activations - Number of times a new subscription was purchased. Includes new subscription purchases and upgrades to a higher tier. Cancellations - The number of times a subscription was cancelled. Included subscriptions that expired, cancelled or downgraded to a lower tier. Ranks Rank - Used to define the Average Appfigures Calculated Metric. Not used directly. Rank Divisor - Used to define the Average Appfigures Calculated Metric. Not used directly. Ratings Rating - The rating and associated text review. Rating Divisor - Used to define the Average Appfigures Calculated Metric. Not used directly. Classifications Data series Country Name - The name of the country related to the app store activity. Appstore Name - The name of the app store that reported the activity (Ex. Apple, Google Play, etc.). Application Name - The name of the mobile application. In-app Name - The item purchased within the application. Category Name - Primary category of the app in the app store. Reviews Review Title - Title of the review. Review Comment - Comment of the review Application Version - Version of the application that was used to generate the review. App Store User - Author (user name) of the review. Update Frequency The integration supports daily data updates for all included metrics. Ready to start? Here's how to connect Appfigures with Adobe.
-
Linking ironSource Ads
Connecting your ironSoruce account to Appfigures enables tracking ad revenue and ad spend from the network alongside all of your other revenue streams. [kb id="685" format="content"] Connecting Your ironSource Account Log in to your Appfigures Account Click on your avatar (top right corner) and then on "My profile" Go to Linked Accounts Click on "Link an Account" Select ironSource from the list of providers Enter the Secret Key and Refresh Token for your ironSource account Click on "Add" Appfigures will now verify your information and connect your account. The initial sync may take some time, depending on how much historical data is available. Locating Your Secret Key and Refresh Token First, log in to your ironSource account. Click on your profile picture or username in the top right corner. Select "Account" or "My Account" from the dropdown menu. Navigate to the "API" tab Grab your Secret Key and your Refresh Token. Important: If linking with a Contributor role, the permissions must include 'Add and Edit Apps'. If linking with the Administrator role, those permissions will be automatically included. Once the user has been created, head back into your Appfigures account and into My Profile → Linked Accounts → Link an Account to connect the 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.