Field group | Field | Type | Data type | Description |
---|---|---|---|---|
Performance | Impressions | METRIC | INTEGER | The number of times your ad appeared in App Store search results within the reporting time period |
Performance | Taps | METRIC | INTEGER | The number of times your ad was tapped by users within the reporting time period |
Performance | Installs | METRIC | INTEGER | 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 |
Performance | TTR | METRIC | FLOAT | The tap-through rate (TTR) is the number of times your ad was tapped by users divided by the total impressions your ad received |
Performance | Avg CPA | METRIC | CURRENCY | The average cost-per-acquisition (CPA) is the total spend divided by the number of installs received within a period |
Performance | Avg CPT | METRIC | CURRENCY | The CPT (Cost per tap) is treated by the API the same as CPC (Cost per click). The ratio is spend over taps |
Performance | Avg CPM | METRIC | CURRENCY | Average CPM |
Performance | Amount spent | METRIC | CURRENCY | The total spend of a campaign in the currency used in the campaign |
Performance | Conversion rate | METRIC | RATIO | The total number of conversions received within a period, divided by total number of taps within the same period |
Install Type | New Downloads | METRIC | INTEGER | New Downloads |
Install Type | Redownloads | METRIC | INTEGER | Redownloads |
Install Type | Limited Ad Tracking (LAT) On Installs | METRIC | INTEGER | LAT On Installs |
Install Type | Limited Ad Tracking (LAT) Off Installs | METRIC | INTEGER | LAT Off Installs |
Time | Year | DIMENSION | YEAR | Events are broken down yearly |
Time | Year month | DIMENSION | YEARMONTH | Events are broken down monthly |
Time | Year month number | DIMENSION | YEAR_MONTH_NUMBER | Events are broken down monthly |
Time | Month | DIMENSION | MONTHNAME | Events are broken down monthly |
Time | Month Number | DIMENSION | MONTH | Events are broken down monthly |
Time | Week number(sun-sat) | DIMENSION | WEEK_NUMBER | Events are broken down weekly |
Time | Week number(mon-sun) | DIMENSION | WEEK_ISO_NUMBER | Events are broken down ISO weekly |
Time | Week start date(sun - sat) | DIMENSION | WEEK_START_DATE | Start date of the week. |
Time | Week start date(mon - sun) | DIMENSION | WEEK_ISO_START_DATE | Start date of the ISO week. |
Time | Date | DIMENSION | DATE | The date of the event |
Account | Account ID | DIMENSION | STRING | ID of the Apple Search Ads account |
Account | Account name | DIMENSION | STRING | Name of the Apple Search Ads account |
Account | Account currency | DIMENSION | STRING | Currency of the Apple Search Ads account |
Campaign | Campaign ID | DIMENSION | STRING | ID of the Apple Search Ads campaign |
Campaign | Campaign name | DIMENSION | STRING | Name of the Apple Search Ads campaign |
Campaign | Campaign status | DIMENSION | STRING | Status of the Apple Search Ads campaign |
Campaign | Campaign serving status | DIMENSION | STRING | Serving status of the Apple Search Ads campaign |
Campaign | Campaign serving status reasons | DIMENSION | STRING | Serving status reasons of the Apple Search Ads campaign |
Campaign | Campaign display status | DIMENSION | STRING | Display status of the Apple Search Ads campaign |
Campaign | Campaign countries or regions | DIMENSION | STRING | Countries or regions of the Apple Search Ads campaign |
Campaign | Campaign countries or regions serving state reasons | DIMENSION | STRING | Countries or regions serving state reasons of the Apple Search Ads campaign |
Campaign | Campaign ad channel type | DIMENSION | STRING | Ad channel type of the Apple Search Ads campaign |
Campaign | Campaign supply sources | DIMENSION | STRING | Supply sources of the Apple Search Ads campaign |
Campaign | Campaign created date | DIMENSION | DATE | Created date of the Apple Search Ads campaign |
Campaign | Campaign created date time | DIMENSION | DATETIME | Created datetime of the Apple Search Ads campaign |
Campaign | Campaign modified date | DIMENSION | DATE | Modified date of the Apple Search Ads campaign |
Campaign | Campaign modified date time | DIMENSION | DATETIME | Modified datetime of the Apple Search Ads campaign |
Campaign | Campaign start date | DIMENSION | DATE | Start date of the Apple Search Ads campaign |
Campaign | Campaign start date time | DIMENSION | DATETIME | Start datetime of the Apple Search Ads campaign |
Campaign | Campaign end date | DIMENSION | DATE | End date of the Apple Search Ads campaign |
Campaign | Campaign end date time | DIMENSION | DATETIME | End datetime of the Apple Search Ads campaign |
Campaign | Campaign total budget | DIMENSION | FLOAT | Total budget of the Apple Search Ads campaign |
Campaign | Campaign daily budget | DIMENSION | FLOAT | Daily budget of the Apple Search Ads campaign |
Campaign | App ID | DIMENSION | STRING | App ID used in the Apple Search Ads campaign |
Ad Group | Ad group ID | DIMENSION | STRING | ID of the Apple Search Ads ad group |
Ad Group | Ad group name | DIMENSION | STRING | Name of the Apple Search Ads ad group |
Ad Group | Ad group status | DIMENSION | STRING | Status of the Apple Search Ads ad group |
Ad Group | Ad group serving status | DIMENSION | STRING | Serving status of the Apple Search Ads ad group |
Ad Group | Ad group serving state reasons | DIMENSION | STRING | Serving state reasons of the Apple Search Ads ad group |
Ad Group | Ad group display status | DIMENSION | STRING | Display status of the Apple Search Ads ad group |
Ad Group | Ad group deleted | DIMENSION | BOOLEAN | Deleted status of the Apple Search Ads ad group |
Ad Group | Ad group default bid amount | DIMENSION | STRING | Default bid amount of the Apple Search Ads ad group |
Ad Group | Ad group creation date time | DIMENSION | DATETIME | Creation time of the Apple Search Ads ad group |
Ad Group | Ad group creation date | DIMENSION | DATE | Creation time of the Apple Search Ads ad group |
Ad Group | Ad group modification date time | DIMENSION | DATETIME | Modification time of the Apple Search Ads ad group |
Ad Group | Ad group modification date | DIMENSION | DATE | Modification time of the Apple Search Ads ad group |
Ad Group | Ad group start date time | DIMENSION | DATETIME | Start time of the Apple Search Ads ad group |
Ad Group | Ad group start date | DIMENSION | DATE | Start time of the Apple Search Ads ad group |
Ad Group | Ad group end date time | DIMENSION | DATETIME | End time of the Apple Search Ads ad group |
Ad Group | Ad group end date | DIMENSION | DATE | End time of the Apple Search Ads ad group |
Ad Group | Ad group automated keywords opt in | DIMENSION | STRING | Automated keywords opt in of the Apple Search Ads ad group |
Ad | Ad ID | DIMENSION | STRING | ID of the Apple Search Ads ad |
Ad | Ad language | DIMENSION | STRING | Language of the Apple Search Ads ad |
Ad | Creative ID | DIMENSION | STRING | ID of the Apple Search Ads creative |
Ad | Ad name | DIMENSION | STRING | Name of the Apple Search Ads ad |
Ad | Creative type | DIMENSION | STRING | The type of creative. Values are CUSTOM_PRODUCT_PAGE, CREATIVE_SET |
Ad | Ad status | DIMENSION | STRING | Status of the Apple Search Ads ad |
Ad | Ad display status | DIMENSION | STRING | The indicator of the status of an ad assignment with an ad group |
Ad | Ad display state reasons | DIMENSION | STRING | Reasons provided when an ad isn’t running |
Ad | Is ad deleted | DIMENSION | BOOLEAN | Indicates whether the ad has been deleted or not. Values are TRUE, FALSE |
Ad | Ad creation date | DIMENSION | DATE | The date the ad was created |
Ad | Ad creation time | DIMENSION | DATETIME | The date and time the ad was created |
Ad | Ad modification date | DIMENSION | DATE | The date of the most recent modification of the ad |
Ad | Ad modification time | DIMENSION | DATETIME | The date and time of the most recent modification of the ad |
Keyword | Keyword | DIMENSION | STRING | The keyword text |
Keyword | Keyword ID | DIMENSION | STRING | The keyword ID |
Keyword | Keyword display status | DIMENSION | STRING | The indicator of the status of a keyword assignment with an ad group |
Keyword | Keyword bid amount | DIMENSION | FLOAT | The bid amount for the keyword |
Search Term | Search term | DIMENSION | STRING | The search term text |
Search Term | Search term source | DIMENSION | STRING | The source of the search term. Values are AUTOMATIC or MANUAL |
Search Term | Match type | DIMENSION | STRING | The match type of the search term |