Skip to main content

A type that defines the request fields used to update the ad rate strategy for a Promoted Listings ad campaign.

Types that use UpdateAdrateStrategyRequest

Not used by any types.

Call that uses UpdateAdrateStrategyRequest

POST
/ad_campaign/{campaign_id}/update_ad_rate_strategy

Fields

Field
Type
Description
adRateStrategy
AdRateStrategyEnum
The ad rate strategy that shall be applied to the campaign.
bidPercentage
string
The user-defined bid percentage (also known as the ad rate) sets the level that eBay increases the visibility in search results for the associated listing. The higher the bidPercentage value, the more eBay promotes the listing.

The value specified here is also used to calculate the Promoted Listings fee. This percentage value is multiplied by the final sales price to determine the fee.

The Promoted Listings fee is determined at the time the transaction completes and the seller is assessed the fee only when an item sells through a Promoted Listings ad campaign.

The bidPercentage is a single precision value that is guided by the following rules:
  • These values are valid:
       4.1,    5.0,    5.5, ...
  • These values are not valid:
       0.01,    10.75,    99.99,
       and so on.
This is the default bid percentage for the campaigns using the Cost Per Sale (CPS) funding model, and this value will be overridden by any ads in the campaign that have their own set bid percentages.

If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.

Minimum value: 2.0
Maximum value: 100.0
dynamicAdRatePreferences
array of DynamicAdRatePreference
A field that indicates whether a single, user-defined bid percentage (also known as the ad rate) should be used, or whether eBay should automatically adjust listings to maintain the daily suggested bid percentage.

Note: Dynamic adjustment is only applicable when the adRateStrategy is set to DYNAMIC.
Default: FIXED