---
title: SupplySource
framework: Apple Ads
role: symbol
role_heading: Type
platforms: [search ads 4.0+]
path: apple_ads/supplysource
---

# SupplySource

The ad placements for a campaign.

## Declaration

```data
string SupplySource
```

## Possible Values

APPSTORE_PRODUCT_PAGES_BROWSE: Reaches users when they’re browsing apps across the App Store. Your ad appears at the top of the You Might Also Like list when users scroll to the bottom of relevant pages across the App Store. An optional AppCategoryCriteria targeting dimension is eligible to use with the APPSTORE_PRODUCT_PAGES_BROWSE supply source. See the Discussion section below for the combination of campaign and ad group values to use in campaign payloads with APPSTORE_PRODUCT_PAGES_BROWSE. APPSTORE_SEARCH_RESULTS: The campaign runs in App Store search results. See the Discussion section below for the combination of campaign and ad group values to use in campaign payloads with APPSTORE_SEARCH_RESULTS. APPSTORE_SEARCH_TAB: The campaign runs on the App Store Search tab. See the Discussion section below for the combination of campaign and ad group values to use in campaign payloads with APPSTORE_SEARCH_TAB. Ad group validations include: You can’t use a cpaGoal. You can’t use keywords. You can’t use the daypart targeting dimension. Search Match (automatedKeywordsOptIn) can’t be true. APPSTORE_TODAY_TAB: See the Today tab compatibility subsection below.

## Mentioned in

Apple Ads Campaign Management API 4 Apple Ads Campaign Management API 5

## Discussion

Discussion Use the following combination of campaign and ad group values for supplySources.  |  |  |   |  |  |   |  |  |   |  |  |   |  |  |  For payload examples, see AdChannelType, BillingEventType, PricingModel, and Campaign object. For more information about campaigns and ad groups, see Create a Campaign and 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. iPhone is the only supported 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: 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 or Get Ad Creative Rejection Reasons to look up rejection reasons. See ProductPageReason for rejection reason enumerations.

## See Also

### Data Types

- [AdChannelType](apple_ads/adchanneltype.md)
- [BillingEventType](apple_ads/billingeventtype.md)
- [CampaignCountryOrRegionsServingStateReasons](apple_ads/campaigncountryorregionsservingstatereasons.md)
- [CampaignDisplayStatus](apple_ads/campaigndisplaystatus.md)
- [CampaignServingStateReasons](apple_ads/campaignservingstatereasons.md)
- [CampaignServingStatus](apple_ads/campaignservingstatus.md)
- [CampaignStatus](apple_ads/campaignstatus.md)
- [PaymentModel](apple_ads/paymentmodel.md)