Apple Search Ads data warehouse table groups

  • Updated on Oct 6, 2025
  • Published on Aug 5, 2025
Prev Next

Table: ADGROUP

ad_channel_type
Display name Ad channel type
Description The channel type of ads used in a campaign
Field type dimension
Data type string.text.value
ad_group_id
Display name Ad group ID
Field type dimension
Data type string.text.value
ad_group_name
Display name Ad group name
Field type dimension
Data type string.text.value
ad_group_serving_state_reasons
Display name Ad group serving state reasons
Field type dimension
Data type string.text.value
ad_group_serving_status
Display name Ad group serving status
Field type dimension
Data type string.text.value
ad_group_status
Display name Ad group status
Field type dimension
Data type string.text.value
app_advisories
Display name Advisories
Description App advisories
Field type dimension
Data type string.text.value
app_artwork_512_url
Display name App logo 512px URL
Description URL of the 512 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_60_url
Display name App logo 60px URL
Description URL of the 60 pixel logo of the app
Field type dimension
Data type string.text.url
app_average_rating
Display name Average user rating
Description Average rating given by users for the app
Field type dimension
Data type float.number.value
app_average_rating_current_version
Display name Average user rating (current version)
Description Average rating given by users for the current version of the app
Field type dimension
Data type float.number.value
app_categories
Display name Categories
Description All categories of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_content_advisory_rating
Display name Age rating
Description App age rating
Field type dimension
Data type string.text.value
app_currency
Display name App price currency
Description Currency of the app price
Field type dimension
Data type string.currency.code
app_current_version_release_date
Display name Current version release date
Description Release date of the latest version of the app
Field type dimension
Data type string.time.date
app_description
Display name Description
Description Description of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_file_size_mb
Display name File size (mb)
Description App file size in megabytes
Field type dimension
Data type float.number.value
app_formatted_price
Display name App price
Description Price of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_id
Display name App ID
Description ID of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_is_game_center_enabled
Display name Is Game Center enabled
Field type dimension
Data type bool
app_language_codes
Display name Language codes
Description Languages supported by the app
Field type dimension
Data type string.text.value
app_minimum_os_version
Display name Minimum OS version
Description Minimum operating system version required by the app promoted by the campaign
Field type dimension
Data type string.text.value
app_name
Display name App name
Description Name of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_primary_category
Display name Primary category
Description Primary category of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_rating_count
Display name User rating count
Description Number of ratings given by users for the app
Field type dimension
Data type int.number.value
app_rating_count_current_version
Display name User rating count (current version)
Description Number of ratings given by users for the current version the app
Field type dimension
Data type int.number.value
app_release_date
Display name Release date
Description App release date
Field type dimension
Data type string.time.date
app_release_notes
Display name Release notes
Description Release notes of the latest version of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_screenshot_1_url
Display name Screenshot #1 URL
Description URL of the 1st screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_2_url
Display name Screenshot #2 URL
Description URL of the 2nd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_3_url
Display name Screenshot #3 URL
Description URL of the 3rd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_4_url
Display name Screenshot #4 URL
Description URL of the 4th screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_supported_devices
Display name Supported devices
Description List of devices that app supports
Field type dimension
Data type string.text.value
app_version
Display name Current version
Description Current version of the app promoted by the campaign
Field type dimension
Data type string.text.value
automated_keywords_opt_in
Display name Automated keywords opt-in
Field type dimension
Data type bool
campaign_id
Display name Campaign ID
Field type dimension
Data type string.text.value
campaign_name
Display name Campaign name
Field type dimension
Data type string.text.value
campaign_status
Display name Campaign status
Field type dimension
Data type string.text.value
cost
Display name Cost
Description The total spend of a campaign in the currency used in the campaign
Field type metric
Data type float.currency.value
countries_or_regions
Display name Campaign countries or regions
Description List of all App Store countries or regions in which you want to promote your app
Field type dimension
Data type string.text.json
countries_or_regions_serving_state_reasons
Display name Campaign countries or regions serving status reasons
Description When a campaign is not running, a list of reasons will be returned
Field type dimension
Data type string.text.value
currency
Display name Currency
Description The campaign currency
Field type dimension
Data type string.currency.code
daily_budget
Display name Campaign daily budget
Description Daily budget of the campaign in the account currency, if set
Field type dimension
Data type float.currency.value
dataSourceName
Display name Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
date
Display name Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
device_class
Display name Device type
Description The type of devices that the promoted application supports
Field type dimension
Data type string.text.value
display_status
Display name Campaign display status
Description Whether campaign is RUNNING, ON_HOLD, PAUSED or DELETED
Field type dimension
Data type string.text.value
impressions
Display name Impressions
Description The number of times your ad appeared in App Store search results within the reporting time period
Field type metric
Data type int.number.value
installs
Display name Installs
Description The total number of newDownloads or redownloads resulting from an ad within the reporting period. Search Ads installs are attributed within a 30‑day tap-through window
Field type metric
Data type int.number.value
latOffInstalls
Display name Non-Limit Ad Tracking installs
Description The installs from users who have not enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
latOnInstalls
Display name Limit Ad Tracking installs
Description The installs from users who have enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
modification_time
Display name Campaign modification time
Field type dimension
Data type string.time.datetime
newDownloads
Display name New downloads
Description The enumerated app downloads from new users who have never before installed your app
Field type metric
Data type int.number.value
profile_id
Display name Account ID
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
profile_name
Display name Account name
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
redownloads
Display name Re-downloads
Description The enumerated re-installs from users who have previously installed your app
Field type metric
Data type int.number.value
serving_state_reasons
Display name Campaign serving status reasons
Description When a campaign is not running, a list of reasons will be returned
Field type dimension
Data type string.text.value
serving_status
Display name Campaign serving status
Description Whether the campaign/ad group is actually serving or not
Field type dimension
Data type string.text.value
supply_sources
Display name Campaign supply sources
Description The supply source of ads used in a campaign
Field type dimension
Data type string.text.value
taps
Display name Taps
Description The number of times your ad was tapped by users within the reporting time period
Field type metric
Data type int.number.value
total_budget
Display name Campaign total budget
Description Total budget of the campaign in the account currency
Field type dimension
Data type float.currency.value

