<!--
{
  "availability" : [
    "Search Ads: 4.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/SupplySource",
  "metadataVersion" : "0.1.0",
  "role" : "Type",
  "symbol" : {
    "kind" : "Type",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "data:apple_ads:SupplySource"
  },
  "title" : "SupplySource"
}
-->

# SupplySource

The ad placements for a campaign.

```
string SupplySource
```

## Discussion

Use the following combination of campaign and ad group values for `supplySources`.

|**Ad channel type**|**Supply source**              |**Billing event**|**Pricing model**|
|-------------------|-------------------------------|-----------------|-----------------|
|`Search`           |`APPSTORE_SEARCH_RESULTS`      |`Taps`           |`CPC`            |
|`Display`          |`APPSTORE_TODAY_TAB`           |`Taps`           |`CPC`            |
|`Display`          |`APPSTORE_SEARCH_TAB`          |`Taps`           |`CPC`            |
|`Display`          |`APPSTORE_PRODUCT_PAGES_BROWSE`|`Taps`           |`CPC`            |

For payload examples, see [`AdChannelType`](/documentation/apple_ads/AdChannelType), [`BillingEventType`](/documentation/apple_ads/BillingEventType), [`PricingModel`](/documentation/apple_ads/PricingModel), and [`Campaign`](/documentation/apple_ads/Campaign) object. For more information about campaigns and ad groups, see [`Create a Campaign`](/documentation/apple_ads/Create-a-Campaign) and [`Create an Ad Group`](/documentation/apple_ads/Create-an-Ad-Group).

### Today tab compatibility

Campaigns with an `APPSTORE_TODAY_TAB` `SupplySource` reach users when they come to the App Store to discover apps. For an ad to display in the Today tab, your custom product page metadata — *app name* and *subtitle* — need to be localized in the `defaultLanguage` of all countries or regions where your ad is serving. For example, ads serving in the United States and Mexico require a product page with localized `en-US` and a product page with `es-MX` assets. See [`Get Supported Countries or Regions`](/documentation/apple_ads/Get-Supported-Countries-or-Regions).

iPhone is the only supported [`DeviceClass`](/documentation/apple_ads/DeviceClass) that you can use with a Today tab `SupplySource`. Today tab ad groups not targeting iPhone are placed on hold with the following [`AdGroupServingStateReasons`](/documentation/apple_ads/AdGroupServingStateReasons): `TARGETED_DEVICE_CLASS_NOT_SUPPORTED_SUPPLY_SOURCE`.

As part of review:

- Ads that are pending review are on hold until Apple completes the review.
- Ads that are incompatible with Today tab guidelines don’t receive approval.
- The system doesn’t serve rejected ads.

Use [`Find Ad Creative Rejection Reasons`](/documentation/apple_ads/Find-Ad-Creative-Rejection-Reasons) or [`Get Ad Creative Rejection Reasons`](/documentation/apple_ads/Gets-a-product-page-reason) to look up rejection reasons. See [`ProductPageReason`](/documentation/apple_ads/ProductPageReason) for rejection reason enumerations.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)