-
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.
-
How to link your App Store Connect (Previously iTunes Connect) account securely
Appfigures connects to your App Store Connect account directly to collect download and revenue reports for your apps and in-app purchases. [kb id="685" format="content"] We need your username and password to link your App Store Connect account because Apple does not provide any other way for us to connect with App Store Connect (such as OAuth) that provides access to the data and actions we need to provide you with all of our features. For your convenience, we support two ways of linking your App Store Connect account: Account credentials (with 2FA) - This is a secure way to link your account and be able to import data to feed all reports the platform offers, as well as reply to reviews. App-Specific Password - An App-Specific Password is a separate password you create that's dedicated for syncing and does not require 2FA. While robust, App-Specific Passwords offer limited access to data, so you will not be able to get usage, ad spend, or financial reports. You also won't be able to reply to reviews. If you already have a set of credentials for an App Store Connect account you go ahead and link your account by visiting Account settings → Linked Accounts → Link an Account. Otherwise, follow the instructions below. Creating a limited-access sub-account in App Store Connect Log into your App Store Connect account Click on Users and Access Click the + button at the top of the page Set the "First name" and "Last name" fields to your own name Set the "Email" field to an email that's different than the one you're currently using for your Apple account Select the following permissions from the list: Finance and Customer Support. Click on Invite. It will look something like this: After you send the invitation, Apple will send an email to the address you provided with instructions for setting up a password and activating the sub account. Follow the instructions and complete the setup. Tip: 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. Creating an App-Specific Password Log into your Apple ID management page (not App Store Connect) Find the "Security" section, and click on “Generate Password” under App Specific Password. Enter a label for this password. "Appfigures" works. Click on “Create” A popup will open showing your password. 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 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. If you run into any issues or need help setting up your sub account please contact us.
-
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. 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. 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 now reply to app reviews your users are leaving you through Google Play. To be able to reply to reviews you'll need to create an app key in your Google account. Follow the steps below to create a key securely. [kb id="685" format="content"] Get a key from Google: Only the owner of the Google Play account can configure API access Log into your Google Play Developer Console Click on Setup (in the left sidebar) → API Access. If at this point you see a message stating only an account owner can provision API access please stop and forward these instructions to the owner of your Google Play account. Hit the button "Choose a project to link" Click Link existing project. Select "Google Play Android Developer" and then "Link Project" at the bottom right. If a project has already been created, Google will automatically skip this step and you can then scroll down the page to "Service accounts" and click the "Create new service account" button. A popup window will open with instructions. Click the link to the Google Cloud Platform, which will open in a new tab. Click the Create Service Account link at the top of the page. Name your service account "Appfigures" and click Create. Select the Project → Owner role and click "Create". You must select the Owner role to be able to reply to reviews. Then, Continue. You'll see an option "Grant users access to this service account (optional)" skip this step and hit "Done". Next you'll see a list of all of your service accounts. Click into the service account you just created and select the "Keys" tab. Then, click Add Key > Create New Key and select the JSON key type, then click "Create" and save the file. Once you've saved the filed, hit "Done". Close the new popup window that opened and go back to the Google Play Console and dismiss the popup from step 4. The list will refresh to show your new Service Account. Then, click the Grant Access button next to the Service Account you just created. In the pop up, uncheck all of the permissions except for View app information and Reply to reviews to limit this account's access. Then, click Invite User. Add the key to your Appfigures account: Log into your account, and navigate to Account settings > Linked accounts Find the Google Play account you'll be adding the key to from the list and click the "Edit" option. In the popup that'll open, click the button to "Add Reply to Reviews key" Select the file you downloaded in step 7 above and click "Open". We'll automatically make sure the key is correct and add it to your account. That's it! You should now be able to reply to Android reviews directly. 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.
-
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.
-
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.
-
Linking your Unity Ads account
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. [kb id="685" format="content"] Start in the Operate tab of the Developer Dashboard, working under Settings > Organization Core ID. Next, through the same Operate tab go to API Access > API key. For Ad Spend reporting, you'll also need to locate your Organization ID through Acquire > Settings > Organization ID. Once you have the above 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. Enter the Organization Core ID, API key, and Organization ID collected above. Optional: 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. Save 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. .screenshot { border: 1px solid #d1d1d1; border-radius: 5px; }
-
How to Connect Your 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 Search 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 that's done, Appfigures will be able to import your Search Ads data.
-
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
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 Connecting Your Google Play Account Allow Appfigures access to your Google Play account by clicking the following link: http://accounts.google.com/DisplayUnlockCaptcha 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" Appfigures will now verify your information and connect your account. You may be asked to verify with Google during this process. Once connected, your data will begin populating in the next few minutes. Although your Google account may have access to non Google Play areas, Appfigures will only use the linked account to import sales data for your apps. 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. 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 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 Important: These permissions provide read-only access to reports, so we'll only be able to get reports and won't have the ability 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. 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. Google Workspace (formerly known as GSuite Setup) If you're a part of a GSuite account you'll need to make sure to whitelist the Appfigures app. 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"
-
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, 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. The Grow plan is required for this add-on. Contact us to learn more about the Grow 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.
-
How to link your Google Play account with 2-Step Authentication?
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.
-
How to link your App Store Connect account with 2FA
We've added support for Apple's two factor authentication so you can link your account more securely. When linking your account, you'll navigate through Apple's standard 2FA procedure. Once processed we'll be able to sync available reports for your account seamlessly. [kb id="685" format="content"] To link a new App Store Connect account: Log into your Appfigures account and navigate to the Linked Accounts page Click on “Link an Account” at the top of the page Select “App Store Connect” from the account selector Type in the email and password you use to log into your App Store Connect account Click on “Add” At this point we will request a 2-Factor Authentication code from Apple on your behalf, which will pop up on one of your registered devices. When you receive the code, enter it into the text box that will pop up. To update your linked App Store Connect account: Log into your Appfigures account and navigate to the Linked Accounts page Find the account you’d like to update and click on “Edit” Type in the email and password you use to log into your App Store Connect account, even if they haven't changed Click on “Update” At this point we will request a 2-Factor Authentication code from Apple on your behalf, which will pop up on one of your registered devices. When you receive the code, enter it into the text box that will pop up. Important: Appfigures is based in New York ,NY. When linking your account for the first time Apple may ask you to confirm access from New York. It'll look something like this ? This is normal and expected. If a sync from any other location is shown it may not be related to Appfigures. Contact us if you aren't sure about this.
-
Linking a Flurry Analytics account
To link your Flurry Analytics account securely you'll need to create what Flurry calls a "Programmatic User". Creating a Programmatic User: 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". Now follow the steps below to link the account: 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. Enter the Programmatic User Email and Access Token you set up in Flurry. Optional: 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. 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.
-
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 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. 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.
-
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 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.
-
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.
-
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.
-
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 Net Downloads vs All Net 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 Net 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.
-
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.
-
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.
-
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 the Explore plan. 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. 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. 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. 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. 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.
-
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.
-
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.
-
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. At , our goal Appfigures 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.
-
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 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.
-
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. Note: Apple only makes one year of daily data available in iTunes 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.
-
Linking your Appodeal account
To link your Appodeal account you'll need your API Key, which you can find by logging into your Appodeal account, then going to https://www.appodeal.com/profile/api_integration. Once you have the 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. Enter your User ID and API Key. Optional: 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. 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.
-
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 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.
-
Can I track my iBooks?
Yes!
-
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 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.
-
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.
-
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 credentials 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. Enter the API Key collected above. Optional: 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. 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 Leadbolt account
You can find your Leadbolt Publisher ID and Secret key on the Account Settings page in the Leadbolt Publisher Portal.
-
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.
-
Can I track Mac Apps?
Yes!
-
Linking an App Store Connect Account with 2-Factor Authentication (2FA)
2-Factor Authentication is a security feature offered in App Store Connect that provides an extra layer of security for your account. When you connect your account, we'll perform 2FA validation which will allow us to sync automatically for 30 days. Potential Errors Due to the nature of the 2FA process, if you start validation but don't complete it, the next validation won't be able to start up right away. This is done for security reasons. If you see a notification that 2FA verification is already running when trying to update a linked App Store Connect account it means that you'll need to wait a few minutes before you can start it again.
-
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.
-
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 AppLovin account
To link your AppLovin account start by looking up your AppLovin Reporter Key. To locate the 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: 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 Reporter Key collected above. Save the new account. We'll begin verifying the credentials and then start syncing, in the background, all available data from the account. Most background syncs are completed in a few minutes however, it's important to note larger accounts may take up to an hour or more 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 Fuse Powered account
You can find your Fuse Powered API Key here.
-
Linking your Heyzap account
You can find your HeyZap API Key here.
-
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.
-
How to Connect Appfigures to Google Sheets
At the moment there isn't a native connector for Google Sheets (yet), 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 that we wrote for you. Here's how you do that: Open your Google Sheet. A new one is best but not necessary. Open the script editor by navigating to Tools → 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 var key = '<YOUR PERSONAL ACCESS TOKEN>'; // The number of days to pull data for var days = 7; // The way data will be grouped. Separate multiple options with a comma. var grouping = 'date'; // Product IDs of apps to include, separated by a comma. Leave blank for all apps. var products = ''; // ---------- // function createMenu() { var ui = SpreadsheetApp.getUi(); ui.createMenu('Appfigures') .addItem('Get Sales','getSales') .addItem('Get Revenue','getRevenue') .addItem('Get Ratings','getRatings') .addItem('Get Subscriptions','getSubscriptions') .addToUi(); } function getSales() { getAppfiguresData('sales'); } function getRevenue() { getAppfiguresData('revenue'); } function getRatings() { getAppfiguresData('ratings'); } function getSubscriptions() { getAppfiguresData('subscriptions'); } function getAppfiguresData(dataset) { if(!dataset) dataset = 'sales'; var json = UrlFetchApp.fetch('http://api.appfigures.com/v2/reports/' + dataset + '?start_date=-' + days + '&group_by=' + grouping + '&format=flat&products=' + products + '&access_token=' + key); var data = JSON.parse(json.getContentText()); // figure out all the datasets we have in th eresponse var headers = Object.keys(data[0]); var gs = SpreadsheetApp.getActiveSpreadsheet(); var sheet = gs.getActiveSheet(); headers.forEach(function(header, h) { var name = titleCase(header.replace("_", " ")); sheet.getRange(1, h + 1).setValue(name).setFontWeight("bold"); }); data.forEach(function(item, i) { headers.forEach(function(header, h) { sheet.getRange(i + 2, h + 1).setValue(item[header]); }); }); } function titleCase(s) { s = s.toLowerCase().split(' '); for (var i = 0; i < s.length; i++) { s[i] = s[i].charAt(0).toUpperCase() + s[i].slice(1); } return s.join(' '); } 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. Save the project. Select the createMenu function form 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.
-
Connecting 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 Reviews Note: For the most secure access, we recommend setting up a separate sub-user inside of your Amazon Developer Account for Appfigures. [kb id="685" format="content"] Connecting Your Amazon Developer 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 Amazon Appstore from the list of providers Enter the email address and password for your Amazon 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 your Amazon Developer Account To create a sub-user: Log into your Amazon Developer Account Click on Settings > User Permissions 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: Marketer and Analyst. Click Save. Amazon 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. 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.
-
How to Connect Your Stripe Account Securely
Being able to track all of the revenue your mobile apps and games generate in one place is critical to your business' success. With the 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. Important: At this time the integration only works with Stripe's invoice billing. Creating a Restricted API Key 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" Connecting Your Stripe Account Log into your Appfigures Account Go to your Linked Accounts by clicking on Manage → "Linked account" Click on "Link an Account" Select Stripe from the list of providers Enter the email address and API Key you just created Click on "Add" Important: To import data from Stripe, you'll need to manually match your units via Account Settings > Unit Matching page.
-
Linking with Mintegral
To link your Mintegral Account start by looking up your Publisher SKey. [kb id="685" format="content"] Start by logging in and going to Account Info > Report > API Tools > Skey. From the same page you'll pull the Secret as well. For Ad Spend reporting, you'll also need to locate your API Key by logging into your advertiser's account > Account > User Management > API Key. Once you have the above keys, 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. Enter the Skey, Secret, and API key, collected above. Optional: 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. Save 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. .screenshot { border: 1px solid #d1d1d1; border-radius: 5px; }
-
Creating an App-Specific Password in App Store Connect
You can link your App Store Connect account with Appfigures, securely, using a feature of App Store Connect called App-Specific Passwords. Using this feature, you can create a separate password for your Apple ID that is very limited and can only be used by apps, like Appfigures. First, you'll need to create an App-Specific Password: Log into your Apple ID management page (not App Store Connect) Find the "Security" section and click on “Generate Password” under App Specific Password. Enter a label for this password. "Appfigures" works. Click on “Create” A popup will open showing your 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 to make sure it worked before closing the popup. Then, you can use this new password instead of your own password when linking your App Store Connect account. Two things you should know: The Good: App-Specific Passwords do not require 2FA tokens, so the linked account will not require a refresh every 30 days. The Less Good: App-Specific Passwords offer limited access to data. You will be able to view downloads and revenue reports, get subscription analytics, and financial and payment reports. However, you will not be able to usage or ad spend, and you will not be able to reply to reviews.