Documentation Index

Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

Apple Search Ads metrics and dimensions

  • Updated on Mar 5, 2026
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your Apple Search Ads data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

17 metrics119 dimensions

ACCOUNT

profile_name
Field label Account name
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
profile_id
Field label Account ID
Description Name of the Apple Search Ads account
Field type dimension
Data type string.text.value
currency
Field label Currency
Description The campaign currency
Field type dimension
Data type string.currency.code

AD

ad_id
Field label Ad ID
Description Unique identifier representing the assignment relationship between an Ad Group and a Creative
Field type dimension
Data type string.text.value
ad_language
Field label Ad language
Description The language used in the ad text
Field type dimension
Data type string.text.value
creative_id
Field label Creative ID
Description Unique identifier for a creative
Field type dimension
Data type string.text.value
ad_name
Field label Ad name
Description A unique name of the ad assigned to an ad group
Field type dimension
Data type string.text.value
creative_type
Field label Creative type
Description The type of creative. Values are CUSTOM_PRODUCT_PAGE, CREATIVE_SET
Field type dimension
Data type string.text.value
ad_status
Field label Ad status
Description The status of the ad
Field type dimension
Data type string.text.value
ad_display_status
Field label Ad display status
Description The indicator of the status of an ad assignment with an ad group
Field type dimension
Data type string.text.value
ad_serving_state_reasons
Field label Ad display state reasons
Description Reasons provided when an ad isn’t running
Field type dimension
Data type string.text.value
ad_is_deleted
Field label Is ad deleted
Description Indicates whether the ad has been deleted or not. Values are TRUE, FALSE
Field type dimension
Data type bool
ad_creation_date
Field label Ad creation date
Description The date the ad was created
Field type dimension
Data type string.time.date
ad_creation_time
Field label Ad creation time
Description The date and time the ad was created
Field type dimension
Data type string.time.datetime
ad_modification_date
Field label Ad modification date
Description The date of the most recent modification of the ad
Field type dimension
Data type string.time.date
ad_modification_time
Field label Ad modification time
Description The date and time of the most recent modification of the ad
Field type dimension
Data type string.time.datetime

AD GROUP

ad_group_name
Field label Ad group name
Field type dimension
Data type string.text.value
ad_group_id
Field label Ad group ID
Field type dimension
Data type string.text.value
ad_group_status
Field label Ad group status
Field type dimension
Data type string.text.value
ad_group_serving_status
Field label Ad group serving status
Field type dimension
Data type string.text.value
ad_group_serving_state_reasons
Field label Ad group serving state reasons
Field type dimension
Data type string.text.value
automated_keywords_opt_in
Field label Automated keywords opt-in
Field type dimension
Data type bool

APP

app_name
Field label App name
Description Name of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_id
Field label App ID
Description ID of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_primary_category
Field label Primary category
Description Primary category of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_categories
Field label Categories
Description All categories of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_description
Field label Description
Description Description of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_formatted_price
Field label App price
Description Price of the app promoted by the campaign
Field type dimension
Data type string.text.value
app_currency
Field label App price currency
Description Currency of the app price
Field type dimension
Data type string.currency.code
app_supported_devices
Field label Supported devices
Description List of devices that app supports
Field type dimension
Data type string.text.value
app_content_advisory_rating
Field label Age rating
Description App age rating
Field type dimension
Data type string.text.value
app_advisories
Field label Advisories
Description App advisories
Field type dimension
Data type string.text.value
app_language_codes
Field label Language codes
Description Languages supported by the app
Field type dimension
Data type string.text.value
app_minimum_os_version
Field label 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_file_size_mb
Field label File size (mb)
Description App file size in megabytes
Field type dimension
Data type float.number.value
app_is_game_center_enabled
Field label Is Game Center enabled
Field type dimension
Data type bool
app_average_rating
Field label Average user rating
Description Average rating given by users for the app
Field type dimension
Data type float.number.value
app_rating_count
Field label User rating count
Description Number of ratings given by users for the app
Field type dimension
Data type int.number.value
app_average_rating_current_version
Field label 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_rating_count_current_version
Field label 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
Field label Release date
Description App release date
Field type dimension
Data type string.time.date
app_current_version_release_date
Field label Current version release date
Description Release date of the latest version of the app
Field type dimension
Data type string.time.date
app_release_notes
Field label 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_version
Field label Current version
Description Current version of the app promoted by the campaign
Field type dimension
Data type string.text.value

