Skip to main content

The selectionRules container selects the items in a Promoted Listings campaign or a Item promotion. Use of the fields in this container depends on the purpose. See Promoted Listing campaigns and Item promotions for specifics.

Promoted Listing campaigns

The following methods are associated with Promoted Listing campaigns:

  • POST /ad_campaign

  • GET /ad_campaign/find_campaign_by_ad_reference

  • GET /ad_campaign/{campaign_id}

  • GET /ad_campaign/get_campaign_by_name

  • GET /ad_campaign

When using the selectionRules container to select the items included for a campaign, the following campaign specific details apply.

Field

Campaign specific details

brands

This array of product brands is used as an inclusion filter for a campaign. A product's brand is defined in a listing's item specifics.

This array will be returned if one or more product brands were used as a filter.

categoryIds

For campaigns, this array contains a list of category IDs associated with the listings to be included in the campaign. Ads are created for all the seller's items listed in the specified categories, up to a maximum of 50,000 items. The IDs can be either a list of eBay category IDs (from the site where the item is hosted), or a list of store category IDs defined and used by the seller's store (you have to have an eBay store). Set categoryScope appropriately.

For information on how to get category IDs, see eBay Marketplace category IDs and Seller storecategory IDs.

categoryScope

The enumeration value in this field indicates if the category IDs in the corresponding categoryIds array are identifiers for eBay categories or for a seller's eBay store categories. Set categoryScope to eBay IDs (MARKETPLACE) or Store IDs (STORE). This field is always returned if one or more category IDs are used as a filter.

listingConditionIds

This array contains a comma-separated list of unique identifiers for the conditions of listings to be included in the campaign. Up to four IDs can be specified. This array is only returned if one or more item condition values are used as a filter.

Note: Multiple listing condition IDs are mapped to four valid values. See listingConditionIds in the Promoted Listings Standard campaign flow.

maxPrice

This container sets a maximum price threshold. Any listings that have a 'Buy it Now' price above this price will not be considered for or added to this campaign.

minPrice

This container sets a minimum price threshold. Any listings that have a 'Buy it Now' price below this price will not be considered for or added to this campaign.

Only the CampaignCriterion type is associated with the SelectionRule type and campaigns.

Item promotions

The following methods are associated with promotions:

  • POST /item_price_markdown

  • GET /item_price_markdown/{promotion_id}

  • PUT /item_price_markdown/{promotion_id}

  • POST /item_promotion

  • PUT /item_promotion/{promotion_id}

  • GET /item_promotion/{promotion_id}

When using the selectionRules container to select the items included for a promotion, the following promotion specific details apply.

Field

Promotion specific details

brands This array of product brands is used to specify the seller's inventory to include in the promotion. This field is applicable only when categoryScope is set to MARKETPLACE.
categoryIds

For promotions, each selectionRules container can specify only a single category ID to include in the promotion. In this single-item array, include a single category ID which is either an eBay category ID or a seller's store category ID.

For information on how to get category IDs, see eBay Marketplace category IDs and Seller store category IDs.

Note: Required if inventoryCriterionType is set to INVENTORY_BY_RULE or when specifying selectionRules. Always specify both categoryIds and categoryScope fields in each selectionRules container.

Note: If you specify multiple selectionRules containers, the categoryScope in each must match (they must all be either Marketplace (eBay) category IDs or Store category IDs).

categoryScope

The type of the category ID for the item(s) to be included in the promotion. You must always supply both categoryIds and categoryScope.

Note: A request can have only one categoryScope.

Note: Required if inventoryCriterionType is set to INVENTORY_BY_RULE or when specifying selectionRules. Always specify both categoryIds and categoryScope fields in each selectionRules container.

Note: If you specify multiple selectionRules containers, the categoryScope in each must match (they must all be either Marketplace (eBay) category IDs or Store category IDs).

listingConditionIds This array contains a list of IDs that describe the condition of the items included in the promotion. For more information, see Item condition ID and name values.

Note: This value is not currently returned in the response.

maxPrice This container sets the maximum value of the price range for the items included in the promotion. Only items whose price is equal to or less than maxPrice are included in the promotion.

Important! You must set minPrice if you set maxPrice.

minPrice This container sets the minimum value of the price range for the items included in the promotion. Only items whose price is equal to or greater than minPrice are included in the promotion.

Important! You must set maxPrice if you set minPrice.

Only the RuleCriteria type is associated with the SelectionRule type and promotions .

eBay Marketplace category IDs

There are several ways to get a list of marketplace category IDs including the following:

  • Get a list of category IDs for a marketplace by adding /sch/allcategories/all-categories to the marketplace URL when browsing the site. For example: http://www.ebay.com.au/sch/allcategories/all-categories

  • Navigate to the desired category on the host site and copy the category ID from the URL.

  • These options are also available for the US marketplace:

Seller store category IDs

Store category IDs are uniquely defined and maintained by each seller. Sellers can retrieve their store category IDs as follows:

  1. Go to Seller Hub > Marketing.

  2. Click Manage store categories.

    A list of your store categories displays.

  3. Click the All categories link displayed at the bottom of the list.

    A complete list of your store categories and their associated store category IDs displays.

Note: You can also get the sellers store category IDs through the GetStore call in the Trading API.

Got thoughts? Click the feedback button – your insights help us improve!