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.
activeMetric
Status indicating if the product or source is currently active within the Appfigures platform.
added_dateDimension
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_downloadsMetric
The number of downloads for the app, excluding in-app purchases.
app_returnsMetric
The total number of returns for apps, excluding in-app purchases.
app_returns_amountMetric
The amount of money refunded to customers from app sales, after the store's fee, excluding in-app purchases.
app_revenueMetric
The total revenue from app sales, after the store's fee, excluding in-app purchases.
app_store_viewsMetric
The number of times the app's product page was viewed in the app store.
authorDimension
The name of the user who submitted the review.
average_ratingMetric
The weighted average rating of an app based on all ratings received.
avg_daily_active_devicesMetric
The average number of unique devices that actively used the app on a daily basis.
avg_optin_rateMetric
The average rate at which users opt-in for certain features or data collection.
bundle_identifierDimension
The unique bundle identifier for an application, commonly used for iOS apps.
business_downloadsMetric
The number of downloads received through Apple's Volume Purchase for Business program.
business_revenueMetric
The revenue from downloads generated through Apple's Volume Purchase for Business program, after the store's fee.
childrenDimension
A list of product IDs representing in-app purchases that belong to a parent product.
countryDimension
The country associated with the report data, such as sales or ratings, usually represented by an ISO code.
country_nameDimension
The name of the country where the app activity occurred.
crashesMetric
The total number of crashes experienced by the app.
currencyDimension
The currency in which monetary values (e.g., revenue, returns amount) are reported.
daily_active_devicesMetric
The number of unique devices that actively used the app on a specific day.
dateDimension
The date of the report entry in yyyy-MM-dd format.
developerDimension
The name of the developer or company responsible for the application.
devicesDimension
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".
downloadsMetric
The total number of app downloads.
edu_downloadsMetric
The total number of educational downloads.
edu_revenueMetric
The revenue from sales to educational institutions, after the store's fee.
end_dateDimension
The inclusive date to stop reporting data for a specified period.
featuresDimension
A list of additional features or attributes associated with a product.
five_starMetric
The total count of 5-star ratings received by the app.
five_star_percentMetric
The percentage share of 5-star ratings out of the total ratings.
four_starMetric
The total count of 4-star ratings received by the app.
four_star_percentMetric
The percentage share of 4-star ratings out of the total ratings.
gift_redemptionsMetric
The number of times products were gifted and subsequently redeemed.
gross_app_returns_amountMetric
The amount of money refunded to customers from app sales, before the store's fee, excluding in-app purchases.
gross_app_revenueMetric
The total revenue from app sales, before the store's fee, excluding in-app purchases.
gross_business_revenueMetric
The revenue from downloads generated through Apple's Volume Purchase for Business program, including the store's fee.
gross_edu_revenueMetric
The revenue from sales to educational institutions, before the store's fee.
gross_iap_returns_amountMetric
The amount of money refunded from in-app purchases, before the store's fee.
gross_iap_revenueMetric
The revenue generated from in-app purchases, before the store's fee.
gross_returns_amountMetric
The amount of money refunded to customers, before the store's fee.
gross_revenueMetric
The total revenue before the store's fee.
gross_standard_revenueMetric
The revenue generated via the store, including the store's fee, not through any special purchasing program.
gross_subscription_returns_amountMetric
The amount of money refunded from subscriptions, before the store's fee.
gross_subscription_revenueMetric
The revenue generated from subscriptions, before the store's fee.
has_responseDimension
Indicates whether a user review has received a response from the developer.
iap_amountMetric
The number of in-app purchases (IAP) made.
iap_returnsMetric
The total number of in-app purchase returns.
iap_returns_amountMetric
The amount of money refunded from in-app purchases, after the store's fee.
iap_revenueMetric
The revenue generated from in-app purchases, after the store's fee.
iconDimension
The URL or identifier for the application's icon image.
idDimension
The unique identifier for the product or review.
impressionsMetric
The total number of times the app was displayed in search results or browse lists.
isoDimension
The ISO code for the country associated with the report entry.
monthly_active_devicesMetric
The number of unique devices that actively used the app in a given month.
nameDimension
The display name of the application or product.
negativeMetric
The total number of 1-star and 2-star ratings received by the app.
net_downloadsMetric
The total number of downloads minus returns.
neutralMetric
The total number of 3-star ratings received by the app.
new_average_ratingMetric
The weighted average of new ratings received in the selected time period.
new_five_starMetric
The number of new 5-star ratings received within the selected time period.
new_four_starMetric
The number of new 4-star ratings received within the selected time period.
new_negativeMetric
The number of new 1-star and 2-star ratings received in the selected period.
new_neutralMetric
The number of new 3-star ratings received in the selected period.
new_one_starMetric
The number of new 1-star ratings received within the selected time period.
new_postiveMetric
The number of new 4-star and 5-star ratings received in the selected period.
new_three_starMetric
The number of new 3-star ratings received within the selected time period.
new_total_ratingsMetric
The total number of times the app was rated in the selected time period.
new_two_starMetric
The number of new 2-star ratings received within the selected time period.
one_starMetric
The total count of 1-star ratings received by the app.
one_star_percentMetric
The percentage share of 1-star ratings out of the total ratings.
original_reviewDimension
The original content of the app review before any translation.
original_titleDimension
The original title of the app review before any translation.
package_nameDimension
The unique package name for an Android application.
parent_idDimension
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_usersMetric
The number of unique users who made a purchase within the app.
positiveMetric
The total number of 4-star and 5-star ratings received by the app.
price.currencyDimension
The currency code (e.g., USD, EUR) in which the application's price is denominated.
price.priceMetric
The numerical value of the application's price.
productDimension
Detailed information about the product, including its ID, name, and store.
product_idDimension
A unique identifier for a product.
product_nameDimension
The name of the mobile application or in-app product.
re_downloadsMetric
The total number of downloads that were reinstalls or subsequent installs after an initial installation.
ref_noMetric
A unique reference number or identifier used to distinguish a specific entity, such as a product, transaction, or record, within the Appfigures data.
release_dateDimension
The original release date of the application on the app store.
returnsMetric
The total number of returns for products.
returns_amountMetric
The total amount of money refunded to customers, after the store's fee.
revenueMetric
The total revenue generated, after the store's fee.
reviewDimension
The content of the app review.
sessionsMetric
The total number of user sessions within the app.
sessions_per_deviceMetric
The average number of sessions per active device.
skuDimension
This field represents the Stock Keeping Unit (SKU), a unique identifier used to track and manage a specific product within the Appfigures platform.
source.activeDimension
Status indicating if the connected data source for an application is currently active.
source.added_timestampDimension
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_idDimension
The unique identifier for an external developer account linked as a data source.
source.hiddenDimension
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_competitorDimension
A flag indicating if the data source is tracking a competitor's application for market research.
source.tierDimension
This field classifies the type or service level of the connected data source within the Appfigures platform.
source.typeDimension
The type of the connected data source, such as an app store (e.g., Apple, Google Play).
standard_downloadsMetric
The number of downloads generated via the store, not through any special purchasing program (e.g., educational or business).
standard_revenueMetric
The revenue generated via the store, after the store's fee, not through any special purchasing program.
starsDimension
The star rating given in the app review.
start_dateDimension
The inclusive date to start reporting data for a specified period.
storeDimension
The app store platform (e.g., Apple App Store, Google Play Store).
store_idDimension
The unique identifier assigned to the application by a specific app store.
storefrontDimension
The specific platform or network from which the data originated (e.g., apple:analytics, google_analytics).
storefrontsDimension
A list of app store storefronts (countries or regions) where the application is available.
subscription_purchasesMetric
The number of new subscription purchases.
subscription_returnsMetric
The total number of subscription returns.
subscription_returns_amountMetric
The amount of money refunded from subscriptions, after the store's fee.
subscription_revenueMetric
The revenue generated from subscriptions, after the store's fee.
three_starMetric
The total count of 3-star ratings received by the app.
three_star_percentMetric
The percentage share of 3-star ratings out of the total ratings.
titleDimension
The title of the app review.
total_ratingsMetric
The total number of times the app has been rated.
two_starMetric
The total count of 2-star ratings received by the app.
two_star_percentMetric
The percentage share of 2-star ratings out of the total ratings.
typeDimension
The classification or type of the item, such as an application, in-app purchase, or book.
uninstallsMetric
The number of times the selected apps were removed from a device.
unique_app_store_viewsMetric
The number of unique times the app's product page was viewed in the app store.
unique_impressionsMetric
The number of unique times the app was displayed in search results or browse lists.
updated_dateDimension
The most recent date an item, such as product metadata or a report, was updated.
updatesMetric
The total number of app updates.
vendor_idDimension
A unique identifier assigned to the app developer or vendor.
vendor_identifierDimension
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).
versionDimension
The version number of the app.