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 |
metric |
|
active |
active |
Indicates whether a product or source 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 total count of currently active trials, including both free and potentially paid trials. |
metric |
actual_revenue |
actual_revenue |
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 |
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 |
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 |
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 |
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 |
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 before deducting the store’s fees. |
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 |
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 an entity, such as a product or review. |
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 |
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 |
dimension |
|
paying_subscriptions |
paying_subscriptions |
The total count of active subscriptions for which users are paying. |
metric |
paying_users |
paying_users |
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 store’s fees. |
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 |
metric |
|
standard_revenue |
standard_revenue |
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 title of an app or a user review. |
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 |
metric |
|
unique_impressions |
unique_impressions |
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 |