Apple Search Ads Metrics and Dimensions

Field group
Field
Type
Data type
Description
PerformanceImpressions
METRIC
INTEGERThe number of times your ad appeared in App Store search results within the reporting time period
PerformanceTaps
METRIC
INTEGERThe number of times your ad was tapped by users within the reporting time period
PerformanceInstalls
METRIC
INTEGERThe 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
PerformanceTTR
METRIC
FLOATThe tap-through rate (TTR) is the number of times your ad was tapped by users divided by the total impressions your ad received
PerformanceAvg CPA
METRIC
CURRENCYThe average cost-per-acquisition (CPA) is the total spend divided by the number of installs received within a period
PerformanceAvg CPT
METRIC
CURRENCYThe CPT (Cost per tap) is treated by the API the same as CPC (Cost per click). The ratio is spend over taps
PerformanceAvg CPM
METRIC
CURRENCYAverage CPM
PerformanceAmount spent
METRIC
CURRENCYThe total spend of a campaign in the currency used in the campaign
PerformanceConversion rate
METRIC
RATIOThe total number of conversions received within a period, divided by total number of taps within the same period
Install TypeNew Downloads
METRIC
INTEGERNew Downloads
Install TypeRedownloads
METRIC
INTEGERRedownloads
Install TypeLimited Ad Tracking (LAT) On Installs
METRIC
INTEGERLAT On Installs
Install TypeLimited Ad Tracking (LAT) Off Installs
METRIC
INTEGERLAT Off Installs
TimeYear
DIMENSION
YEAREvents are broken down yearly
TimeYear month
DIMENSION
YEARMONTHEvents are broken down monthly
TimeYear month number
DIMENSION
YEAR_MONTH_NUMBEREvents are broken down monthly
TimeMonth
DIMENSION
MONTHNAMEEvents are broken down monthly
TimeMonth Number
DIMENSION
MONTHEvents are broken down monthly
TimeWeek number(sun-sat)
DIMENSION
WEEK_NUMBEREvents are broken down weekly
TimeWeek number(mon-sun)
DIMENSION
WEEK_ISO_NUMBEREvents are broken down ISO weekly
TimeWeek start date(sun - sat)
DIMENSION
WEEK_START_DATEStart date of the week.
TimeWeek start date(mon - sun)
DIMENSION
WEEK_ISO_START_DATEStart date of the ISO week.
TimeDate
DIMENSION
DATEThe date of the event
AccountAccount ID
DIMENSION
STRINGID of the Apple Search Ads account
AccountAccount name
DIMENSION
STRINGName of the Apple Search Ads account
AccountAccount currency
DIMENSION
STRINGCurrency of the Apple Search Ads account
CampaignCampaign ID
DIMENSION
STRINGID of the Apple Search Ads campaign
CampaignCampaign name
DIMENSION
STRINGName of the Apple Search Ads campaign
CampaignCampaign status
DIMENSION
STRINGStatus of the Apple Search Ads campaign
CampaignCampaign serving status
DIMENSION
STRINGServing status of the Apple Search Ads campaign
CampaignCampaign serving status reasons
DIMENSION
STRINGServing status reasons of the Apple Search Ads campaign
CampaignCampaign display status
DIMENSION
STRINGDisplay status of the Apple Search Ads campaign
CampaignCampaign countries or regions
DIMENSION
STRINGCountries or regions of the Apple Search Ads campaign
CampaignCampaign countries or regions serving state reasons
DIMENSION
STRINGCountries or regions serving state reasons of the Apple Search Ads campaign
CampaignCampaign ad channel type
DIMENSION
STRINGAd channel type of the Apple Search Ads campaign
CampaignCampaign supply sources
DIMENSION
STRINGSupply sources of the Apple Search Ads campaign
CampaignCampaign created date
DIMENSION
DATECreated date of the Apple Search Ads campaign
CampaignCampaign created date time
DIMENSION
DATETIMECreated datetime of the Apple Search Ads campaign
CampaignCampaign modified date
DIMENSION
DATEModified date of the Apple Search Ads campaign
CampaignCampaign modified date time
DIMENSION
DATETIMEModified datetime of the Apple Search Ads campaign
CampaignCampaign start date
DIMENSION
DATEStart date of the Apple Search Ads campaign
CampaignCampaign start date time
DIMENSION
DATETIMEStart datetime of the Apple Search Ads campaign
CampaignCampaign end date
DIMENSION
DATEEnd date of the Apple Search Ads campaign
CampaignCampaign end date time
DIMENSION
DATETIMEEnd datetime of the Apple Search Ads campaign
CampaignCampaign total budget
DIMENSION
FLOATTotal budget of the Apple Search Ads campaign
CampaignCampaign daily budget
DIMENSION
FLOATDaily budget of the Apple Search Ads campaign
CampaignApp ID
DIMENSION
STRINGApp ID used in the Apple Search Ads campaign
Ad GroupAd group ID
DIMENSION
STRINGID of the Apple Search Ads ad group
Ad GroupAd group name
DIMENSION
STRINGName of the Apple Search Ads ad group
Ad GroupAd group status
DIMENSION
STRINGStatus of the Apple Search Ads ad group
Ad GroupAd group serving status
DIMENSION
STRINGServing status of the Apple Search Ads ad group
Ad GroupAd group serving state reasons
DIMENSION
STRINGServing state reasons of the Apple Search Ads ad group
Ad GroupAd group display status
DIMENSION
STRINGDisplay status of the Apple Search Ads ad group
Ad GroupAd group deleted
DIMENSION
BOOLEANDeleted status of the Apple Search Ads ad group
Ad GroupAd group default bid amount
DIMENSION
STRINGDefault bid amount of the Apple Search Ads ad group
Ad GroupAd group creation date time
DIMENSION
DATETIMECreation time of the Apple Search Ads ad group
Ad GroupAd group creation date
DIMENSION
DATECreation time of the Apple Search Ads ad group
Ad GroupAd group modification date time
DIMENSION
DATETIMEModification time of the Apple Search Ads ad group
Ad GroupAd group modification date
DIMENSION
DATEModification time of the Apple Search Ads ad group
Ad GroupAd group start date time
DIMENSION
DATETIMEStart time of the Apple Search Ads ad group
Ad GroupAd group start date
DIMENSION
DATEStart time of the Apple Search Ads ad group
Ad GroupAd group end date time
DIMENSION
DATETIMEEnd time of the Apple Search Ads ad group
Ad GroupAd group end date
DIMENSION
DATEEnd time of the Apple Search Ads ad group
Ad GroupAd group automated keywords opt in
DIMENSION
STRINGAutomated keywords opt in of the Apple Search Ads ad group
AdAd ID
DIMENSION
STRINGID of the Apple Search Ads ad
AdAd language
DIMENSION
STRINGLanguage of the Apple Search Ads ad
AdCreative ID
DIMENSION
STRINGID of the Apple Search Ads creative
AdAd name
DIMENSION
STRINGName of the Apple Search Ads ad
AdCreative type
DIMENSION
STRINGThe type of creative. Values are CUSTOM_PRODUCT_PAGE, CREATIVE_SET
AdAd status
DIMENSION
STRINGStatus of the Apple Search Ads ad
AdAd display status
DIMENSION
STRINGThe indicator of the status of an ad assignment with an ad group
AdAd display state reasons
DIMENSION
STRINGReasons provided when an ad isn’t running
AdIs ad deleted
DIMENSION
BOOLEANIndicates whether the ad has been deleted or not. Values are TRUE, FALSE
AdAd creation date
DIMENSION
DATEThe date the ad was created
AdAd creation time
DIMENSION
DATETIMEThe date and time the ad was created
AdAd modification date
DIMENSION
DATEThe date of the most recent modification of the ad
AdAd modification time
DIMENSION
DATETIMEThe date and time of the most recent modification of the ad
KeywordKeyword
DIMENSION
STRINGThe keyword text
KeywordKeyword ID
DIMENSION
STRINGThe keyword ID
KeywordKeyword display status
DIMENSION
STRINGThe indicator of the status of a keyword assignment with an ad group
KeywordKeyword bid amount
DIMENSION
FLOATThe bid amount for the keyword
Search TermSearch term
DIMENSION
STRINGThe search term text
Search TermSearch term source
DIMENSION
STRINGThe source of the search term. Values are AUTOMATIC or MANUAL
Search TermMatch type
DIMENSION
STRINGThe match type of the search term