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
active	active	Status indicating if the product or source is currently active within the Appfigures platform.	dimension
added_date	added_date	This field represents the date when the data record was added or a specific event occurred, such as a review being left. It can be used for filtering data within a specific timeframe.	dimension
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
children	children	The ‘children’ field represents related products or in-app purchases associated with a main product, typically found in product metadata from the Appfigures API.	dimension
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	The ‘features’ field typically refers to information about an app being featured on various app store lists or promotions, aligning with the /featured endpoint of the Appfigures API.	dimension
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
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_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
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_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_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_two_star	new_two_star	The number of new 2-star ratings received within the selected time period.	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_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
ref_no	ref_no	A unique reference number or identifier used to distinguish a specific entity, such as a product, transaction, or record, within the Appfigures data.	metric
release_date	release_date	The original release date of the application on the app store.	dimension
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	This field represents the Stock Keeping Unit (SKU), a unique identifier used to track and manage a specific product within the Appfigures platform.	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	This field indicates the precise date and time when the original data was recorded or received from the source system, such as the timestamp of a user review.	dimension
source.external_account_id	source.external_account_id	The unique identifier for an external developer account linked as a data source.	metric
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
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	This field contains the unique identifier assigned to a product by its respective app store vendor (e.g., Apple App Store ID or Google Play package name).	dimension
version	version	The version number of the app.	dimension