Appfigures: Most-used fields

The table below gives information about most-used fields that you can import from Appfigures. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
activations	activations	The total number of subscriptions activated during the selected period, encompassing new subscriptions, reactivations, trial conversions, and plan changes.	metric
active	active	Status indicating if the product or source is currently active within the Appfigures platform.	metric
active_discounted_subscriptions	active_discounted_subscriptions	The total number of currently active subscriptions that are being paid at a discounted price.	metric
active_free_trials	active_free_trials	The total number of subscriptions that are currently in their free trial period.	metric
active_subscriptions	active_subscriptions	The total number of active subscriptions where subscribers are paying the standard, non-discounted price.	metric
active_trials	active_trials	The total number of active subscriptions currently in a trial phase, which can include both free and discounted trials.	metric
actual_revenue	actual_revenue	The actual revenue earned after the app store’s fees have been deducted, calculated as total sales, in-app purchases, ads, and educational revenue minus returns.	metric
added_date	added_date	The date when an item, such as a product or review, was added or first recorded.	dimension
all_active_subscriptions	all_active_subscriptions	The comprehensive count of all active subscriptions, including free trials, discounted trials, discounted pay-upfront, pay-as-you-go, and standard price subscriptions.	metric
all_subscribers	all_subscribers	The total number of active subscriptions, including free and discounted trials, discounted pay upfront and pay-as-you-go subscriptions, and standard subscriptions.	metric
app_downloads	app_downloads	The number of downloads for the app, excluding in-app purchases.	metric
app_returns	app_returns	The total number of returns for apps, excluding in-app purchases.	metric
app_returns_amount	app_returns_amount	The amount of money refunded to customers from app sales, after the store’s fee, excluding in-app purchases.	metric
app_revenue	app_revenue	The total revenue from app sales, after the store’s fee, excluding in-app purchases.	metric
app_store_views	app_store_views	The number of times the app’s product page was viewed in the app store.	metric
author	author	The name of the user who submitted the review.	dimension
average_rating	average_rating	The weighted average rating of an app based on all ratings received.	metric
avg_daily_active_devices	avg_daily_active_devices	The average number of unique devices that actively used the app on a daily basis.	metric
avg_optin_rate	avg_optin_rate	The average rate at which users opt-in for certain features or data collection.	metric
bundle_identifier	bundle_identifier	The unique bundle identifier for an application, commonly used for iOS apps.	dimension
business_downloads	business_downloads	The number of downloads received through Apple’s Volume Purchase for Business program.	metric
business_revenue	business_revenue	The revenue from downloads generated through Apple’s Volume Purchase for Business program, after the store’s fee.	metric
cancellations	cancellations	The aggregate number of subscriptions that were not renewed directly by the customer, or as a result of moving to a different tier or plan.	metric
cancelled_subscriptions	cancelled_subscriptions	The number of subscriptions that have been cancelled by the customer.	metric
children	children		dimension
churn	churn	Subscriptions that have been cancelled as a percentage of total active subscriptions. This is a calculated metric.	metric
country	country	The country associated with the report data, such as sales or ratings, usually represented by an ISO code.	dimension
country_name	country_name	The name of the country where the app activity occurred.	dimension
crashes	crashes	The total number of crashes experienced by the app.	metric
currency	currency	The currency in which monetary values (e.g., revenue, returns amount) are reported.	dimension
daily_active_devices	daily_active_devices	The number of unique devices that actively used the app on a specific day.	metric
date	date	The date of the report entry in yyyy-MM-dd format.	dimension
developer	developer	The name of the developer or company responsible for the application.	dimension
devices	devices	The number of active devices on which the application is installed and used, typically found in usage reports.	dimension
downloads	downloads	The total number of app downloads.	metric
edu_downloads	edu_downloads	The total number of educational downloads.	metric
edu_revenue	edu_revenue	The revenue from sales to educational institutions, after the store’s fee.	metric
end_date	end_date	The inclusive date to stop reporting data for a specified period.	dimension
features	features		dimension
first_year_subscribers	first_year_subscribers	The number of active subscriptions that have been active for less than one year.	metric
five_star	five_star	The total count of 5-star ratings received by the app.	metric
five_star_percent	five_star_percent	The percentage share of 5-star ratings out of the total ratings.	metric
four_star	four_star	The total count of 4-star ratings received by the app.	metric
four_star_percent	four_star_percent	The percentage share of 4-star ratings out of the total ratings.	metric
gift_redemptions	gift_redemptions	The number of times products were gifted and subsequently redeemed.	metric
grace_drop_off	grace_drop_off	Metric indicating the number of users or subscriptions that dropped off after a grace period, possibly found in subscription reports.	metric
grace_recovery	grace_recovery	The number of subscriptions that were charged successfully after failing and are now active.	metric
gross_app_returns_amount	gross_app_returns_amount	The amount of money refunded to customers from app sales, before the store’s fee, excluding in-app purchases.	metric
gross_app_revenue	gross_app_revenue	The total revenue from app sales, before the store’s fee, excluding in-app purchases.	metric
gross_business_revenue	gross_business_revenue	The revenue from downloads generated through Apple’s Volume Purchase for Business program, including the store’s fee.	metric
gross_edu_revenue	gross_edu_revenue	The revenue from sales to educational institutions, before the store’s fee.	metric
gross_iap_returns_amount	gross_iap_returns_amount	The amount of money refunded from in-app purchases, before the store’s fee.	metric
gross_iap_revenue	gross_iap_revenue	The revenue generated from in-app purchases, before the store’s fee.	metric
gross_mrr	gross_mrr	The total Monthly Recurring Revenue (MRR) generated from subscriptions before any app store fees or commissions are deducted.	metric
gross_returns_amount	gross_returns_amount	The amount of money refunded to customers, before the store’s fee.	metric
gross_revenue	gross_revenue	The total revenue before the store’s fee.	metric
gross_standard_revenue	gross_standard_revenue	The revenue generated via the store, including the store’s fee, not through any special purchasing program.	metric
gross_subscription_returns_amount	gross_subscription_returns_amount	The amount of money refunded from subscriptions, before the store’s fee.	metric
gross_subscription_revenue	gross_subscription_revenue	The revenue generated from subscriptions, before the store’s fee.	metric
has_response	has_response	Indicates whether a user review has received a response from the developer.	dimension
iap_amount	iap_amount	The number of in-app purchases (IAP) made.	metric
iap_returns	iap_returns	The total number of in-app purchase returns.	metric
iap_returns_amount	iap_returns_amount	The amount of money refunded from in-app purchases, after the store’s fee.	metric
iap_revenue	iap_revenue	The revenue generated from in-app purchases, after the store’s fee.	metric
icon	icon	The URL or identifier for the application’s icon image.	dimension
id	id	The unique identifier for the product or review.	dimension
impressions	impressions	The total number of times the app was displayed in search results or browse lists.	metric
iso	iso	The ISO code for the country associated with the report entry.	dimension
monthly_active_devices	monthly_active_devices	The number of unique devices that actively used the app in a given month.	metric
mrr	mrr	The total Monthly Recurring Revenue (MRR) from subscriptions, representing the predictable revenue generated each month, including monthly subscriptions and the monthly equivalent of longer-term subscriptions.	metric
name	name	The display name of the application or product.	dimension
negative	negative	The total number of 1-star and 2-star ratings received by the app.	metric
net_downloads	net_downloads	The total number of downloads minus returns.	metric
neutral	neutral	The total number of 3-star ratings received by the app.	metric
new_average_rating	new_average_rating	The weighted average of new ratings received in the selected time period.	metric
new_five_star	new_five_star	The number of new 5-star ratings received within the selected time period.	metric
new_four_star	new_four_star	The number of new 4-star ratings received within the selected time period.	metric
new_grace	new_grace	The number of new subscribers that could not be charged and are being retried automatically.	metric
new_negative	new_negative	The number of new 1-star and 2-star ratings received in the selected period.	metric
new_neutral	new_neutral	The number of new 3-star ratings received in the selected period.	metric
new_one_star	new_one_star	The number of new 1-star ratings received within the selected time period.	metric
new_postive	new_postive	The number of new 4-star and 5-star ratings received in the selected period.	metric
new_subscriptions	new_subscriptions	The number of new subscriptions that were activated by new customers.	metric
new_three_star	new_three_star	The number of new 3-star ratings received within the selected time period.	metric
new_total_ratings	new_total_ratings	The total number of times the app was rated in the selected time period.	metric
new_trial_grace	new_trial_grace	The number of new trial subscriptions that upgraded to a paid subscription but couldn’t be charged.	metric
new_trials	new_trials	The total number of new trial subscriptions that were activated during the specified reporting period.	metric
new_two_star	new_two_star	The number of new 2-star ratings received within the selected time period.	metric
non_first_year_subscribers	non_first_year_subscribers	The number of active subscriptions that have been ongoing for more than one year.	metric
one_star	one_star	The total count of 1-star ratings received by the app.	metric
one_star_percent	one_star_percent	The percentage share of 1-star ratings out of the total ratings.	metric
original_review	original_review	The original content of the app review before any translation.	dimension
original_title	original_title	The original title of the app review before any translation.	dimension
package_name	package_name	The unique package name for an Android application.	dimension
parent_id	parent_id	The unique identifier of the parent product. This field is present when the record represents an in-app purchase (IAP) and indicates the product ID of the main application to which the IAP belongs.	dimension
paying_subscriptions	paying_subscriptions	The total number of active subscriptions for which users are paying, either at the standard price or a discounted rate.	metric
paying_users	paying_users	The number of unique users who made a purchase within the app.	metric
positive	positive	The total number of 4-star and 5-star ratings received by the app.	metric
price.currency	price.currency	The currency code (e.g., USD, EUR) in which the application’s price is denominated.	dimension
price.price	price.price	The numerical value of the application’s price.	metric
product	product	Detailed information about the product, including its ID, name, and store.	dimension
product_id	product_id	A unique identifier for a product.	dimension
product_name	product_name	The name of the mobile application or in-app product.	dimension
re_downloads	re_downloads	The total number of downloads that were reinstalls or subsequent installs after an initial installation.	metric
reactivations	reactivations	The number of subscriptions that were activated after having expired and not renewed immediately.	metric
ref_no	ref_no		metric
release_date	release_date	The original release date of the application on the app store.	dimension
renewals	renewals	The number of subscriptions that automatically renewed successfully.	metric
returns	returns	The total number of returns for products.	metric
returns_amount	returns_amount	The total amount of money refunded to customers, after the store’s fee.	metric
revenue	revenue	The total revenue generated, after the store’s fee.	metric
review	review	The content of the app review.	dimension
sessions	sessions	The total number of user sessions within the app.	metric
sessions_per_device	sessions_per_device	The average number of sessions per active device.	metric
sku	sku	A Stock Keeping Unit (SKU) identifier for a product, often used for in-app purchases.	dimension
source.active	source.active	Status indicating if the connected data source for an application is currently active.	dimension
source.added_timestamp	source.added_timestamp	The timestamp when a specific data source was integrated or added to the platform.	dimension
source.external_account_id	source.external_account_id	The unique identifier for an external developer account linked as a data source.	dimension
source.hidden	source.hidden		dimension
source.is_competitor	source.is_competitor	A flag indicating if the data source is tracking a competitor’s application for market research.	dimension
source.tier	source.tier		dimension
source.type	source.type	The type of the connected data source, such as an app store (e.g., Apple, Google Play).	dimension
standard_downloads	standard_downloads	The number of downloads generated via the store, not through any special purchasing program (e.g., educational or business).	metric
standard_revenue	standard_revenue	The revenue generated via the store, after the store’s fee, not through any special purchasing program.	metric
stars	stars	The star rating given in the app review.	dimension
start_date	start_date	The inclusive date to start reporting data for a specified period.	dimension
store	store	The app store platform (e.g., Apple App Store, Google Play Store).	dimension
store_id	store_id	The unique identifier assigned to the application by a specific app store.	dimension
storefront	storefront	The specific platform or network from which the data originated (e.g., apple:analytics, google_analytics).	dimension
storefronts	storefronts	A list of app store storefronts (countries or regions) where the application is available.	dimension
subscription_purchases	subscription_purchases	The number of new subscription purchases.	metric
subscription_returns	subscription_returns	The total number of subscription returns.	metric
subscription_returns_amount	subscription_returns_amount	The amount of money refunded from subscriptions, after the store’s fee.	metric
subscription_revenue	subscription_revenue	The revenue generated from subscriptions, after the store’s fee.	metric
three_star	three_star	The total count of 3-star ratings received by the app.	metric
three_star_percent	three_star_percent	The percentage share of 3-star ratings out of the total ratings.	metric
title	title	The title of the app review.	dimension
total_ratings	total_ratings	The total number of times the app has been rated.	metric
transitions_in	transitions_in	The total number of upgrades, downgrades, and cross-grades that resulted in a subscription activation. This is an aggregate metric.	metric
transitions_out	transitions_out	The total number of subscriptions that have been cancelled as a result of the customer upgrading, downgrading, or cross-grading to a different subscription tier/plan. This is an aggregate metric.	metric
trial_cancellations	trial_cancellations	The total number of trial subscriptions that were cancelled by users before converting to a paying subscription.	metric
trial_conversion_rate	trial_conversion_rate	The percentage of trial subscriptions that successfully converted into paying subscriptions.	metric
trial_conversions	trial_conversions	The total number of trial subscriptions that successfully converted into paying subscriptions during the reporting period.	metric
trial_grace_drop_off	trial_grace_drop_off	The number of trial subscriptions that were cancelled because they couldn’t be charged.	metric
trial_grace_recovery	trial_grace_recovery	The number of trial subscriptions that were charged successfully after failing and are now active.	metric
two_star	two_star	The total count of 2-star ratings received by the app.	metric
two_star_percent	two_star_percent	The percentage share of 2-star ratings out of the total ratings.	metric
type	type	The classification or type of the item, such as an application, in-app purchase, or book.	dimension
uninstalls	uninstalls	The number of times the selected apps were removed from a device.	metric
unique_app_store_views	unique_app_store_views	The number of unique times the app’s product page was viewed in the app store.	metric
unique_impressions	unique_impressions	The number of unique times the app was displayed in search results or browse lists.	metric
updated_date	updated_date	The most recent date an item, such as product metadata or a report, was updated.	dimension
updates	updates	The total number of app updates.	metric
vendor_id	vendor_id	A unique identifier assigned to the app developer or vendor.	dimension
vendor_identifier	vendor_identifier	A unique identifier provided by the vendor or developer for an application.	dimension
version	version	The version number of the app.	dimension