Table: CREATIVE

ad_format
Display name Ad format
Field type dimension
Data type string.text.value
app_advisories
Display name Advisories
Description App advisories
Field type dimension
Data type string.text.value
app_artwork_512_url
Display name App logo 512px URL
Description URL of the 512 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_60_url
Display name App logo 60px URL
Description URL of the 60 pixel logo of the app
Field type dimension
Data type string.text.url
app_average_rating
Display name Average user rating
Description Average rating given by users for the app
Field type dimension
Data type float.number.value
app_average_rating_current_version
Display name Average user rating (current version)
Description Average rating given by users for the current version of the app
Field type dimension
Data type float.number.value
app_categories
Display name Categories
Description All categories of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_content_advisory_rating
Display name Age rating
Description App age rating
Field type dimension
Data type string.text.value
app_currency
Display name App price currency
Description Currency of the app price
Field type dimension
Data type string.currency.code
app_current_version_release_date
Display name Current version release date
Description Release date of the latest version of the app
Field type dimension
Data type string.time.date
app_description
Display name Description
Description Description of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_file_size_mb
Display name File size (mb)
Description App file size in megabytes
Field type dimension
Data type float.number.value
app_formatted_price
Display name App price
Description Price of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_id
Display name App ID
Description ID of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_is_game_center_enabled
Display name Is Game Center enabled
Field type dimension
Data type bool
app_language_codes
Display name Language codes
Description Languages supported by the app
Field type dimension
Data type string.text.value
app_minimum_os_version
Display name Minimum OS version
Description Minimum operating system version required by the app promoted by the campaign
Field type dimension
Data type string.text.value
app_name
Display name App name
Description Name of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_primary_category
Display name Primary category
Description Primary category of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_rating_count
Display name User rating count
Description Number of ratings given by users for the app
Field type dimension
Data type int.number.value
app_rating_count_current_version
Display name User rating count (current version)
Description Number of ratings given by users for the current version the app
Field type dimension
Data type int.number.value
app_release_date
Display name Release date
Description App release date
Field type dimension
Data type string.time.date
app_release_notes
Display name Release notes
Description Release notes of the latest version of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_screenshot_1_url
Display name Screenshot #1 URL
Description URL of the 1st screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_2_url
Display name Screenshot #2 URL
Description URL of the 2nd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_3_url
Display name Screenshot #3 URL
Description URL of the 3rd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_4_url
Display name Screenshot #4 URL
Description URL of the 4th screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_supported_devices
Display name Supported devices
Description List of devices that app supports
Field type dimension
Data type string.text.value
app_version
Display name Current version
Description Current version of the app promoted by the campaign
Field type dimension
Data type string.text.value
campaign_id
Display name Campaign ID
Field type dimension
Data type string.text.value
campaign_name
Display name Campaign name
Field type dimension
Data type string.text.value
cost
Display name Cost
Description The total spend of a campaign in the currency used in the campaign
Field type metric
Data type float.currency.value
creative_set_display_status
Display name Creative set display status
Field type dimension
Data type string.text.value
creative_set_id
Display name Creative set ID
Field type dimension
Data type string.text.value
creative_set_language_display_name
Display name Creative set language display name
Field type dimension
Data type string.text.value
creative_set_name
Display name Creative set name
Field type dimension
Data type string.text.value
creative_set_status
Display name Creative set status
Field type dimension
Data type string.text.value
dataSourceName
Display name Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
date
Display name Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
impressions
Display name Impressions
Description The number of times your ad appeared in App Store search results within the reporting time period
Field type metric
Data type int.number.value
installs
Display name Installs
Description The total number of newDownloads or redownloads resulting from an ad within the reporting period. Search Ads installs are attributed within a 30‑day tap-through window
Field type metric
Data type int.number.value
latOffInstalls
Display name Non-Limit Ad Tracking installs
Description The installs from users who have not enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
latOnInstalls
Display name Limit Ad Tracking installs
Description The installs from users who have enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
newDownloads
Display name New downloads
Description The enumerated app downloads from new users who have never before installed your app
Field type metric
Data type int.number.value
profile_id
Display name Account ID
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
profile_name
Display name Account name
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
redownloads
Display name Re-downloads
Description The enumerated re-installs from users who have previously installed your app
Field type metric
Data type int.number.value
taps
Display name Taps
Description The number of times your ad was tapped by users within the reporting time period
Field type metric
Data type int.number.value

