$npx -y skills add sales-skills/sales --skill sales-admailrAdmailr platform help — programmatic email ad server for newsletter publishers with automated ad insertion, campaign management REST API, CPM+CPC revenue model, and ESP integrations. Use when you want to monetize your newsletter with automated display or native ads, Admailr ads a
| 1 | # Admailr 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 Admailr to monetize my newsletter with ads |
| 9 | - B) Manage ad campaigns via the API |
| 10 | - C) Troubleshoot ad rendering or delivery issues |
| 11 | - D) Compare Admailr to other email ad networks |
| 12 | - E) Integrate Admailr ad tags into my ESP |
| 13 | |
| 14 | 2. **Which side are you on?** |
| 15 | - A) Publisher (I have a newsletter and want ad revenue) |
| 16 | - B) Advertiser (I want to place ads in newsletters) |
| 17 | |
| 18 | 3. **Newsletter details** (if publisher): ESP, subscriber count, current ad setup |
| 19 | |
| 20 | Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2. |
| 21 | |
| 22 | ## Step 2 — Route or answer directly |
| 23 | |
| 24 | | If the question is about... | Route to... | |
| 25 | |---|---| |
| 26 | | Newsletter monetization strategy (subscriptions, pricing models) | `/sales-newsletter [question]` | |
| 27 | | Sponsorship marketplace (direct sponsor deals) | `/sales-paved [question]` or `/sales-hecto [question]` | |
| 28 | | Sponsor intelligence (finding brands that sponsor newsletters) | `/sales-sponsorgap [question]` | |
| 29 | | Managing sponsor operations (invoices, CRM, reporting) | `/sales-sponsy [question]` | |
| 30 | | Growing your subscriber list | `/sales-audience-growth [question]` | |
| 31 | | Email deliverability (SPF/DKIM/DMARC) | `/sales-deliverability [question]` | |
| 32 | |
| 33 | If the question is Admailr-specific, continue to Step 3. |
| 34 | |
| 35 | ## Step 3 — Admailr platform reference |
| 36 | |
| 37 | **Read `references/platform-guide.md`** for the full platform reference — capabilities, pricing, data model, API integration recipes, code examples. |
| 38 | |
| 39 | **Read `references/admailr-api-reference.md`** for API endpoint details, authentication, and request/response formats. |
| 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**: Sign up, get your API key, add the ad tag HTML snippet to your ESP template. Start with a single ad zone, monitor CPM/CPC performance for 2-4 weeks before adding more zones. |
| 48 | - **Optimizing revenue**: Test different ad placements (top vs mid vs bottom). Native ads typically outperform display banners in newsletters. Keep ad load to 1-2 placements per issue to avoid subscriber fatigue. |
| 49 | - **API integration**: Use the campaign and banner endpoints to programmatically manage ad creatives. Pagination uses standard page/per_page params. |
| 50 | - **Choosing Admailr vs alternatives**: Admailr is best for small-to-mid publishers wanting automated programmatic ads with no subscriber minimum. For direct sponsor deals, use Paved or Hecto instead. For enterprise-scale, consider LiveIntent or Jeeng. |
| 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. **$100 minimum payout threshold**: You won't receive payment until earnings reach $100. Monthly payouts on the 20th via PayPal, ACH, or check. |
| 59 | 2. **Variable CPC rates + 70/30 split**: Each ad pays differently — there's no fixed rate. Revenue depends on advertiser bids, your audience targeting data, and click-through performance. Per Admailr's FAQ, the publisher keeps **70% of revenue from confirmed ad clicks** (Admailr retains 30%). |
| 60 | 3. **Dark mode rendering**: Ad images may not render correctly in dark mode email clients. Test creatives across clients before committing to specific banner sizes. |
| 61 | 4. **Apple MPP affects attribution**: Mail Privacy Protection pre-fetches images, inflating open counts. Admailr's algorithms account for this, but CPC metrics are more reliable than CPM for measuring actual engagement. |
| 62 | 5. **Native ads outside US only**: If your audience is international, only native ad formats are available — no display banners for non-US recipients. |
| 63 | |
| 64 | ## Related skill |