Creating and managing Promoted Listings general strategy campaigns
Creating and managing Promoted Listings priority strategy campaigns
Creating and managing Promoted Offsite campaigns
Creating and retrieving Promoted Listings and Promoted Offsite reports
Creating and managing discounts
Creating and retrieving discount reports
Creating and managing a store email campaign

Creating and managing Promoted Listings general strategy campaigns

General strategy campaigns use the Cost Per Sale (CPS) funding model and leverage the eBay Recommendation API to retrieve recommendations on which listings could benefit from a Promoted Listings campaign, as well as the trending bid percentages for the listings that will be promoted.

There are two primary ways to create a general strategy campaign, each of which provide different methods for adding listings to the campaign: key-based campaigns and rules-based campaigns. Key-based campaigns allow sellers to manually add listings to a campaign, while rules-based campaigns select listings to add to the campaign based on a pre-defined set of listing criteria, such as a certain brand of an item. 

The Sell Marketing API approaches used to create and manage a Promoted Listings general strategy campaign are discussed below:

1. Create and set up the structure of a Promoted Listings campaign using createCampaign and configure the following required fields.
• marketplaceId
• campaignName
• startDate
2. Set up the funding strategy for the general strategy campaign by configuring the following fundingStrategy fields: 
• [required] bidPercentage
• [required] fundingModel (set to COST_PER_SALE)
• [optional]  adRateStrategy 
3. Create a rules-based or key-based campaign:
• To create a key-based campaign, manually add one or more active listings to an existing campaign using one of the following methods. With each of these four methods, the campaign ID is passed in as a path parameter.

Note: The findListingRecommendations method of Recommendation API can be used to retrieve recommendations for which listings will perform the best in your Promoted Listings campaign, as well as the trading bid percentages for these listings.

• Use bulkCreateAdsByListingId or createAdsByListingId to add one or more listings to a Promoted Listings campaign using the unique identifier of the listing generated by the Trading API or Inventory API.
• Use bulkCreateAdsByInventoryReference or createAdsByInventoryReference to add one or more listings to a Promoted Listings campaign using the unique identifier of a single-item or multi-variation listing generated with the Inventory API.
• To create a rules-based campaign, specify one or more of the selectionRules criteria listed below, and listings that meet all specified criteria will be added to the campaign:

Note: There is an autoSelectFutureInventory boolean that can be included and set to true if the seller wants any future listings matching the criteria to be added to the campaign.

• brands: An array of brand names are specified here, and listing with the products that have one of the brand names will be eligible to be added to the campaign.
• categoryIds: An array of eBay leaf category IDs or eBay Store category IDs are specified here, and listings in one of these eBay or eBay Store categories will be eligible to be added to the campaign.
• listingConditionIds: An array of eBay item condition IDs are specified here, and listings using one of these item conditions will be eligible to be added to the campaign.
• maxPrice and/or minPrice: A minPrice and/or maxPrice threshold may be added as criteria. The sale price of the item must be within these thresholds to be eligible to be added to the campaign.

Below are the other methods applicable to managing general strategy campaigns:

• Use cloneCampaign to create a new campaign using an existing rules-based campaign’s specified campaign criterion. 
• Use updateAdRateStrategy to update the ad rate strategy for an existing rules-based campaign.
• Use findCampaignByAdReference to retrieve the campaigns containing a particular listing or listings, specified by a listing’s listingId or its seller-defined SKU or inventoryItemGroupKey value.
• Use updateBid to update the bid percentage (ad rate) for a specified ad in a general strategy campaign.
• Use deleteAd or deleteAdsByInventoryReference to remove an ad from a specified campaign.
• Use getCampaign, getCampaigns, getCampaignByName, or  findCampaignByAdReference to retrieve details about one or more Promoted Listings Advertising campaigns.
• Use deleteCampaign to delete a specific Promoted Listings campaign. 
• Use pauseCampaign to pause an active campaign, and resumeCampaign to resume a paused campaign. 
• Use endCampaign to end a running Promoted Listings campaign.

Creating and managing Promoted Listings priority strategy campaigns

Priority strategy campaigns use the Cost-Per-Click (CPC) funding model and leverage the eBay Marketing API to retrieve suggestions for listings, keywords, and bids for the campaign.

There are two primary ways to create a priority strategy campaign, each of which provides different methods for configuring the campaign: Manual targeting campaigns and Smart targeting campaigns. Manual targeting campaigns offer sellers complete control over campaign setup and optimization, while smart targeting campaigns offer easy setup and automatically optimize the campaign for the seller.

The Sell Marketing API approaches used to create and manage Promoted Listings priority strategy campaigns are discussed below:

Manual targeting campaign with manual setup

Manual targeting campaigns with manual setup allow sellers to have complete control over the listings, keywords, and keyword bids associated with the campaign.

1. Create and set up the structure of a manual targeting campaign using createCampaign and configure the following required fields:
• marketplaceId
• campaignName
• Budget
• fundingStrategy.fundingModel (set to COST_PER_CLICK)
• startDate
2. Optionally, use suggestItems to retrieve eBay suggested listings for a CPC Promoted Listings campaign.
3. Create an ad group for the campaign using createAdGroup and specify the defaultBid value for the ad group.
4. Add listings to the ad group using bulkCreateAdsByListingId or createAdsByListingId.
5. Optionally, use suggestKeywords to retrieve keyword recommendations for the ad group and its listings, and use suggestBids to see which bids are recommended for the specified keywords.
6. Use bulkCreateKeyword or createKeyword to add keywords to the ad group, and optionally use bulkCreateNegativeKeyword or createNegativeKeyword to add negative keywords to the ad group.

Manual targeting campaign with quick setup

Quick setup campaigns allow sellers to expedite the creation of the campaign. They only need to provide basic information, and eBay will handle the rest.

1. Use setupQuickCampaign to expedite the creation of Promoted Listings priority campaign. This campaign will be saved in draft status.
2. Referencing the campaignId value returned in the setupQuickCampaign Location header, use launchCampaign to launch the campaign.

Smart targeting campaign

1. Optionally, use suggestMaxCpc to retrieve the suggested maximum cost-per-click value (maxCpc) value for a smart targeting campaign, based on the specified listings and marketplace.
2. Create and set the structure of the smart targeting campaign using createCampaign and configure the following required fields: 
• marketplaceId
• campaignName
• fundingStrategy.fundingModel (set to COST_PER_CLICK)
• fundingStrategy.bidPreferences.maxCpc
• campaignTargetingType (set to SMART)
• startDate
3. Add listings to the campaign using createAdByListingId or bulkCreateAdsByListingId.

Below are the other methods applicable to managing priority strategy campaigns:

• Use updateBiddingStrategy to change the bidding strategy on a manual targeting CPC campaign from Fixed to Dynamic, or vice versa. In addition, this method can be used to update the maxCPC value of a smart targeting campaign.
• Use updateCampaignBudget to modify the daily budget for a priority strategy campaign. 
• Use getCampaign, getCampaigns, getCampaignByName, or  findCampaignByAdReference to retrieve details about one or more Promoted Listings Advertising campaigns.
• Use deleteCampaign to delete a specific Promoted Listings campaign. 
• Use pauseCampaign to pause an active campaign, and resumeCampaign to resume a paused campaign. 
• Use endCampaign to end a running Promoted Listings campaign.
• Use bulkUpdateAdsStatus to update the status of ads in bulk.
• Use updateKeyword and bulkUpdateKeyword to update keyword bids and statuses.
• Use updateNegativeKeyword and bulkUpdateNegativeKeywords to update negative keyword bids and statuses.