Table: GEO

ad_group_id
Display name Ad group ID
Field type dimension
Data type string.text.value
ad_group_name
Display name Ad group name
Field type dimension
Data type string.text.value
admin_area
Display name Admin area
Description The adminArea dimension is a group of States or the equivalent according to its associated country
Field type dimension
Data type string.text.value
app_advisories
Display name Advisories
Description App advisories
Field type dimension
Data type string.text.value
app_artwork_512_url
Display name App logo 512px URL
Description URL of the 512 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_60_url
Display name App logo 60px URL
Description URL of the 60 pixel logo of the app
Field type dimension
Data type string.text.url
app_average_rating
Display name Average user rating
Description Average rating given by users for the app
Field type dimension
Data type float.number.value
app_average_rating_current_version
Display name Average user rating (current version)
Description Average rating given by users for the current version of the app
Field type dimension
Data type float.number.value
app_categories
Display name Categories
Description All categories of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_content_advisory_rating
Display name Age rating
Description App age rating
Field type dimension
Data type string.text.value
app_currency
Display name App price currency
Description Currency of the app price
Field type dimension
Data type string.currency.code
app_current_version_release_date
Display name Current version release date
Description Release date of the latest version of the app
Field type dimension
Data type string.time.date
app_description
Display name Description
Description Description of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_file_size_mb
Display name File size (mb)
Description App file size in megabytes
Field type dimension
Data type float.number.value
app_formatted_price
Display name App price
Description Price of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_id
Display name App ID
Description ID of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_is_game_center_enabled
Display name Is Game Center enabled
Field type dimension
Data type bool
app_language_codes
Display name Language codes
Description Languages supported by the app
Field type dimension
Data type string.text.value
app_minimum_os_version
Display name Minimum OS version
Description Minimum operating system version required by the app promoted by the campaign
Field type dimension
Data type string.text.value
app_name
Display name App name
Description Name of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_primary_category
Display name Primary category
Description Primary category of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_rating_count
Display name User rating count
Description Number of ratings given by users for the app
Field type dimension
Data type int.number.value
app_rating_count_current_version
Display name User rating count (current version)
Description Number of ratings given by users for the current version the app
Field type dimension
Data type int.number.value
app_release_date
Display name Release date
Description App release date
Field type dimension
Data type string.time.date
app_release_notes
Display name Release notes
Description Release notes of the latest version of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_screenshot_1_url
Display name Screenshot #1 URL
Description URL of the 1st screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_2_url
Display name Screenshot #2 URL
Description URL of the 2nd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_3_url
Display name Screenshot #3 URL
Description URL of the 3rd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_4_url
Display name Screenshot #4 URL
Description URL of the 4th screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_supported_devices
Display name Supported devices
Description List of devices that app supports
Field type dimension
Data type string.text.value
app_version
Display name Current version
Description Current version of the app promoted by the campaign
Field type dimension
Data type string.text.value
campaign_id
Display name Campaign ID
Field type dimension
Data type string.text.value
campaign_name
Display name Campaign name
Field type dimension
Data type string.text.value
cost
Display name Cost
Description The total spend of a campaign in the currency used in the campaign
Field type metric
Data type float.currency.value
country_code
Display name User country
Description Country where the campaign ads are served in
Field type dimension
Data type string.geo.country.twolettercode
dataSourceName
Display name Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
date
Display name Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
device_class
Display name Device type
Description The type of devices that the promoted application supports
Field type dimension
Data type string.text.value
impressions
Display name Impressions
Description The number of times your ad appeared in App Store search results within the reporting time period
Field type metric
Data type int.number.value
installs
Display name Installs
Description The total number of newDownloads or redownloads resulting from an ad within the reporting period. Search Ads installs are attributed within a 30‑day tap-through window
Field type metric
Data type int.number.value
latOffInstalls
Display name Non-Limit Ad Tracking installs
Description The installs from users who have not enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
latOnInstalls
Display name Limit Ad Tracking installs
Description The installs from users who have enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
locality
Display name Locality
Description The locality dimension is the city or the equivalent according to its associated admin area
Field type dimension
Data type string.geo.country
newDownloads
Display name New downloads
Description The enumerated app downloads from new users who have never before installed your app
Field type metric
Data type int.number.value
profile_id
Display name Account ID
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
profile_name
Display name Account name
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
redownloads
Display name Re-downloads
Description The enumerated re-installs from users who have previously installed your app
Field type metric
Data type int.number.value
taps
Display name Taps
Description The number of times your ad was tapped by users within the reporting time period
Field type metric
Data type int.number.value

