App Annie
The table below gives information about all the data fields that you can import from App Annie.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs. As a result, the fields shown here may not be the same as the fields available in Adverity. If you notice a difference between this documentation and the fields you see in Adverity, please contact your Adverity account manager for more information.
To see the fields you can collect from another data source, go back to the Available fields in Adverity overview.
|
Field UI name |
Field API name |
Description |
Use in Adverity |
Docs |
|---|---|---|---|---|
|
App Store Notes |
app_store_notes |
The App Store Editor’s Notes found on certain apps on the iOS App Store (iOS only). |
dimension |
|
|
Bundle ID |
bundle_id |
Bandle ID. |
dimension |
|
|
Code |
code |
Feature type code used to designate specific feature types in the Featured API. |
dimension |
|
|
Company ID |
company_id |
ID of universal company of the app |
dimension |
|
|
Company Name |
company_name |
Name of the universal company of the app. |
dimension |
|
|
Company URL |
company_url |
URL of the universal company of the app. |
dimension |
|
|
Content Rating |
content_rating |
The content rating for an app (iOS & GP only). |
dimension |
|
|
Country |
country |
Country code used to designate a category in the Featured API. |
dimension |
|
|
Currency |
currency |
The currency used in the response. |
dimension |
|
|
Current Release Date |
current_release_date |
The date of the app's most recent release (iOS & GP only). |
dimension |
|
|
Current Version |
current_version |
Current version. |
dimension |
|
|
Description |
description |
Product description. |
dimension |
|
|
Device |
device |
One of these devices: iphone | ipad | mac | android | x86 | x64 | arm. |
dimension |
|
|
Editorial Badge Name |
editorial_badge_name |
Editorial badge name. |
dimension |
|
|
Editorial Badge Type |
editorial_badge_type |
Editorial badge type. |
dimension |
|
|
Family Sharing |
family_sharing |
Yes | No Product supports family sharing (iOS only). |
dimension |
|
|
Has Gamecenter |
has_gamecenter |
Whether or not the app supports Apple’s Game Center feature - T | F (iOS only). |
dimension |
|
|
Has IAP |
has_iap |
In app purchase. |
dimension |
|
|
Headquarter Country |
headquarter_country |
The country of the company's headquarters. |
dimension |
|
|
IAP Sales List Country |
iap_sales_list.country |
The country of the IAP sales data. |
dimension |
|
|
IAP Sales List Date |
iap_sales_list.date |
The date of the IAP sale. |
dimension |
|
|
IAP Sales List Revenue Promotions |
iap_sales_list.revenue.promotions |
The revenue of IAP's promotions. |
metric |
|
|
IAP Sales List Revenue Refunds |
iap_sales_list.revenue.refunds |
The revenue of IAP's refunds. |
metric |
|
|
IAP Sales List Revenue Sales |
iap_sales_list.revenue.sales |
The number of IAP's sales. |
metric |
|
|
IAP Sales List Units Promotions |
iap_sales_list.units.promotions |
The number of IAP's promotions. |
metric |
|
|
IAP Sales List Units Refunds |
iap_sales_list.units.refunds |
The number of IAP's refunds. |
metric |
|
|
IAP Sales List Units Sales |
iap_sales_list.units.sales |
The number of IAP's sales. |
metric |
|
|
Icon |
icon |
The icon url of this product. |
dimension |
|
|
Languages |
languages |
Comma concatenated language list (only available for ios and mac apps), |
dimension |
|
|
Last Update |
last_update |
Last App Details Data Refresh. (Please note that this is not the version update date.) |
dimension |
|
|
Main Category |
main_category |
Primary category the product is ranked in. |
dimension |
|
|
Main Category Path |
main_category_path |
Primary category the product is ranked in. |
dimension |
|
|
Market |
market |
One of the markets: ios | mac | appletv | google-play | amazon-appstore. |
dimension |
|
|
Name |
name |
Name of feature category page. |
dimension |
|
|
Only 32 Bit |
only_32_bit |
The indicator for whether or not an app is only a 32-bit app (iOS only) - T | F. |
dimension |
|
|
Original Icon |
original_icon |
The icon url from app store. |
dimension |
|
|
Other Categories |
other_categories |
Other categories the product has been ranked in the last 30 days. |
dimension |
|
|
Other Category Paths |
other_category_paths |
Other categories the product has been ranked in the last 30 days. |
dimension |
|
|
Parent Company ID |
parent_company_id |
ID of the parent company of the universal company of the app. |
dimension |
|
|
Parent Company Name |
parent_company_name |
Name of the parent company of the universal company of the app. |
dimension |
|
|
Price |
price |
Product price. |
metric |
|
|
Privacy Policy URL |
privacy_policy_url |
The privacy policy URL for an app as listed by the publisher (iOS & GP only). |
dimension |
|
|
Product Code |
product_code |
Product external code. |
dimension |
|
|
Product Franchise ID |
product_franchise_id |
ID of the franchise of the app. |
dimension |
|
|
Product Franchise Name |
product_franchise_name |
Name of the franchise of the app. |
dimension |
|
|
Product ID |
product_id |
The id of the product. |
dimension |
|
|
Product Name |
product_name |
Product name. |
dimension |
|
|
Product Name |
product_name |
The name of the product that is mentioned in request url. |
dimension |
|
|
Product Ranks Category |
product_ranks.category |
The category in the app store, full path, like: Overall > Games. |
dimension |
|
|
Product Ranks Country |
product_ranks.country |
Country code. |
dimension |
|
|
Product Ranks Feed |
product_ranks.feed |
The feed of ranks. |
dimension |
|
|
Product Ranks Interval |
product_ranks.interval |
The interval time of ranks (daily or hourly). |
dimension |
|
|
Product Ranks |
product_ranks.ranks |
Retrieved rank data. The value is integer if interval is daily, if interval is hourly, the value would be a list of integer like [1, 2, 2, 3, ...]. The integer value is the rank at this time. |
dimension |
|
|
Product Type |
product_type |
App | Bundle (iOS only). |
dimension |
|
|
Product URL |
product_url |
The URL for the app’s product page on the app store (iOS & GP only). |
dimension |
|
|
Promotional Text |
promotional_text |
The promotional text for an app (iOS only). |
dimension |
|
|
Publisher ID |
publisher_id |
Publisher ID. |
dimension |
|
|
Publisher Name |
publisher_name |
Publisher name. |
dimension |
|
|
Purchased Separately Price |
purchased_separately_price |
Price of purchasing all apps in the bundle separately (iOS only). |
metric |
|
|
Rating All Ratings |
rating.all_ratings |
All versions ratings. |
metric |
|
|
All Ratings Average |
rating.all_ratings.average |
Average rating of all versions. |
metric |
|
|
All Ratings Rating Count |
rating.all_ratings.rating_count |
Total rating count of all versions. |
metric |
|
|
All Ratings Star 1 Count |
rating.all_ratings.star_1_count |
1 stars rating count of all versions. |
metric |
|
|
All Ratings Star 2 Count |
rating.all_ratings.star_2_count |
2 stars rating count of all versions. |
metric |
|
|
All Ratings Star 3 Count |
rating.all_ratings.star_3_count |
3 stars rating count of all versions. |
metric |
|
|
All Ratings Star 4 Count |
rating.all_ratings.star_4_count |
4 stars rating count of all versions. |
metric |
|
|
All Ratings Star 5 Count |
rating.all_ratings.star_5_count |
5 stars rating count of all versions. |
metric |
|
|
Rating Country |
rating.coutry |
Country code. (null for google-play). |
dimension |
|
|
Rating Current Ratings |
rating.current_ratings |
Current version ratings. (only available for ios and mac, for other markets, it will be 'null'). |
metric |
|
|
Current Ratings Average |
rating.current_ratings.average |
Average rating of current version. |
metric |
|
|
Current Ratings Rating Count |
rating.current_ratings.rating_count |
Total rating count of current version. |
metric |
|
|
Current Ratings Star 1 Count |
rating.current_ratings.star_1_count |
1 stars rating count of current version. |
metric |
|
|
Current Ratings Star 2 Count |
rating.current_ratings.star_2_count |
2 stars rating count of current version. |
metric |
|
|
Current Ratings Star 3 Count |
rating.current_ratings.star_3_count |
3 stars rating count of current version. |
metric |
|
|
Current Ratings Star 4 Count |
rating.current_ratings.star_4_count |
4 stars rating count of current version. |
metric |
|
|
Current Ratings Star 5 Count |
rating.current_ratings.star_5_count |
5 stars rating count of current version. |
metric |
|
|
Release Date |
release_date |
Initial release date. |
dimension |
|
|
Required OS |
required_os |
The operating system requirements for an app (iOS & GP only). |
dimension |
|
|
Reviews Country |
reviews.country |
Country code. |
dimension |
|
|
Reviews Date |
reviews.date |
The date the review was added. |
dimension |
|
|
Reviews Device |
reviews.device |
The divice (this is for Google Play). |
dimension |
|
|
Reviews Language |
reviews.language |
The language of the review. This is available for both Google Play & Amazon. |
dimension |
|
|
Reviews Language Name |
reviews.language_name |
Localized language name (for Google play only). |
dimension |
|
|
Reviews Rating |
reviews.rating |
The star rating that was given with the review. |
metric |
|
|
Reviews Text |
reviews.text |
The text of the review. |
dimension |
|
|
Reviews Title |
reviews.title |
The title of the review. |
dimension |
|
|
Reviews Version |
reviews.version |
The version of the product this review is for. Not available for Google Play |
dimension |
|
|
Sales List Country |
sales_list.country |
The country of the sales data. |
dimension |
|
|
Sales List Date |
sales_list.date |
The date of the sale. |
dimension |
|
|
Sales List Revenue IAP Promotions |
sales_list.revenue.iap.promotions |
The number of IAP's promotions. |
metric |
|
|
Sales List Revenue IAP Refunds |
sales_list.revenue.iap.refunds |
The number of IAP's refunds. |
metric |
|
|
Sales List Revenue IAP Sales |
sales_list.revenue.iap.sales |
The number of IAP's sales. |
metric |
|
|
Sales List Revenue Product Downloads |
sales_list.revenue.product.downloads |
The revenue of product's downloads. |
metric |
|
|
Sales List Revenue Product Net Downloads |
sales_list.revenue.product.net_downloads |
The revenue of product's net downloads. |
metric |
|
|
Sales List Revenue Product Promotions |
sales_list.revenue.product.promotions |
The revenue of product's promotions. |
metric |
|
|
Sales List Revenue Product Refunds |
sales_list.revenue.product.refunds |
The revenue of product's refunds. |
metric |
|
|
Sales List Revenue Product Trial Upgrade Revenue. |
sales_list.revenue.product.trial_upgrade_revenue |
The revenue of product's trial upgrades. |
metric |
|
|
Sales List Revenue Product Updates |
sales_list.revenue.product.updates |
The revenue of product's updates. |
metric |
|
|
Sales List Units IAP Promotions |
sales_list.units.iap.promotions |
The number of IAP's promotions. |
metric |
|
|
Sales List Units IAP Refunds |
sales_list.units.iap.refunds |
The number of IAP's refunds. |
metric |
|
|
Sales List Units IAP Sales |
sales_list.units.iap.sales |
The number of IAP's sales. |
metric |
|
|
Sales List Units Product Beta Units |
sales_list.units.product.beta_units |
The number of product's beta units |
metric |
|
|
Sales List Units Product Borrowed Downloads |
sales_list.units.product.borrowed_downloads |
The number of the product's borrowed downloads. |
metric |
|
|
Sales List Units Product Downloads |
sales_list.units.product.downloads |
The number of product's downloads. |
metric |
|
|
Sales List Units Product Free Downloads |
sales_list.units.product.free_downloads |
The number of product's free downloads |
metric |
|
|
Sales List Units Product Net Downloads |
sales_list.units.product.net_downloads |
The number of product's net downloads |
metric |
|
|
Sales List Units Product Promotions |
sales_list.units.product.promotions |
The number of product's promotions. |
metric |
|
|
Sales List Units Product Refunds |
sales_list.units.product.refunds |
The number of product's refunds. |
metric |
|
|
Sales List Units Product Trial Units |
sales_list.units.product.trial_units |
The number of product's trial units |
metric |
|
|
Sales List Units Product Updates |
sales_list.units.product.updates |
The number of product's updates. |
metric |
|
|
Seller |
seller |
Product Seller. Can be different from publisher (iOS only). |
dimension |
|
|
Size |
size |
File Size. |
dimension |
|
|
Subtitle |
subtitle |
The subtitle for an app (iOS only). |
dimension |
|
|
Support URL |
support_url |
The support URL for an app as listed by the publisher (iOS & GP only). |
dimension |
|
|
Supports iMessage |
supports_imessage |
The indicator for whether or not the app supports an iMessage version of the app - T | F | iMessage only (iOS only). |
dimension |
|
|
Unified Category Path |
unified_category_path |
Unified category path. |
dimension |
|
|
Unified Product ID |
unified_product_id |
ID of the unified app of the app. |
dimension |
|
|
Unified Product Name |
unified_product_name |
Name of the unified app of the app. |
dimension |
|
|
Unpublished |
unpublished |
'True' if the app has been removed from the app store. |
dimension |
|
|
Update Time |
update_time |
The date of the data has been updated (local time, group by country). |
dimension |
|
|
Vertical |
vertical |
Apps. |
dimension |
|
|
Whats New |
whats_new |
The current what’s new section for an app that updates with each update (iOS & GP only). |
dimension |
|
