Documentation Index
Fetch the complete documentation index at: https://ebaymcp.com/llms.txt
Use this file to discover all available pages before exploring further.
Running Promotions
Learn how to increase your eBay sales with marketing campaigns, promoted listings ads, item promotions, and strategic optimization using the eBay MCP Server.- eBay MCP Server with user OAuth token
sell.marketingscope (write) orsell.marketing.readonly(read-only)- Active eBay listings to promote
- Advertising account approved (check eBay Seller Hub > Marketing)
Marketing Strategies Overview
The eBay MCP Server provides three main marketing tools:Promoted Listings
Item Promotions
Campaign Analytics
Promoted Listings Campaigns
Understanding Promoted Listings
Promoted Listings is eBay’s pay-per-sale advertising platform:- Cost: Only pay when item sells (ad fee percentage)
- Placement: Higher visibility in search results and category pages
- Control: Set ad rates per item or campaign-wide
- Performance: Track impressions, clicks, and conversions
Create Your First Campaign
Step 1: Create Campaign
Ask your AI assistant
Ask your AI assistant
ebay_create_campaign to establish your campaign foundation. You’ll receive a campaign ID for adding ads and ad groups.
Step 2: Create Ad Group
Ad groups help organize your ads by theme or strategy:Ask your AI assistant
Ask your AI assistant
Step 3: Add Products to Campaign
You can add products individually or in bulk:- Individual Ads
- Bulk Ads
- Listing ID Method
ebay_create_ad for each listingMonitor Campaign Performance
Track how your ads are performing:Ask your AI assistant
Ask your AI assistant
- Impressions: How many times your ads appeared
- Clicks: Buyer engagement with your ads
- Sales: Purchases attributed to ads
- Ad Fee: Total cost of advertising
- Revenue: Sales generated from ads
Keyword Targeting
Understanding Keywords
Keywords determine when your promoted listings appear in search results:- Broad Match: Variants and related terms (e.g., “laptop” matches “gaming laptop”, “laptop computer”)
- Phrase Match: Exact phrase with additional words (e.g., “Dell laptop” matches “new Dell laptop”)
- Exact Match: Precise term only (e.g., “Dell XPS 15” matches only “Dell XPS 15”)
Add Keywords to Ad Group
Ask your AI assistant
Ask your AI assistant
ebay_create_keyword with match type specifications.
Bulk Keyword Management
Add multiple keywords efficiently:Ask your AI assistant
Ask your AI assistant
ebay_bulk_create_keyword for batch operations.
Negative Keywords
Prevent ads from showing for irrelevant searches:- Campaign-Level
- Ad Group-Level
Item Promotions (Discounts & Sales)
Types of Promotions
eBay supports multiple promotion formats:Order Discount
Order Discount
- 10% off purchases over $50
- $5 off any order
- 15% off for first-time buyers
Markdown Sale
Markdown Sale
- 20% off all electronics (event sale)
- Flash sale: 30% off for 24 hours
- Seasonal clearance: 25% off winter items
Volume Pricing
Volume Pricing
- Buy 2, get 10% off
- Buy 3, get 1 free
- Tiered: 5% off 2 items, 10% off 3+
Shipping Discounts
Shipping Discounts
- Free shipping on orders over $25
- 50% off shipping for all items
- Free expedited shipping (limited time)
Create Item Promotion
Ask your AI assistant
Ask your AI assistant
ebay_create_item_promotion with detailed rules:
- Discount amount and type (percentage or fixed)
- Minimum purchase requirements
- Eligible items (by category, SKU, or listing ID)
- Start and end dates
- Priority (if multiple promotions apply)
Manage Active Promotions
View and modify your promotions:- List Promotions
- Update Promotion
- End Promotion
Promotion Performance Reports
Track promotion effectiveness:Ask your AI assistant
Ask your AI assistant
Advanced Campaign Optimization
Bid Suggestions
Get eBay’s recommended bid rates:Ask your AI assistant
Ask your AI assistant
ebay_get_bid_recommendation to retrieve:
- Suggested bid percentage
- Estimated impressions at that bid
- Competitive landscape data
- Expected performance metrics
Listing Recommendations
Improve listing quality for better ad performance:Ask your AI assistant
Ask your AI assistant
- Adding more photos
- Improving title keywords
- Updating item specifics
- Adjusting pricing
- Enabling Best Offer
Campaign Lifecycle Management
- Pause Campaign
- Resume Campaign
- End Campaign
- Archive Campaign
Clone Successful Campaigns
Replicate what works:Ask your AI assistant
Ask your AI assistant
ebay_clone_campaign to duplicate entire campaign structure, saving setup time.
Performance Reporting
Generate Campaign Reports
Create detailed performance analysis:Ask your AI assistant
Ask your AI assistant
ebay_create_report_task to generate asynchronous reports with:
- Campaign metrics: Overall campaign performance
- Listing metrics: Per-item ad performance
- Keyword metrics: Search term effectiveness
- Account metrics: Portfolio-wide advertising data
ebay_get_report to retrieve completed reports.Key Metrics to Monitor
Click-Through Rate (CTR)
Conversion Rate
Return on Ad Spend (ROAS)
Cost per Sale
Best Practices
Campaign Structure
Organize by Category
Use Ad Groups Strategically
Test Bid Strategies
Budget Management
Budget allocation strategy
Budget allocation strategy
Keyword Strategy
- Start Broad: Use broad match to discover what buyers search for
- Analyze Performance: Review keyword reports after 2-3 weeks
- Refine: Convert high-performing broad terms to phrase or exact match
- Add Negatives: Filter out unprofitable or irrelevant searches
- Test Continuously: Add new keywords based on search trends and competitor analysis
Seasonal Promotions
Plan promotions around key shopping events:- Q1 (Jan-Mar)
- Q2 (Apr-Jun)
- Q3 (Jul-Sep)
- Q4 (Oct-Dec)
- New Year sales (clearance)
- Valentine’s Day (gifts, jewelry)
- Spring cleaning (home goods)
Common Issues and Solutions
Low impressions despite high bids
Low impressions despite high bids
- Verify listings are active and in-stock
- Improve listing quality (photos, titles, item specifics)
- Check if category is eligible for promoted listings
- Ensure campaign and ad group status is RUNNING
- Review negative keywords (may be blocking relevant searches)
High ad spend, low sales
High ad spend, low sales
- Review pricing (may be too high vs. competitors)
- Improve listing photos and descriptions
- Check shipping costs (high shipping deters buyers)
- Analyze keywords (attracting browsers, not buyers)
- Add negative keywords to filter bargain hunters
- Ensure inventory is actually available
Campaign won't start
Campaign won't start
- Verify ad account is approved (check Seller Hub)
- Ensure payment method is valid
- Check for policy violations on listed items
- Confirm at least one ad exists in campaign
- Review eBay marketing account standing
Error: Ad already exists
Error: Ad already exists
- Check existing campaigns for this listing
- Update existing ad bid instead of creating new one
- Remove from old campaign before adding to new one
- Use
ebay_get_adsto find where listing is promoted
Automation Ideas
Leverage AI assistants for hands-free marketing:Weekly optimization routine
Weekly optimization routine
Next Steps
First Listing
Bulk Operations
Marketing API Reference
Analytics & Reporting
Related Topics
- Marketing Campaigns Features - Detailed marketing documentation
- Rate Limits - Optimize bulk ad operations
- OAuth Setup - Configure marketing scopes
- Troubleshooting - Common marketing errors