Table: SEARCH_TERM

ad_group_id
Display name Ad group ID
Field type dimension
Data type string.text.value
ad_group_name
Display name Ad group name
Field type dimension
Data type string.text.value
app_advisories
Display name Advisories
Description App advisories
Field type dimension
Data type string.text.value
app_artwork_512_url
Display name App logo 512px URL
Description URL of the 512 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_60_url
Display name App logo 60px URL
Description URL of the 60 pixel logo of the app
Field type dimension
Data type string.text.url
app_average_rating
Display name Average user rating
Description Average rating given by users for the app
Field type dimension
Data type float.number.value
app_average_rating_current_version
Display name Average user rating (current version)
Description Average rating given by users for the current version of the app
Field type dimension
Data type float.number.value
app_categories
Display name Categories
Description All categories of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_content_advisory_rating
Display name Age rating
Description App age rating
Field type dimension
Data type string.text.value
app_currency
Display name App price currency
Description Currency of the app price
Field type dimension
Data type string.currency.code
app_current_version_release_date
Display name Current version release date
Description Release date of the latest version of the app
Field type dimension
Data type string.time.date
app_description
Display name Description
Description Description of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_file_size_mb
Display name File size (mb)
Description App file size in megabytes
Field type dimension
Data type float.number.value
app_formatted_price
Display name App price
Description Price of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_id
Display name App ID
Description ID of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_is_game_center_enabled
Display name Is Game Center enabled
Field type dimension
Data type bool
app_language_codes
Display name Language codes
Description Languages supported by the app
Field type dimension
Data type string.text.value
app_minimum_os_version
Display name Minimum OS version
Description Minimum operating system version required by the app promoted by the campaign
Field type dimension
Data type string.text.value
app_name
Display name App name
Description Name of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_primary_category
Display name Primary category
Description Primary category of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_rating_count
Display name User rating count
Description Number of ratings given by users for the app
Field type dimension
Data type int.number.value
app_rating_count_current_version
Display name User rating count (current version)
Description Number of ratings given by users for the current version the app
Field type dimension
Data type int.number.value
app_release_date
Display name Release date
Description App release date
Field type dimension
Data type string.time.date
app_release_notes
Display name Release notes
Description Release notes of the latest version of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_screenshot_1_url
Display name Screenshot #1 URL
Description URL of the 1st screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_2_url
Display name Screenshot #2 URL
Description URL of the 2nd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_3_url
Display name Screenshot #3 URL
Description URL of the 3rd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_4_url
Display name Screenshot #4 URL
Description URL of the 4th screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_supported_devices
Display name Supported devices
Description List of devices that app supports
Field type dimension
Data type string.text.value
app_version
Display name Current version
Description Current version of the app promoted by the campaign
Field type dimension
Data type string.text.value
campaign_id
Display name Campaign ID
Field type dimension
Data type string.text.value
campaign_name
Display name Campaign name
Field type dimension
Data type string.text.value
campaign_status
Display name Campaign status
Field type dimension
Data type string.text.value
cost
Display name Cost
Description The total spend of a campaign in the currency used in the campaign
Field type metric
Data type float.currency.value
dataSourceName
Display name Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
date
Display name Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
impressions
Display name Impressions
Description The number of times your ad appeared in App Store search results within the reporting time period
Field type metric
Data type int.number.value
installs
Display name Installs
Description The total number of newDownloads or redownloads resulting from an ad within the reporting period. Search Ads installs are attributed within a 30‑day tap-through window
Field type metric
Data type int.number.value
latOffInstalls
Display name Non-Limit Ad Tracking installs
Description The installs from users who have not enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
latOnInstalls
Display name Limit Ad Tracking installs
Description The installs from users who have enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
match_type
Display name Match type
Field type dimension
Data type string.text.value
newDownloads
Display name New downloads
Description The enumerated app downloads from new users who have never before installed your app
Field type metric
Data type int.number.value
profile_id
Display name Account ID
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
profile_name
Display name Account name
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
redownloads
Display name Re-downloads
Description The enumerated re-installs from users who have previously installed your app
Field type metric
Data type int.number.value
search_term
Display name Search term
Field type dimension
Data type string.text.value
search_term_source
Display name Search term source
Field type dimension
Data type string.text.value
taps
Display name Taps
Description The number of times your ad was tapped by users within the reporting time period
Field type metric
Data type int.number.value

