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.
active Metric
Status indicating if the product or source is currently active within the Appfigures platform.
added_date Dimension
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.
app_downloads Metric
The number of downloads for the app, excluding in-app purchases.
app_returns Metric
The total number of returns for apps, excluding in-app purchases.
app_returns_amount Metric
The amount of money refunded to customers from app sales, after the store's fee, excluding in-app purchases.
app_revenue Metric
The total revenue from app sales, after the store's fee, excluding in-app purchases.
app_store_views Metric
The number of times the app's product page was viewed in the app store.
author Dimension
The name of the user who submitted the review.
average_rating Metric
The weighted average rating of an app based on all ratings received.
avg_daily_active_devices Metric
The average number of unique devices that actively used the app on a daily basis.
avg_optin_rate Metric
The average rate at which users opt-in for certain features or data collection.
bundle_identifier Dimension
The unique bundle identifier for an application, commonly used for iOS apps.
business_downloads Metric
The number of downloads received through Apple's Volume Purchase for Business program.
business_revenue Metric
The revenue from downloads generated through Apple's Volume Purchase for Business program, after the store's fee.
children Dimension
A list of product IDs representing in-app purchases that belong to a parent product.
country Dimension
The country associated with the report data, such as sales or ratings, usually represented by an ISO code.
country_name Dimension
The name of the country where the app activity occurred.
crashes Metric
The total number of crashes experienced by the app.
currency Dimension
The currency in which monetary values (e.g., revenue, returns amount) are reported.
daily_active_devices Metric
The number of unique devices that actively used the app on a specific day.
date Dimension
The date of the report entry in yyyy-MM-dd format.
developer Dimension
The name of the developer or company responsible for the application.
devices Dimension
A list of device types on which the product is available for sale, such as "Handheld" (e.g., iPhone), "Tablet" (e.g., iPad), or "Desktop".
downloads Metric
The total number of app downloads.
edu_downloads Metric
The total number of educational downloads.
edu_revenue Metric
The revenue from sales to educational institutions, after the store's fee.
end_date Dimension
The inclusive date to stop reporting data for a specified period.
features Dimension
A list of additional features or attributes associated with a product.
five_star Metric
The total count of 5-star ratings received by the app.
five_star_percent Metric
The percentage share of 5-star ratings out of the total ratings.
four_star Metric
The total count of 4-star ratings received by the app.
four_star_percent Metric
The percentage share of 4-star ratings out of the total ratings.
gift_redemptions Metric
The number of times products were gifted and subsequently redeemed.
gross_app_returns_amount Metric
The amount of money refunded to customers from app sales, before the store's fee, excluding in-app purchases.
gross_app_revenue Metric
The total revenue from app sales, before the store's fee, excluding in-app purchases.
gross_business_revenue Metric
The revenue from downloads generated through Apple's Volume Purchase for Business program, including the store's fee.
gross_edu_revenue Metric
The revenue from sales to educational institutions, before the store's fee.
gross_iap_returns_amount Metric
The amount of money refunded from in-app purchases, before the store's fee.
gross_iap_revenue Metric
The revenue generated from in-app purchases, before the store's fee.
gross_returns_amount Metric
The amount of money refunded to customers, before the store's fee.
gross_revenue Metric
The total revenue before the store's fee.
gross_standard_revenue Metric
The revenue generated via the store, including the store's fee, not through any special purchasing program.
gross_subscription_returns_amount Metric
The amount of money refunded from subscriptions, before the store's fee.
gross_subscription_revenue Metric
The revenue generated from subscriptions, before the store's fee.
has_response Dimension
Indicates whether a user review has received a response from the developer.
iap_amount Metric
The number of in-app purchases (IAP) made.
iap_returns Metric
The total number of in-app purchase returns.
iap_returns_amount Metric
The amount of money refunded from in-app purchases, after the store's fee.
iap_revenue Metric
The revenue generated from in-app purchases, after the store's fee.
icon Dimension
The URL or identifier for the application's icon image.
id Dimension
The unique identifier for the product or review.
impressions Metric
The total number of times the app was displayed in search results or browse lists.
iso Dimension
The ISO code for the country associated with the report entry.
monthly_active_devices Metric
The number of unique devices that actively used the app in a given month.
name Dimension
The display name of the application or product.
negative Metric
The total number of 1-star and 2-star ratings received by the app.
net_downloads Metric
The total number of downloads minus returns.
neutral Metric
The total number of 3-star ratings received by the app.
new_average_rating Metric
The weighted average of new ratings received in the selected time period.
new_five_star Metric
The number of new 5-star ratings received within the selected time period.
new_four_star Metric
The number of new 4-star ratings received within the selected time period.
new_negative Metric
The number of new 1-star and 2-star ratings received in the selected period.
new_neutral Metric
The number of new 3-star ratings received in the selected period.
new_one_star Metric
The number of new 1-star ratings received within the selected time period.
new_postive Metric
The number of new 4-star and 5-star ratings received in the selected period.
new_three_star Metric
The number of new 3-star ratings received within the selected time period.
new_total_ratings Metric
The total number of times the app was rated in the selected time period.
new_two_star Metric
The number of new 2-star ratings received within the selected time period.
one_star Metric
The total count of 1-star ratings received by the app.
one_star_percent Metric
The percentage share of 1-star ratings out of the total ratings.
original_review Dimension
The original content of the app review before any translation.
original_title Dimension
The original title of the app review before any translation.
package_name Dimension
The unique package name for an Android application.
parent_id Dimension
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.
paying_users Metric
The number of unique users who made a purchase within the app.
positive Metric
The total number of 4-star and 5-star ratings received by the app.
price.currency Dimension
The currency code (e.g., USD, EUR) in which the application's price is denominated.
price.price Metric
The numerical value of the application's price.
product Dimension
Detailed information about the product, including its ID, name, and store.
product_id Dimension
A unique identifier for a product.
product_name Dimension
The name of the mobile application or in-app product.
re_downloads Metric
The total number of downloads that were reinstalls or subsequent installs after an initial installation.
ref_no Metric
A unique reference number or identifier used to distinguish a specific entity, such as a product, transaction, or record, within the Appfigures data.
release_date Dimension
The original release date of the application on the app store.
returns Metric
The total number of returns for products.
returns_amount Metric
The total amount of money refunded to customers, after the store's fee.
revenue Metric
The total revenue generated, after the store's fee.
review Dimension
The content of the app review.
sessions Metric
The total number of user sessions within the app.
sessions_per_device Metric
The average number of sessions per active device.
sku Dimension
This field represents the Stock Keeping Unit (SKU), a unique identifier used to track and manage a specific product within the Appfigures platform.
source.active Dimension
Status indicating if the connected data source for an application is currently active.
source.added_timestamp Dimension
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.
source.external_account_id Dimension
The unique identifier for an external developer account linked as a data source.
source.hidden Dimension
This field indicates whether a product, such as an app, in-app purchase, or book, is currently considered inactive or 'hidden' within the Appfigures system. When fetching product data, inactive products can be explicitly included or excluded.
source.is_competitor Dimension
A flag indicating if the data source is tracking a competitor's application for market research.
source.tier Dimension
This field classifies the type or service level of the connected data source within the Appfigures platform.
source.type Dimension
The type of the connected data source, such as an app store (e.g., Apple, Google Play).
standard_downloads Metric
The number of downloads generated via the store, not through any special purchasing program (e.g., educational or business).
standard_revenue Metric
The revenue generated via the store, after the store's fee, not through any special purchasing program.
stars Dimension
The star rating given in the app review.
start_date Dimension
The inclusive date to start reporting data for a specified period.
store Dimension
The app store platform (e.g., Apple App Store, Google Play Store).
store_id Dimension
The unique identifier assigned to the application by a specific app store.
storefront Dimension
The specific platform or network from which the data originated (e.g., apple:analytics, google_analytics).
storefronts Dimension
A list of app store storefronts (countries or regions) where the application is available.
subscription_purchases Metric
The number of new subscription purchases.
subscription_returns Metric
The total number of subscription returns.
subscription_returns_amount Metric
The amount of money refunded from subscriptions, after the store's fee.
subscription_revenue Metric
The revenue generated from subscriptions, after the store's fee.
three_star Metric
The total count of 3-star ratings received by the app.
three_star_percent Metric
The percentage share of 3-star ratings out of the total ratings.
title Dimension
The title of the app review.
total_ratings Metric
The total number of times the app has been rated.
two_star Metric
The total count of 2-star ratings received by the app.
two_star_percent Metric
The percentage share of 2-star ratings out of the total ratings.
type Dimension
The classification or type of the item, such as an application, in-app purchase, or book.
uninstalls Metric
The number of times the selected apps were removed from a device.
unique_app_store_views Metric
The number of unique times the app's product page was viewed in the app store.
unique_impressions Metric
The number of unique times the app was displayed in search results or browse lists.
updated_date Dimension
The most recent date an item, such as product metadata or a report, was updated.
updates Metric
The total number of app updates.
vendor_id Dimension
A unique identifier assigned to the app developer or vendor.
vendor_identifier Dimension
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).
version Dimension
The version number of the app.