Skip to main content

This type defines the fields needed to create ads by inventory reference ID request.

Type that uses CreateAdsByInventoryReferenceRequest

BulkCreateAdsByInventoryReferenceRequest

Calls that use CreateAdsByInventoryReferenceRequest

Fields

Field
Type
Description
adGroupId
Note: This field is not currently in use. Ad groups are only applicable to priority strategy ad campaigns that use the Cost Per Click (CPC) funding model. See Funding Models in the Promoted Listings Playbook for more information.
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.

Required if the campaign's funding model is Cost Per Sale (CPS).

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 has a minimum value of 2.0 and a maximum value of 100.0.
inventoryReferenceId
The unique identifier of a single-item listing or a multi-variation listing.

To create an ad for a single-item listing, set the inventoryReferenceType value to INVENTORY_ITEM and specify an item ID or a SKU (if the SKU is defined in the listing).

To create an ad for a multi-variation listing, set the inventoryReferenceType value to INVENTORY_ITEM_GROUP and specify the item ID for the multi-variation listing or the inventoryitemGroupKey value as defined in the Inventory API.
inventoryReferenceType
This enumerated value indicates the type of item the inventoryReferenceId references.

The item can be either an INVENTORY_ITEM or an INVENTORY_ITEM_GROUP.

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