Table: KEYWORD

ad_group_id
Display name Ad group ID
Field type dimension
Data type string.text.value
ad_group_name
Display name Ad group name
Field type dimension
Data type string.text.value
app_advisories
Display name Advisories
Description App advisories
Field type dimension
Data type string.text.value
app_artwork_512_url
Display name App logo 512px URL
Description URL of the 512 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_60_url
Display name App logo 60px URL
Description URL of the 60 pixel logo of the app
Field type dimension
Data type string.text.url
app_average_rating
Display name Average user rating
Description Average rating given by users for the app
Field type dimension
Data type float.number.value
app_average_rating_current_version
Display name Average user rating (current version)
Description Average rating given by users for the current version of the app
Field type dimension
Data type float.number.value
app_categories
Display name Categories
Description All categories of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_content_advisory_rating
Display name Age rating
Description App age rating
Field type dimension
Data type string.text.value
app_currency
Display name App price currency
Description Currency of the app price
Field type dimension
Data type string.currency.code
app_current_version_release_date
Display name Current version release date
Description Release date of the latest version of the app
Field type dimension
Data type string.time.date
app_description
Display name Description
Description Description of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_file_size_mb
Display name File size (mb)
Description App file size in megabytes
Field type dimension
Data type float.number.value
app_formatted_price
Display name App price
Description Price of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_id
Display name App ID
Description ID of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_is_game_center_enabled
Display name Is Game Center enabled
Field type dimension
Data type bool
app_language_codes
Display name Language codes
Description Languages supported by the app
Field type dimension
Data type string.text.value
app_minimum_os_version
Display name Minimum OS version
Description Minimum operating system version required by the app promoted by the campaign
Field type dimension
Data type string.text.value
app_name
Display name App name
Description Name of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_primary_category
Display name Primary category
Description Primary category of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_rating_count
Display name User rating count
Description Number of ratings given by users for the app
Field type dimension
Data type int.number.value
app_rating_count_current_version
Display name User rating count (current version)
Description Number of ratings given by users for the current version the app
Field type dimension
Data type int.number.value
app_release_date
Display name Release date
Description App release date
Field type dimension
Data type string.time.date
app_release_notes
Display name Release notes
Description Release notes of the latest version of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_screenshot_1_url
Display name Screenshot #1 URL
Description URL of the 1st screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_2_url
Display name Screenshot #2 URL
Description URL of the 2nd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_3_url
Display name Screenshot #3 URL
Description URL of the 3rd screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_screenshot_4_url
Display name Screenshot #4 URL
Description URL of the 4th screenshot image of the app in the App Store
Field type dimension
Data type string.text.url
app_supported_devices
Display name Supported devices
Description List of devices that app supports
Field type dimension
Data type string.text.value
app_version
Display name Current version
Description Current version of the app promoted by the campaign
Field type dimension
Data type string.text.value
campaign_id
Display name Campaign ID
Field type dimension
Data type string.text.value
campaign_name
Display name Campaign name
Field type dimension
Data type string.text.value
cost
Display name Cost
Description The total spend of a campaign in the currency used in the campaign
Field type metric
Data type float.currency.value
dataSourceName
Display name Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
date
Display name Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
impressions
Display name Impressions
Description The number of times your ad appeared in App Store search results within the reporting time period
Field type metric
Data type int.number.value
installs
Display name Installs
Description The total number of newDownloads or redownloads resulting from an ad within the reporting period. Search Ads installs are attributed within a 30‑day tap-through window
Field type metric
Data type int.number.value
keyword
Display name Keyword
Field type dimension
Data type string.text.value
keyword_display_status
Display name Keyword display status
Field type dimension
Data type string.text.value
keyword_id
Display name Keyword ID
Field type dimension
Data type string.text.value
keyword_status
Display name Keyword status
Field type dimension
Data type string.text.value
latOffInstalls
Display name Non-Limit Ad Tracking installs
Description The installs from users who have not enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
latOnInstalls
Display name Limit Ad Tracking installs
Description The installs from users who have enabled Limit Ad Tracking (LAT) on their device. Please note that this field will be removed on 2024-12-19
Field type metric
Data type int.number.value
newDownloads
Display name New downloads
Description The enumerated app downloads from new users who have never before installed your app
Field type metric
Data type int.number.value
profile_id
Display name Account ID
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
profile_name
Display name Account name
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
redownloads
Display name Re-downloads
Description The enumerated re-installs from users who have previously installed your app
Field type metric
Data type int.number.value
taps
Display name Taps
Description The number of times your ad was tapped by users within the reporting time period
Field type metric
Data type int.number.value