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