> ## Documentation Index
> Fetch the complete documentation index at: https://support.detrics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Search Ads Metrics & Dimensions

> Complete reference for Apple Search Ads dimensions and metrics

<Info>
  **Last updated:** July 17, 2026
</Info>

<div style={{display: "flex", gap: "8px", marginBottom: "20px"}}>
  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    42 dimensions
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    23 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Apple Search Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div style={{display: "flex", gap: "8px", marginBottom: "20px", alignItems: "center"}}>
  <span style={{fontSize: "14px", fontWeight: "500", color: "#6B7280"}}>Supported destinations:</span>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Google Sheets
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Claude
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Apple Search Ads data.

### Account

|                                                                                |                                                                                                                    |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Account Name</div> | Name of the Apple Search Ads account<br /><br />**Field Name:** `accountName`<br />**Type:** dimension             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Account ID</div>   | Unique identifier for the Apple Search Ads account<br /><br />**Field Name:** `accountId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Currency</div>     | Currency used by the account<br /><br />**Field Name:** `currency`<br />**Type:** dimension                        |

### Campaign

|                                                                                           |                                                                                                                                                        |
| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Name</div>           | Name of the campaign<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                                                                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign ID</div>             | Unique identifier for the campaign<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                                                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Status</div>         | Current status of the campaign (ENABLED, PAUSED)<br /><br />**Field Name:** `campaignStatus`<br />**Type:** dimension                                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Serving Status</div> | Serving status of the campaign<br /><br />**Field Name:** `campaignServingStatus`<br />**Type:** dimension                                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Display Status</div> | Display status of the campaign<br /><br />**Field Name:** `campaignDisplayStatus`<br />**Type:** dimension                                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Countries or Regions</div>    | Countries or regions targeted by the campaign<br /><br />**Field Name:** `countriesOrRegions`<br />**Type:** dimension                                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Channel Type</div>         | Ad channel type (SEARCH, DISPLAY)<br /><br />**Field Name:** `adChannelType`<br />**Type:** dimension                                                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Supply Sources</div>          | Supply sources for the campaign (APPSTORE\_SEARCH\_RESULTS, APPSTORE\_SEARCH\_TAB)<br /><br />**Field Name:** `supplySources`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Daily Budget</div>   | Daily budget amount for the campaign<br /><br />**Field Name:** `campaignDailyBudget`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Total Budget</div>   | Total budget amount for the campaign<br /><br />**Field Name:** `campaignTotalBudget`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Bidding Strategy</div>        | Bidding strategy type for the campaign<br /><br />**Field Name:** `biddingStrategy`<br />**Type:** dimension                                           |

### Ad Group

|                                                                                             |                                                                                                                                      |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Name</div>             | Name of the ad group<br /><br />**Field Name:** `adGroupName`<br />**Type:** dimension                                               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group ID</div>               | Unique identifier for the ad group<br /><br />**Field Name:** `adGroupId`<br />**Type:** dimension                                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Status</div>           | Current status of the ad group<br /><br />**Field Name:** `adGroupStatus`<br />**Type:** dimension                                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Serving Status</div>   | Serving status of the ad group<br /><br />**Field Name:** `adGroupServingStatus`<br />**Type:** dimension                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Automated Keywords Opt-In</div> | Whether automated keywords are enabled for the ad group<br /><br />**Field Name:** `automatedKeywordsOptIn`<br />**Type:** dimension |

### Ad

|                                                                                     |                                                                                                    |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad ID</div>             | Unique identifier for the ad<br /><br />**Field Name:** `adId`<br />**Type:** dimension            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Name</div>           | Name of the ad<br /><br />**Field Name:** `adName`<br />**Type:** dimension                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Creative Type</div>     | Type of creative used in the ad<br /><br />**Field Name:** `creativeType`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Status</div>         | Current status of the ad<br /><br />**Field Name:** `adStatus`<br />**Type:** dimension            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Display Status</div> | Display status of the ad<br /><br />**Field Name:** `adDisplayStatus`<br />**Type:** dimension     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Language</div>       | Language of the ad creative<br /><br />**Field Name:** `adLanguage`<br />**Type:** dimension       |

### Keyword

|                                                                                          |                                                                                                          |
| ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Keyword</div>                | The keyword text<br /><br />**Field Name:** `keyword`<br />**Type:** dimension                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Keyword ID</div>             | Unique identifier for the keyword<br /><br />**Field Name:** `keywordId`<br />**Type:** dimension        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Keyword Status</div>         | Current status of the keyword<br /><br />**Field Name:** `keywordStatus`<br />**Type:** dimension        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Keyword Display Status</div> | Display status of the keyword<br /><br />**Field Name:** `keywordDisplayStatus`<br />**Type:** dimension |

### Search Term

|                                                                                      |                                                                                                                                                            |
| ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Search Term Text</div>   | The actual search term that triggered the ad<br /><br />**Field Name:** `searchTermText`<br />**Type:** dimension                                          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Search Term Source</div> | Source of the search term (AUTO or TARGETED)<br /><br />**Field Name:** `searchTermSource`<br />**Type:** dimension                                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Match Type</div>         | Match type of the keyword (EXACT, BROAD, or AUTO for Search Match traffic with no keyword)<br /><br />**Field Name:** `matchType`<br />**Type:** dimension |

### App

|                                                                                        |                                                                                                                       |
| -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>App Name</div>             | Name of the app being advertised<br /><br />**Field Name:** `appName`<br />**Type:** dimension                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>App ID</div>               | Unique App Store identifier (Adam ID)<br /><br />**Field Name:** `appId`<br />**Type:** dimension                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>App Primary Category</div> | Primary category of the app in the App Store<br /><br />**Field Name:** `appPrimaryCategory`<br />**Type:** dimension |

### Device

|                                                                                |                                                                                              |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Device Class</div> | Device type (IPHONE, IPAD)<br /><br />**Field Name:** `deviceClass`<br />**Type:** dimension |

### Geo

|                                                                                     |                                                                                                                 |
| ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Country or Region</div> | Country or region where the ad was served<br /><br />**Field Name:** `countryOrRegion`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Country Code</div>      | ISO country code<br /><br />**Field Name:** `countryCode`<br />**Type:** dimension                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Admin Area</div>        | Administrative area (state or province)<br /><br />**Field Name:** `adminArea`<br />**Type:** dimension         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Locality</div>          | City or locality<br /><br />**Field Name:** `locality`<br />**Type:** dimension                                 |

### Demographics

|                                                                             |                                                                                                      |
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Gender</div>    | Gender demographic of the audience<br /><br />**Field Name:** `gender`<br />**Type:** dimension      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Age Range</div> | Age range demographic of the audience<br /><br />**Field Name:** `ageRange`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Apple Search Ads campaigns.

### Performance

|                                                                                  |                                                                                                                              |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Impressions</div>    | Number of times the ad was displayed<br /><br />**Field Name:** `impressions`<br />**Type:** metric                          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Taps</div>           | Number of times the ad was tapped<br /><br />**Field Name:** `taps`<br />**Type:** metric                                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Installs</div>       | Number of installs attributed to taps on the ad<br /><br />**Field Name:** `tapInstalls`<br />**Type:** metric               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Installs</div> | Total installs including both tap and view-through installs<br /><br />**Field Name:** `totalInstalls`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>View Installs</div>  | Number of installs attributed to viewing the ad<br /><br />**Field Name:** `viewInstalls`<br />**Type:** metric              |

### Cost

|                                                                                          |                                                                                                                         |
| ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Cost</div>                   | Total spend in the local currency<br /><br />**Field Name:** `localSpend`<br />**Type:** metric                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Cost per Tap</div>           | Average cost per tap<br /><br />**Field Name:** `avgCPT`<br />**Type:** metric                                          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Cost per Mille</div>         | Average cost per 1,000 impressions<br /><br />**Field Name:** `avgCPM`<br />**Type:** metric                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Cost per Install</div>       | Average cost per tap-through install<br /><br />**Field Name:** `tapInstallCPI`<br />**Type:** metric                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Cost per Install</div> | Average cost per install including view-through installs<br /><br />**Field Name:** `totalAvgCPI`<br />**Type:** metric |

### Rates

|                                                                                      |                                                                                                                                  |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Tap-through Rate</div>   | Percentage of impressions that resulted in a tap<br /><br />**Field Name:** `ttr`<br />**Type:** metric                          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Conversion Rate</div>    | Percentage of taps that resulted in an install<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Install Rate</div>       | Percentage of taps that resulted in a tap-through install<br /><br />**Field Name:** `tapInstallRate`<br />**Type:** metric      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Install Rate</div> | Percentage of taps that resulted in any install (tap + view)<br /><br />**Field Name:** `totalInstallRate`<br />**Type:** metric |

### Downloads

|                                                                                       |                                                                                                                          |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>New Downloads</div>       | Number of new downloads attributed to taps<br /><br />**Field Name:** `tapNewDownloads`<br />**Type:** metric            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Re-downloads</div>        | Number of re-downloads attributed to taps<br /><br />**Field Name:** `tapRedownloads`<br />**Type:** metric              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>View New Downloads</div>  | Number of new downloads attributed to viewing the ad<br /><br />**Field Name:** `viewNewDownloads`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>View Re-downloads</div>   | Number of re-downloads attributed to viewing the ad<br /><br />**Field Name:** `viewRedownloads`<br />**Type:** metric   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total New Downloads</div> | Total new downloads from both taps and views<br /><br />**Field Name:** `totalNewDownloads`<br />**Type:** metric        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Re-downloads</div>  | Total re-downloads from both taps and views<br /><br />**Field Name:** `totalRedownloads`<br />**Type:** metric          |

### Pre-orders

|                                                                                    |                                                                                                                          |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Pre-orders Tap</div>   | Number of pre-orders placed attributed to taps<br /><br />**Field Name:** `tapPreOrdersPlaced`<br />**Type:** metric     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Pre-orders View</div>  | Number of pre-orders placed attributed to views<br /><br />**Field Name:** `viewPreOrdersPlaced`<br />**Type:** metric   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Pre-orders</div> | Total pre-orders placed from both taps and views<br /><br />**Field Name:** `totalPreOrdersPlaced`<br />**Type:** metric |

***

## Related

<CardGroup cols={2}>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog/index">
    Browse all platforms
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>