APP IMAGES

app_artwork_60_url
Field label App logo 60px URL
Description URL of the 60 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_60_image
Field label App logo 60px
Description The 60 pixel logo of the app
Field type dimension
Data type string.text.formula
Destinations Google Sheets
app_artwork_512_url
Field label App logo 512px URL
Description URL of the 512 pixel logo of the app
Field type dimension
Data type string.text.url
app_artwork_512_image
Field label App logo 512px
Description The 512 pixel logo of the app
Field type dimension
Data type string.text.formula
Destinations Google Sheets
app_screenshot_1_url
Field label 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_1_image
Field label Screenshot #1
Description 1st screenshot image of the app in the App Store
Field type dimension
Data type string.text.formula
Destinations Google Sheets
app_screenshot_2_url
Field label 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_2_image
Field label Screenshot #2
Description 2nd screenshot image of the app in the App Store
Field type dimension
Data type string.text.formula
Destinations Google Sheets
app_screenshot_3_url
Field label 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_3_image
Field label Screenshot #3
Description 3rd screenshot image of the app in the App Store
Field type dimension
Data type string.text.formula
Destinations Google Sheets
app_screenshot_4_url
Field label 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_screenshot_4_image
Field label Screenshot #4
Description 4th screenshot image of the app in the App Store
Field type dimension
Data type string.text.formula
Destinations Google Sheets

BASIC

impressions
Field label 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
taps
Field label 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
installs
Field label 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
total_installs
Field label Total installs
Description The total number of tap-through and view-through new downloads and redownloads within the reporting period
Field type metric
Data type int.number.value
view_installs
Field label View installs
Description The total number of new downloads and redownloads from people who viewed your ad, but didn’t tap it, within a 1-day attribution window
Field type metric
Data type int.number.value
cost
Field label Cost
Description The total spend of a campaign in the currency used in the campaign
Field type metric
Data type float.currency.value
cost_eur
Field label Cost (EUR)
Description The total spend of a campaign converted to euros
Field type metric
Data type float.currency.value
Services Currency conversion
cost_usd
Field label Cost (USD)
Description The total spend of a campaign converted to US dollars
Field type metric
Data type float.currency.value
Services Currency conversion
cost_gbp
Field label Cost (GBP)
Description The total spend of a campaign converted to British pounds
Field type metric
Data type float.currency.value
Services Currency conversion
ttr
Field label Tap-through rate
Description The tap-through rate (TTR) is the number of times your ad was tapped by users divided by the total impressions your ad received
Field type metric
Data type float.number.ratio
conversion_rate
Field label Conversion rate
Description The total number of conversions received within a period, divided by total number of taps within the same period
Field type metric
Data type float.number.ratio
cpc
Field label Cost per tap
Description The CPT (Cost per tap) is treated by the API the same as CPC (Cost per click). The ratio is spend over taps
Field type metric
Data type float.currency.value
cpa
Field label Cost per acquisition
Description The average cost-per-acquisition (CPA) is the total spend divided by the number of installs received within a period
Field type metric
Data type float.currency.value

CAMPAIGN

campaign_name
Field label Campaign name
Field type dimension
Data type string.text.value
campaign_id
Field label Campaign ID
Field type dimension
Data type string.text.value
campaign_status
Field label Campaign status
Field type dimension
Data type string.text.value
serving_status
Field label Campaign serving status
Description Whether the campaign/ad group is actually serving or not
Field type dimension
Data type string.text.value
serving_state_reasons
Field label 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
display_status
Field label Campaign display status
Description Whether campaign is RUNNING, ON_HOLD, PAUSED or DELETED
Field type dimension
Data type string.text.value
countries_or_regions
Field label 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
Field label 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
ad_channel_type
Field label Ad channel type
Description The channel type of ads used in a campaign
Field type dimension
Data type string.text.value
supply_sources
Field label Campaign supply sources
Description The supply source of ads used in a campaign
Field type dimension
Data type string.text.value
modification_date
Field label Campaign modification date
Field type dimension
Data type string.time.datetime
modification_time
Field label Campaign modification time
Field type dimension
Data type string.time.datetime
total_budget
Field label Campaign total budget
Description Total budget of the campaign in the account currency
Field type dimension
Data type float.currency.value
daily_budget
Field label Campaign daily budget
Description Daily budget of the campaign in the account currency, if set
Field type dimension
Data type float.currency.value

