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 times an application has been activated or newly used by a user, a common metric in usage reports.	metric
active	active	A boolean flag indicating whether the product or entity is currently active.	dimension
active_discounted_subscriptions	active_discounted_subscriptions	The total count of currently active subscriptions that are offered at a discounted price.	metric
active_free_trials	active_free_trials	The total count of currently active free trials for subscriptions.	metric
active_subscriptions	active_subscriptions	The total count of currently active paid subscriptions.	metric
active_trials	active_trials	The current number of active free trials for subscriptions.	metric
actual_revenue	actual_revenue	The total revenue generated from sales or subscriptions, representing the actual earnings, available in revenue and sales reports.	metric
added_date	added_date	The date when the product was added to the platform.	dimension
ads	ads	The amount of revenue generated from ad publishing, after the store’s fee.	metric
all_active_subscriptions	all_active_subscriptions	The total count of all active subscriptions, encompassing all types (e.g., discounted, free, standard).	metric
all_subscribers	all_subscribers	The total number of active subscribers for the application.	metric
app_downloads	app_downloads	The total number of initial downloads for the app.	metric
app_returns	app_returns	The number of returns specifically for app purchases.	metric
app_returns_amount	app_returns_amount	The monetary amount of returns specifically for app purchases, after the store’s fee.	metric
app_revenue	app_revenue	The amount of revenue generated from app downloads, after the store’s fee.	metric
app_store_views	app_store_views	The total number of times an app’s product page or listing was viewed in the app store. This metric indicates the overall visibility and initial interest generated by the app.	metric
author	author	The author or user who submitted a 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 opted into certain features or data collection.	metric
bundle_identifier	bundle_identifier	The unique bundle identifier for the app.	dimension
business	business	The amount of revenue generated from purchases through the Volume Purchase for Business program, after the store’s fee.	metric
business_downloads	business_downloads	The number of app downloads attributed to the Volume Purchase for Business program.	metric
business_revenue	business_revenue	The amount of revenue generated from purchases through the Volume Purchase for Business program, after the store’s fee.	metric
cancellations	cancellations	The total number of subscription cancellations.	metric
cancelled_subscriptions	cancelled_subscriptions	The total count of subscriptions that have been cancelled.	metric
children	children	A list of child products associated with a parent product.	dimension
churn	churn	The rate at which subscribers discontinue their subscriptions.	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 reported for the app.	metric
currency	currency	The currency in which financial data, such as revenue or prices, is reported.	dimension
daily_active_devices	daily_active_devices	The number of unique devices that actively used the app on a given day.	metric
date	date	The specific date for which the report data is generated.	dimension
developer	developer	The name of the app developer.	dimension
devices	devices	The types of devices supported by the app or relevant for report filtering.	dimension
downloads	downloads	The total number of initial app downloads.	metric
edu	edu	The amount of revenue generated from purchases through the Volume Purchase for Education program, after the store’s fee.	metric
edu_downloads	edu_downloads	The number of app downloads attributed to the Volume Purchase for Education program.	metric
edu_revenue	edu_revenue	The amount of revenue generated from purchases through the Volume Purchase for Education program, after the store’s fee.	metric
end_date	end_date	The inclusive date to stop reporting data for a specified period.	dimension
features	features	A list of features associated with the product.	dimension
first_year_subscribers	first_year_subscribers	The number of subscribers who are currently within their first year of subscription.	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 total number of times gifted products within the report were redeemed by users.	dimension
grace_drop_off	grace_drop_off	The number of subscriptions that entered a grace period and subsequently dropped off without renewal.	metric
grace_recovery	grace_recovery	The number of subscriptions that were in a grace period and successfully recovered to an active state.	metric
gross_app_returns_amount	gross_app_returns_amount	The monetary amount of returns specifically for app purchases, before the store’s fee.	metric
gross_app_revenue	gross_app_revenue	The amount of revenue generated from app downloads, before the store’s fee.	metric
gross_business	gross_business	The amount of revenue generated from purchases through the Volume Purchase for Business program, before the store’s fee.	metric
gross_business_revenue	gross_business_revenue	The amount of revenue generated from purchases through the Volume Purchase for Business program, before the store’s fee.	metric
gross_edu	gross_edu	The amount of revenue generated from purchases through the Volume Purchase for Education program, before the store’s fee.	metric
gross_edu_revenue	gross_edu_revenue	The amount of revenue generated from purchases through the Volume Purchase for Education program, before the store’s fee.	metric
gross_iap	gross_iap	The amount of revenue generated from in-app purchases, before the store’s fee.	metric
gross_iap_returns_amount	gross_iap_returns_amount	The monetary amount of returns specifically for in-app purchases, before the store’s fee.	metric
gross_iap_revenue	gross_iap_revenue	The amount of revenue generated from in-app purchases, before the store’s fee.	metric
gross_mrr	gross_mrr	The total Monthly Recurring Revenue (MRR) before any deductions or fees.	metric
gross_returns	gross_returns	The total amount of money returned to users, not including the store’s fee.	metric
gross_returns_amount	gross_returns_amount	The total amount of money returned to users, not including the store’s fee.	metric
gross_revenue	gross_revenue	The total revenue generated from sales before any store fees are deducted, in the user’s selected currency.	metric
gross_sales	gross_sales	The amount of revenue generated from app downloads, before the store’s fee.	metric
gross_standard_revenue	gross_standard_revenue	The revenue generated from standard sales, including the store’s fee, excluding educational or business program purchases.	metric
gross_subscription_returns_amount	gross_subscription_returns_amount	The monetary amount of returns specifically for subscriptions, before the store’s fee.	metric
gross_subscription_revenue	gross_subscription_revenue	The amount of revenue generated from recurring in-app purchases (subscriptions), before the store’s fee.	metric
gross_subscriptions	gross_subscriptions	The amount of revenue generated from recurring in-app purchases (subscriptions), before the store’s fee.	metric
gross_total	gross_total	The total revenue for the period, before the store’s fee.	metric
has_response	has_response	Indicates whether a review has a developer response.	dimension
iap	iap	The amount of revenue generated from in-app purchases, after the store’s fee.	metric
iap_amount	iap_amount	The amount of revenue generated from in-app purchases, after the store’s fee.	metric
iap_returns	iap_returns	The number of returns specifically for in-app purchases.	metric
iap_returns_amount	iap_returns_amount	The monetary amount of returns specifically for in-app purchases, after the store’s fee.	metric
iap_revenue	iap_revenue	The amount of revenue generated from in-app purchases, after the store’s fee.	metric
icon	icon	The URL or identifier for the app’s icon.	dimension
id	id	A unique identifier for the product (app or in-app purchase).	dimension
impressions	impressions	The total number of times an app’s listing was viewed in the app store, representing visibility.	metric
iso	iso	The ISO 3166-1 alpha-2 code representing a country.	dimension
monthly_active_devices	monthly_active_devices	The number of unique devices that actively used the app during a given month.	metric
mrr	mrr	The total Monthly Recurring Revenue (MRR) for subscriptions, after deductions.	metric
name	name	The name of the 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 after accounting for re-downloads and 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 subscriptions that have entered a grace period.	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 total count of new subscriptions acquired.	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 trials that have entered a grace period.	metric
new_trials	new_trials	The total count of new trials started for subscriptions.	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 subscribers who are beyond their first year of subscription.	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 text content of a user review.	dimension
original_title	original_title	The original title of a user review.	dimension
package_name	package_name	The package name for Android apps.	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 count of active subscriptions for which users are paying.	metric
paying_users	paying_users	The total number of unique users who have made a purchase or subscription within the reporting period, a key metric in sales and revenue reports.	metric
positive	positive	The total number of 4-star and 5-star ratings received by the app.	metric
price.currency	price.currency	The currency of the app’s price.	dimension
price.price	price.price	The price of the app.	metric
product	product	Refers to a specific mobile application or in-app product.	metric
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 number of times an app was re-downloaded by users who previously owned it.	metric
reactivations	reactivations	The number of previously cancelled or expired subscriptions that have been reactivated.	metric
ref_no	ref_no	A reference number for the product.	metric
release_date	release_date	The date when the app was initially released.	dimension
renewals	renewals	The total number of subscription renewals.	metric
returns	returns	The amount of money returned to users, after the store’s fee.	metric
returns_amount	returns_amount	The total monetary amount of returns, after the store’s fee.	metric
revenue	revenue	The total revenue generated from sales after the app store’s fees have been deducted, in the user’s selected currency.	metric
review	review	The text content of a user’s review for an app.	dimension
sales	sales	The amount of revenue generated from app downloads, after the store’s fee.	metric
sessions	sessions	The total number of times users launched and engaged with the app.	metric
sessions_per_device	sessions_per_device	The average number of sessions per active device.	metric
sku	sku	The Stock Keeping Unit (SKU) for the product.	dimension
source.active	source.active	Indicates if the data source for the product is active.	dimension
source.added_timestamp	source.added_timestamp	The timestamp when the data source was added.	dimension
source.external_account_id	source.external_account_id	The ID of the external account associated with the data source.	dimension
source.hidden	source.hidden	Indicates if the data source is hidden.	dimension
source.is_competitor	source.is_competitor	Indicates if the data source belongs to a competitor.	dimension
source.tier	source.tier	The tier level of the data source.	dimension
source.type	source.type	The type of the data source.	dimension
standard_downloads	standard_downloads	The total number of downloads from standard app store sales, excluding downloads from educational or business programs.	metric
standard_revenue	standard_revenue	The revenue generated from standard sales, after the store’s fee, excluding educational or business program purchases.	metric
stars	stars	The star rating given in a user review.	metric
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 for the app store.	dimension
storefront	storefront	The specific storefront where an app is available.	dimension
storefronts	storefronts	A list of storefronts where the product is available.	dimension
subscription_purchases	subscription_purchases	The number of new purchases for subscriptions.	metric
subscription_returns	subscription_returns	The number of returns specifically for subscriptions.	metric
subscription_returns_amount	subscription_returns_amount	The monetary amount of returns specifically for subscriptions, after the store’s fee.	metric
subscription_revenue	subscription_revenue	The amount of revenue generated from recurring in-app purchases (subscriptions), after the store’s fee.	metric
subscriptions	subscriptions	The total count of active subscriptions or the revenue generated from them.	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 display name or title of the product (app or in-app purchase).	dimension
total	total	The total revenue for the period, after the store’s fee.	metric
total_ratings	total_ratings	The total number of times the app has been rated.	metric
transitions_in	transitions_in	The number of users who transitioned into a specific subscription state.	metric
transitions_out	transitions_out	The number of users who transitioned out of a specific subscription state.	metric
trial_cancellations	trial_cancellations	The total number of trial subscriptions that were cancelled.	metric
trial_conversion_rate	trial_conversion_rate	The percentage of trials that successfully converted into paid subscriptions.	metric
trial_conversions	trial_conversions	The total number of trials that successfully converted into paid subscriptions.	metric
trial_grace_drop_off	trial_grace_drop_off	The number of trial subscriptions that entered a grace period and subsequently dropped off.	metric
trial_grace_recovery	trial_grace_recovery	The number of trial subscriptions that were in a grace period and successfully recovered.	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 type of the product (e.g., app, in-app purchase).	dimension
uninstalls	uninstalls	The total number of times the app was uninstalled by users.	metric
unique_app_store_views	unique_app_store_views	The number of distinct users who viewed an app’s product page or listing in the app store, providing insights into unique user interest.	metric
unique_impressions	unique_impressions	The count of distinct users to whom an advertisement or app store listing was displayed, commonly found in advertising or ad spend reports.	metric
updated_date	updated_date	The date when the product information was last updated.	dimension
updates	updates	The number of times an app was updated by existing users.	metric
vendor_id	vendor_id	A unique identifier assigned to the app developer or vendor.	dimension
vendor_identifier	vendor_identifier	A unique identifier for the app’s vendor or developer.	dimension
version	version	The version number of the app.	dimension