Sellers must meet certain eligibility requirements before eBay approves them for access to general and priority campaigns. These eligibility requirements, as well as how to use the eBay Account API to check seller eligibility status and how to request access to the various Promoted Listings programs, are outlined in the sections below.
Tip: Please note, additional error codes can be found on the bottom of all the pages on the specific API calls.
General eligibility requirements
In order for a seller to leverage the Promoted Listings program, they must have enough account activity on eBay and be an Above Standard or Top Rated seller. This means that sellers who are new to Promoted Listings and do not meet these criteria will not be able to access Promoted Listings to create and/or edit campaigns.
Additionally, the following requirements apply to the Promoted Listings program:
- The listings to be promoted must be fixed-price listings. Priority campaigns do not support auction listings.
- The listings to be promoted must be listed in the country for which they will be promoted.
- The currency for the listings to be promoted must match the country for which they will be promoted.
- The Promoted Listings program is supported only in eligible eBay marketplaces, and only for eligible categories. Refer to Promoted Listings supported categories to view a full list of eBay marketplaces and categories supported for general and priority campaigns.
Account API verification
The getAdvertisingEligibility method of the eBay Account API provides developers with a way to check the seller eligibility status for eBay advertising programs (for both general and priority campaigns). The response from this method returns a SellerEligibilityEnum, which indicates whether the specified seller is eligible or ineligible.
If a seller is determined to be ineligible for the specified Promoted Listings program, the following reasons may be returned by by SellerIneligibleReasonEnum type.
NOT_ENOUGH_ACTIVITY: This enum value indicates that the seller is ineligible for the eBay advertising program due to lack of activity. New accounts take a few weeks to become eligible for eBay Promoted Listings Advanced. If the seller account is in good standing (Above Standard or Top Rated), the account should become eligible within a few weeks.NOT_IN_GOOD_STANDING: This enum value indicates that the seller is ineligible for the eBay advertising program because their account is not currently in good standing. Below Standard sellers cannot use eBay advertising programs to create new campaigns or edit their existing campaigns. Existing campaigns will be paused by the system.RESTRICTED: This enum value indicates that the seller is ineligible for the eBay advertising program because their account is not currently approved for the restricted program. eBay is currently testing an advanced ads program with a small invite-only group. More information will be shared when the program is ready for expansion.
Account level notifications
Promoted Listings users can leverage eBay’s Notification API to receive account notifications by subscribing to various topics (alert types). These topics include:
-
SELLER_CUSTOMER_SERVICE_METRIC_RATING and SELLER_STANDARDS_PROFILE_METRICS for notifications regarding seller level and performance metrics
-
PLA_CAMPAIGN_BUDGET_STATUS for notifications regarding priority campaign updates
-
MARKETPLACE_ACCOUNT_DELETION for notifications when users want personal data deleted
The Notification API undergoes frequent feature updates. eBay recommends reviewing the Notification API Overview page for the most up-to-date and detailed information regarding notification management across eBay’s APIs.
Priority strategy campaign access requests
Once sellers understand and have been determined to meet the general eligibility requirements, as outlined in the General Eligibility Requirements section above, they can request access to the Promoted Listings priority advertising program.
To request access to the Promoted Listings priority advertising program, sellers must complete and submit an Application Growth Check. This is a free service that the eBay Developers Program provides to its members. During the Application Growth Check process, eBay will critically review all applications for compliance with the Application Growth Check requirements, at no cost to sellers.