$npx -y skills add sales-skills/sales --skill sales-adserver-onlineAdserver.Online platform help — cloud-hosted ad server for building ad networks with display, video, native, email, and programmatic (OpenRTB/Prebid) ad serving, multicurrency bidding, retargeting, white-label customization, and REST API v2 at api.adsrv.net/v2 with Bearer token a
| 1 | # Adserver.Online 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 Adserver.Online to serve ads on my website |
| 9 | - B) Serve ads in my email newsletter |
| 10 | - C) Manage campaigns, ads, or zones via the API |
| 11 | - D) Set up programmatic RTB (OpenRTB / Prebid) |
| 12 | - E) Configure targeting (geo, device, retargeting, custom) |
| 13 | - F) Compare Adserver.Online to other ad servers |
| 14 | |
| 15 | 2. **Your role?** |
| 16 | - A) Publisher (monetizing my own site/newsletter) |
| 17 | - B) Advertiser (placing ads on publisher sites) |
| 18 | - C) Ad network operator (managing publishers + advertisers) |
| 19 | |
| 20 | 3. **Current plan**: Free trial, Starter ($49/mo), Premium ($199/mo), or Ultimate ($599/mo)? |
| 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 | | Self-serve advertiser portal | `/sales-adbutler [question]` | |
| 30 | | Direct-sold ad management for local publishers | `/sales-broadstreet [question]` | |
| 31 | | Free self-hosted ad server | `/sales-revive [question]` | |
| 32 | | Email deliverability (SPF/DKIM/DMARC) | `/sales-deliverability [question]` | |
| 33 | | API-first custom ad platform | `/sales-kevel [question]` | |
| 34 | |
| 35 | If the question is Adserver.Online-specific, continue to Step 3. |
| 36 | |
| 37 | ## Step 3 — Adserver.Online platform reference |
| 38 | |
| 39 | **Read `references/platform-guide.md`** for the full platform reference — capabilities, pricing, email ad setup, API overview, data model, 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 a site and zones (display/email/video), create campaigns with ads, assign ads to zones, generate ad code and paste into your site. Ads rotate automatically. |
| 48 | - **Email newsletter ads**: Requires Premium plan ($199/mo). On the zone page, select "Email" as the code type, choose your ESP, copy the generated `<a>` + `<img>` tag into your template. Image banners only — no JavaScript in email. Each message needs a unique ID via ESP macro. |
| 49 | - **API automation**: Create a Bearer token in Account > API tokens. Make requests to `https://api.adsrv.net/v2/{endpoint}`. Owner, publisher, and advertiser tokens access different endpoint sets. 100 req/min rate limit. |
| 50 | - **Choosing Adserver.Online vs alternatives**: Best for ad network operators and publishers wanting email + video + REST API in one platform at competitive pricing (Premium $199/mo for 10M). Note: programmatic OpenRTB, Prebid, Google RTB, and multicurrency bidding require the Ultimate plan ($599/mo) — not Premium. For self-serve portal, use AdButler. For API-first custom builds, use Kevel. For free self-hosted, use Revive. |
| 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 ads require Premium plan** — Starter ($49/mo) does not include email banner support, video, or API access. You need Premium ($199/mo) minimum. |
| 59 | 2. **Image banners only in email** — no JavaScript, iframes, or HTML5 in email zones. Use JPG/GIF/PNG image banners. |
| 60 | 3. **Unique message ID is mandatory** — each email send must include a unique per-message identifier via your ESP's merge tag. Without it, impression/click tracking breaks. |
| 61 | 4. **No webhooks** — Adserver.Online has no webhook or push notification system. Poll the API for data change |