CREATIVE SET

creative_set_name
Field label Creative set name
Field type dimension
Data type string.text.value
creative_set_id
Field label Creative set ID
Field type dimension
Data type string.text.value
creative_set_display_status
Field label Creative set display status
Field type dimension
Data type string.text.value
creative_set_status
Field label Creative set status
Field type dimension
Data type string.text.value
creative_set_language_display_name
Field label Creative set language display name
Field type dimension
Data type string.text.value
ad_format
Field label Ad format
Field type dimension
Data type string.text.value

DATASOURCE

dataSourceName
Field label 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
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

DEPRECATED

latOffInstalls
Field label Non-Limit Ad Tracking installs
Description The installs from users who have not enabled Limit Ad Tracking (LAT) on their device.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-12-19
latOnInstalls
Field label Limit Ad Tracking installs
Description The installs from users who have enabled Limit Ad Tracking (LAT) on their device.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-12-19

DEVICE

device_class
Field label Device type
Description The type of devices that the promoted application supports
Field type dimension
Data type string.text.value

GEO

country_or_region
Field label App Store country
Description The App Store country or region where you are promoting your app
Field type dimension
Data type string.geo.country.twolettercode
country_code
Field label User country
Description Country where the campaign ads are served in
Field type dimension
Data type string.geo.country.twolettercode
admin_area
Field label 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
locality
Field label 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

INSTALL TYPE

newDownloads
Field label 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
redownloads
Field label Re-downloads
Description The enumerated re-installs from users who have previously installed your app
Field type metric
Data type int.number.value

KEYWORD

keyword
Field label Keyword
Field type dimension
Data type string.text.value
keyword_id
Field label Keyword ID
Field type dimension
Data type string.text.value
keyword_status
Field label Keyword status
Field type dimension
Data type string.text.value
keyword_display_status
Field label Keyword display status
Field type dimension
Data type string.text.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json
system_metadata.query_excluded_accounts
Field label Excluded invalid accounts
Description A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting
Field type dimension
Data type string.text.json

SEARCH TERM

search_term
Field label Search term
Field type dimension
Data type string.text.value
search_term_source
Field label Search term source
Field type dimension
Data type string.text.value
match_type
Field label Match type
Field type dimension
Data type string.text.value

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
year
Field label Year
Description Year, e.g. 2017
Field type dimension
Data type string.time.year
yearOfWeek
Field label Year of week (Sun-Sat)
Description Year of week for US-style Sunday-Saturday weeks, e.g. 2017
Field type dimension
Data type string.time.year
yearOfWeekIso
Field label Year of week (Mon-Sun)
Description Year of week for ISO standard Monday-Sunday weeks, e.g. 2017
Field type dimension
Data type string.time.year
yearMonth
Field label Year & month
Description Year and month, e.g. 2017|06
Field type dimension
Data type string.time.yearmonth
month
Field label Month
Description Month, e.g. 6
Field type dimension
Data type string.time.month
yearWeek
Field label Year & week (Sun-Sat)
Description Year and week for US-style Sunday-Saturday weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweek
yearWeekIso
Field label Year & week (Mon-Sun)
Description Year and week for ISO standard Monday-Sunday weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweekiso
week
Field label Week (Sun-Sat)
Description US week number, e.g. 51
Field type dimension
Data type string.time.week
weekIso
Field label Week (Mon-Sun)
Description ISO week number, e.g. 51
Field type dimension
Data type string.time.weekiso
dayOfMonth
Field label Day of month
Description Day of month, e.g. 2
Field type dimension
Data type string.time.dayofmonth
dayOfWeekName
Field label Day of week (Sun-Sat)
Description Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday
Field type dimension
Data type string.time.dayofweek
dayOfWeekNameIso
Field label Day of week (Mon-Sun)
Description Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday
Field type dimension
Data type string.time.dayofweekiso
date
Field label Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
hour
Field label Hour
Description Hour in a 24-hour clock, e.g. 18
Field type dimension
Data type string.time.date

USER

gender
Field label Gender
Field type dimension
Data type string.person.gender
age_range
Field label Age range
Field type dimension
Data type string.person.age

© Supermetrics 2026