$npx -y skills add sales-skills/sales --skill sales-adspeedAdSpeed platform help — hosted ad server for publishers, advertisers, agencies, and ad networks with display, video, mobile, and email/newsletter ad serving, zone management, ad targeting, optimization, and REST API. Use when setting up AdSpeed to serve ads on your website or ema
| 1 | # AdSpeed Platform Help |
| 2 | |
| 3 | ## Step 1 — Gather context |
| 4 | |
| 5 | If `references/learnings.md` exists, read it first for accumulated platform knowledge. |
| 6 | |
| 7 | 1. **What are you trying to do?** |
| 8 | - A) Set up AdSpeed to serve ads on my website |
| 9 | - B) Serve ads in my email newsletter |
| 10 | - C) Manage campaigns and advertisers via the API |
| 11 | - D) Configure ad targeting (geo, time, keyword) |
| 12 | - E) Compare AdSpeed to other ad servers |
| 13 | |
| 14 | 2. **Your role?** |
| 15 | - A) Publisher (monetizing my own site/newsletter) |
| 16 | - B) Advertiser (placing ads on publisher sites) |
| 17 | - C) Ad agency (managing multiple clients) |
| 18 | - D) Ad network operator |
| 19 | |
| 20 | 3. **Current plan**: Free trial, Premium 100 ($9.95/mo), or higher? |
| 21 | |
| 22 | Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2. |
| 23 | |
| 24 | ## Step 2 — Route or answer directly |
| 25 | |
| 26 | | If the question is about... | Route to... | |
| 27 | |---|---| |
| 28 | | Newsletter monetization strategy (subscriptions, pricing models) | `/sales-newsletter [question]` | |
| 29 | | Programmatic/RTB ad serving | `/sales-epom [question]` or `/sales-adbutler [question]` | |
| 30 | | Self-serve advertiser portal | `/sales-adbutler [question]` | |
| 31 | | Direct-sold ad management for local publishers | `/sales-broadstreet [question]` | |
| 32 | | Free self-hosted ad server | `/sales-revive [question]` | |
| 33 | | Email deliverability (SPF/DKIM/DMARC) | `/sales-deliverability [question]` | |
| 34 | |
| 35 | If the question is AdSpeed-specific, continue to Step 3. |
| 36 | |
| 37 | ## Step 3 — AdSpeed platform reference |
| 38 | |
| 39 | **Read `references/platform-guide.md`** for the full platform reference — capabilities, pricing, email zone setup, API overview, integration recipes, code examples. |
| 40 | |
| 41 | Answer the user's question using only the relevant section. Don't dump the full reference. |
| 42 | |
| 43 | ## Step 4 — Actionable guidance |
| 44 | |
| 45 | Focus on the user's specific situation: |
| 46 | |
| 47 | - **Publisher getting started**: Create zones (display or email type), create ads with image URLs, link ads to zones, get the ad tag code, paste into your site template. Ads rotate automatically based on optimizer settings. |
| 48 | - **Email newsletter ads**: Create an Email/Newsletter zone, link image-only ads, get the ad tag (static `<a>` + `<img>` — no JavaScript). Add `&pair=em@{MERGE_TAG}` for unique matching if your ESP supports merge tags. |
| 49 | - **API automation**: Get API key/secret from Tools > API for Developers. Sign requests with MD5 hash. XML responses. 600 req/hr limit. |
| 50 | - **Choosing AdSpeed vs alternatives**: AdSpeed is best for budget-conscious publishers needing hosted ad serving with email support. For self-hosted free, use Revive. For self-serve portal, use AdButler. For direct-sold local, use Broadstreet. |
| 51 | |
| 52 | If you discover a gotcha, workaround, or tip not covered in `references/learnings.md`, append it there. |
| 53 | |
| 54 | ## Gotchas |
| 55 | |
| 56 | > *Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.* |
| 57 | |
| 58 | 1. **Email zones only support image banner ads** — no HTML, no rich media, no video. If your newsletter ad needs animated content, you'll need a GIF. |
| 59 | 2. **Cookie-less email tracking** — email clients block cookies, so impression-to-click matching requires the `&pair=` parameter with ESP merge tags. Without it, only one ad can be active per zone at a time. |
| 60 | 3. **API responses are XML, not JSON** — the REST API returns XML. You'll need an XML parser in your integration code. |
| 61 | 4. **API rate limits are strict** — 600 requests/hour across all methods, 2400/day per method, and create operations are capped at 50/day. |
| 62 | 5. **Costs scale with impressions** — the slider-based pricing means your bill grows with traffic. Monitor your impression usage and consider annual prepayment (up to 20% discount). |
| 63 | |
| 64 | ## Related skills |
| 65 | |
| 66 | - `/sales-newsletter` — Newsletter monetization strategy (paid subscriptions, sponsorships, ad sales, pricing) |
| 67 | - `/sales-adbutler` — AdButler full-stack ad server (self-serve portal, email ad zones, REST API + MCP) |
| 68 | - `/sales-broadstreet` — Broadstreet ad manager for local/B2B publishers (n |