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 |
|---|---|---|---|
app_downloads |
The number of downloads for the app, excluding in-app purchases. |
metric |
|
app_returns |
The total number of returns for apps, excluding in-app purchases. |
metric |
|
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 |
The total revenue from app sales, after the store’s fee, excluding in-app purchases. |
metric |
|
app_store_views |
The number of times the app’s product page was viewed in the app store. |
metric |
|
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 |
The average rate at which users opt-in for certain features or data collection. |
metric |
|
business_downloads |
The number of downloads received through Apple’s Volume Purchase for Business program. |
metric |
|
business_revenue |
The revenue from downloads generated through Apple’s Volume Purchase for Business program, after the store’s fee. |
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 |
The total number of crashes experienced by the app. |
metric |
|
currency |
The currency in which monetary values (e.g., revenue, returns amount) are reported. |
dimension |
|
daily_active_devices |
The number of unique devices that actively used the app on a specific day. |
metric |
|
date |
The date of the report entry in yyyy-MM-dd format. |
dimension |
|
downloads |
The total number of app downloads. |
metric |
|
edu_downloads |
The total number of educational downloads. |
metric |
|
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 |
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 |
The number of times products were gifted and subsequently redeemed. |
metric |
|
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 |
The total revenue from app sales, before the store’s fee, excluding in-app purchases. |
metric |
|
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 |
The revenue from sales to educational institutions, before the store’s fee. |
metric |
|
gross_iap_returns_amount |
The amount of money refunded from in-app purchases, before the store’s fee. |
metric |
|
gross_iap_revenue |
The revenue generated from in-app purchases, before the store’s fee. |
metric |
|
gross_returns_amount |
The amount of money refunded to customers, before the store’s fee. |
metric |
|
gross_revenue |
The total revenue before the store’s fee. |
metric |
|
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 |
The amount of money refunded from subscriptions, before the store’s fee. |
metric |
|
gross_subscription_revenue |
The revenue generated from subscriptions, before the store’s fee. |
metric |
|
has_response |
dimension |
||
iap_amount |
The number of in-app purchases (IAP) made. |
metric |
|
iap_returns |
The total number of in-app purchase returns. |
metric |
|
iap_returns_amount |
The amount of money refunded from in-app purchases, after the store’s fee. |
metric |
|
iap_revenue |
The revenue generated from in-app purchases, after the store’s fee. |
metric |
|
id |
The unique identifier for the product or review. |
dimension |
|
impressions |
The total number of times the app was displayed in search results or browse lists. |
metric |
|
iso |
The ISO code for the country associated with the report entry. |
dimension |
|
monthly_active_devices |
The number of unique devices that actively used the app in a given month. |
metric |
|
negative |
negative |
The total number of 1-star and 2-star ratings received by the app. |
metric |
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 |
The original content of the app review before any translation. |
dimension |
|
original_title |
The original title of the app review before any translation. |
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 |
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 |
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 |
The total number of downloads that were reinstalls or subsequent installs after an initial installation. |
metric |
|
returns |
The total number of returns for products. |
metric |
|
returns_amount |
The total amount of money refunded to customers, after the store’s fee. |
metric |
|
revenue |
The total revenue generated, after the store’s fee. |
metric |
|
review |
The content of the app review. |
dimension |
|
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 |
standard_downloads |
The number of downloads generated via the store, not through any special purchasing program (e.g., educational or business). |
metric |
|
standard_revenue |
The revenue generated via the store, after the store’s fee, not through any special purchasing program. |
metric |
|
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 |
storefront |
The specific platform or network from which the data originated (e.g., apple:analytics, google_analytics). |
dimension |
|
subscription_purchases |
The number of new subscription purchases. |
metric |
|
subscription_returns |
The total number of subscription returns. |
metric |
|
subscription_returns_amount |
The amount of money refunded from subscriptions, after the store’s fee. |
metric |
|
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 |
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 |
uninstalls |
The number of times the selected apps were removed from a device. |
metric |
|
unique_app_store_views |
The number of unique times the app’s product page was viewed in the app store. |
metric |
|
unique_impressions |
The number of unique times the app was displayed in search results or browse lists. |
metric |
|
updates |
The total number of app updates. |
metric |
|
vendor_id |
vendor_id |
A unique identifier assigned to the app developer or vendor. |
dimension |
version |
version |
The version number of the app. |
dimension |