---
title: Ad
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/ad
---

# Ad

Ad entity that links an ad creative to an ad group for serving.

## Declaration

```data
object Ad
```

## Properties

id: The unique identifier of the ad. Read-only. name: Advertiser-given name of the ad. Mutable. status: Advertiser-configurable status. Use to pause or enable the ad. See AdStatus. Mutable. adAccountId: The identifier of the ad account this ad belongs to. Immutable after creation. campaignId: The identifier of the campaign this ad belongs to. Immutable after creation. adGroupId: The identifier of the ad group this ad belongs to. Immutable after creation. creativeId: The unique identifier of the ad creative this ad was created from. Immutable after creation. systemStatus: System-computed serving status of the ad. See AdSystemStatus. Read-only. systemStatusReasons: Reasons for the current system status. Populated when the ad is not serving. Possible values: AD_APPROVAL_CREATIVE_DOC_EXPIRED, AD_APPROVAL_CREATIVE_DOC_NOT_SUBMITTED, AD_APPROVAL_CREATIVE_DOC_PENDING, AD_APPROVAL_CREATIVE_DOC_REJECTED, AD_APPROVAL_PENDING, AD_APPROVAL_REJECTED, CREATIVE_INVALID, CREATIVE_LOCALE_INCOMPATIBLE, CREATIVE_PENDING, CREATIVE_SET_INVALID, CREATIVE_SET_UNSUPPORTED, DELETED_BY_USER, PAUSED_BY_SYSTEM, PAUSED_BY_USER, PROCESSING, PRODUCT_PAGE_DELETED, PRODUCT_PAGE_HIDDEN, PRODUCT_PAGE_INCOMPATIBLE, PRODUCT_PAGE_INSUFFICIENT_ASSETS, PRODUCT_PAGE_UNAVAILABLE. Read-only. systemStatusLimitingReasons: System status limited reasons for the ad. Possible values: CREATIVE_POLICY_ISSUES. Read-only. creationTime: Timestamp when the ad was created. Read-only. modificationTime: Timestamp of the last modification to the ad. Read-only. displayStatus: Rolled-up delivery state combining ad, ad group, and campaign conditions. Possible values: RUNNING, PAUSED, ON_HOLD, AD_GROUP_ON_HOLD, CAMPAIGN_ON_HOLD, LIMITED, PROCESSING, DELETED. Read-only. deleted: Indicates whether the ad is deleted. Read-only.

## Discussion

Discussion An Ad links a Creative to an AdGroup and is the atomic serving unit, the object that appears to users. To serve a different ad creative on an ad group, create a new ad rather than modifying an existing one. The status field is the advertiser-controlled on/off switch. The ENABLED value allows the ad to participate in auctions. The PAUSED value suspends it. When systemStatus is NOT_RUNNING, inspect systemStatusReasons for the cause. Common causes include ad creative review pending (AD_APPROVAL_PENDING), a rejected ad creative (AD_APPROVAL_CREATIVE_DOC_REJECTED), or an incompatible product page (PRODUCT_PAGE_INCOMPATIBLE). Fields you can filter and sort on when querying ads are listed in Query Ads. Example {   "id": 777888999,   "name": "AwayFinder - Default Product Page",   "status": "ENABLED",   "adAccountId": 123456789,   "campaignId": 444555666,   "adGroupId": 555666777,   "creativeId": 666777888,   "systemStatus": "RUNNING",   "systemStatusReasons": [],   "systemStatusLimitingReasons": [],   "creationTime": "2025-09-01T08:00:00.000",   "modificationTime": "2025-09-01T08:00:00.000",   "displayStatus": "RUNNING",   "deleted": false }

## Topics

### Type Aliases

- [Ad.DisplayStatus](apple-ads-platform-api/ad/displaystatus-data.typealias.md)
- [Ad.Status](apple-ads-platform-api/ad/status-data.typealias.md)
- [Ad.SystemStatus](apple-ads-platform-api/ad/systemstatus-data.typealias.md)
- [Ad.SystemStatusLimitingReasons](apple-ads-platform-api/ad/systemstatuslimitingreasons-data.typealias.md)
- [Ad.SystemStatusReasons](apple-ads-platform-api/ad/systemstatusreasons-data.typealias.md)

## See Also

- [AdCreate](apple-ads-platform-api/adcreate.md)
- [AdUpdate](apple-ads-platform-api/adupdate.md)
- [AdResponse](apple-ads-platform-api/adresponse.md)
- [AdQueryResponse](apple-ads-platform-api/adqueryresponse.md)