This type defines how the Promoted Listings fee is calculated for a Promoted Listings ad campaign.
Types that use FundingStrategy
CampaignCloneCampaignRequestCreateCampaignRequest
Calls that use FundingStrategy
POST
GET
Fields
adRateStrategy
This field is used to set the ad rate strategy for a Cost Per Sale (CPS) campaign.
The default value for this field is
Note: This field is not applicable for Cost Per Click (CPC) or offsite campaigns.
The default value for this field is
FIXED
. If this field is omitted, the default value will be used.Note: This field is not applicable for Cost Per Click (CPC) or offsite campaigns.
biddingStrategy
Indicates the bidding strategy for an onsite Cost Per Click (CPC) campaign that uses manual targeting.
Note: This field is not applicable for smart targeting campaigns.
Valid values are:
Default value: FIXED
Note: This field is not applicable for smart targeting campaigns.
Valid values are:
FIXED
When using a fixed bidding strategy, sellers manually assign and adjust keyword bids for the CPC campaign.DYNAMIC
When using a dynamic bidding strategy, eBay manages the campaign's keyword bids and automatically updates them daily to the suggested bid.
Note: For a CPC campaign using dynamic bidding, sellers can continue to manually add keywords for the campaign, but they are no longer able to manually adjust their associated bid values. In order to manually adjust bid values, sellers must use theFIXED
bidding strategy.
Default value: FIXED
bidPercentage
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:
If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.
Note:This field is only relevant for campaigns that use the CPS funding model and a fixed ad rate. It is not used for campaigns that use the Cost Per Click (CPC) funding model and should not be provided when the selected adRateStrategy for the campaign is dynamic.
Note: This field has a minimum value of
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.
If a bid percentage is not provided for an ad, eBay uses the default bid percentage of the associated campaign.
Note:This field is only relevant for campaigns that use the CPS funding model and a fixed ad rate. It is not used for campaigns that use the Cost Per Click (CPC) funding model and should not be provided when the selected adRateStrategy for the campaign is dynamic.
Note: This field has a minimum value of
2.0
and a maximum value of 100.0
.bidPreferences
array of BidPreference
This container indicates the bidding preferences of the campaign, such as the maximum CPC amount.
Note: This container is only applicable for smart targeting campaigns.
This container is required if the user wants to create a Smart Targeting campaign.
Note: This container is only applicable for smart targeting campaigns.
This container is required if the user wants to create a Smart Targeting campaign.
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
Default:
Note: Dynamic adjustment is only applicable when the adRateStrategy is set to
DYNAMIC
This field is not applicable for offsite campaigns.Default:
FIXED
fundingModel
Indicates the model that eBay uses to calculate the Promoted Listings fee.
For a description of the funding model types, refer to FundingModelTypeEnum.