Admailr 平台帮助技能。该技能用于解答与 Admailr 相关的问题，Admailr 是一个面向邮件通讯发行方的程序化邮件广告服务器，具备自动化广告插入、活动管理 REST API、CPM 与 CPC 收益模式等能力。
用途 该技能面向两类角色：发行方（拥有邮件通讯并希望获得广告收益）和广告主（希望在邮件通讯中投放广告）。它用于完成：开通 Admailr 以实现通讯广告变现、通过 API 管理广告活动、排查广告渲染或投放问题、将 Admailr 与其他邮件广告网络对比、以及把 Admailr 广告标签集成进 ESP 模板。
工作流程 第一步收集上下文：如果存在 references/learnings.md 则优先读取，以获取累积的平台知识。技能会询问用户的目标（设置 Admailr 变现、通过 API 管理活动、排查广告渲染或投放问题、与其他邮件广告网络对比、或将广告标签集成到 ESP），确认用户角色（发行方还是广告主），并收集通讯详情（ESP、订阅者数量、当前广告配置）。如果用户提示中已包含足够上下文，则跳过该步直接进入第二步。
第二步路由或直接回答：按问题类型将用户引导到对应技能，例如邮件通讯变现策略（订阅、定价模式）路由至 /sales-newsletter，赞助市场（直接赞助交易）路由至 /sales-paved 或 /sales-hecto，赞助商情报（寻找赞助邮件通讯的品牌）路由至 /sales-sponsorgap，赞助运营管理（发票、CRM、报告）路由至 /sales-sponsy，订阅者增长路由至 /sales-audience-growth，邮件送达率（SPF/DKIM/DMARC）路由至 /sales-deliverability。如果问题属于 Admailr 专属，则继续第三步。
第三步 Admailr 平台参考：读取 references/platform-guide.md 获取完整平台参考（能力、定价、数据模型、API 集成方法、代码示例）；读取 references/admailr-api-reference.md 获取 API 端点细节、认证方式与请求/响应格式。仅使用相关章节作答，不整体倾倒参考内容。
第四步可操作指导：针对用户具体情境给出建议。发行方入门方面，包含注册、获取 API 密钥、将广告标签 HTML 片段加入 ESP 模板，并从单个广告位开始，在增加更多广告位前先观察 2–4 周的 CPM/CPC 表现。收益优化方面，包含测试不同广告位置（顶部、中部、底部），原生广告在邮件通讯中通常优于展示横幅，保持每期 1–2 个广告位以避免订阅者疲劳。API 集成方面，使用 campaign 与 banner 端点程序化管理广告创意，分页使用标准 page/per_page 参数。方案选择方面，Admailr 适合希望使用自动化程序化广告且没有订阅者门槛的中小发行方；直接赞助交易应改用 Paved 或 Hecto；企业级规模可考虑 LiveIntent 或 Jeeng。
主要能力与集成 平台参考文档覆盖能力、定价、数据模型、API 集成方法与代码示例，API 参考文档覆盖端点细节、认证与请求/响应格式。技能给出的 API 示例包括创建活动的 POST /api/campaigns 端点及必填字段，以及用于 multipart 文件上传横幅的 POST /api/campaigns/{id}/banners，并附带 cURL 示例与认证设置。认证方式为自定义请求头 ADMAILR-ADS-API-KEY: your-key，或使用 Bearer 格式 Authorization: Bearer your-key；API 密钥可在 Admailr 仪表盘的账户设置中获取。
适用场景示例 发行方设置：例如某科技类通讯有 5,000 名订阅者、使用 ActiveCampaign，技能会引导注册、获取广告标签 HTML 片段、放入 ActiveCampaign 模板、配置广告位位置并设置类别限制。API 活动管理：技能展示创建活动与上传横幅的端点、字段、cURL 示例与认证设置。收益偏低：例如 3,000 名订阅者每月仅收入 15 美元，技能会诊断可能原因（广告位置不佳、点击率低、受众泛化），建议测试原生广告格式、将位置移至首屏、增加受众类别定向，并给出该订阅量级的预期收益范围对比。
注意事项与限制 以下内容为研究所得，需自行复核，尤其是涉及套餐限制与集成问题、可能已过时的条目。结算是 100 美元最低提现门槛，收益达到 100 美元后才可收款，每月 20 日通过 PayPal、ACH 或支票支付。CPC 费率浮动，每条广告付费不同、没有固定费率，收益取决于广告主出价、受众定向数据与点击表现。暗色模式渲染方面，广告图片在暗色模式邮件客户端可能无法正确渲染，在确定具体横幅尺寸前应跨客户端测试创意。Apple MPP 影响归因，邮件隐私保护会预取图片，抬高打开数，Admailr 算法会考虑这一点，但衡量实际互动时 CPC 指标比 CPM 更可靠。美国境外仅限原生广告，若受众为国际用户，仅提供原生广告格式，非美国收件人无展示横幅。
常见问题排查 广告在部分邮件客户端不渲染：症状为图片在 Outlook、Gmail 或暗色模式下显示破损或缺失；原因是各客户端处理图片渲染方式不同，部分默认拦截远程图片，暗色模式会反转颜色；解决方案是在广告标签 HTML 中使用回退 alt 文本，借助 Litmus 或 Email on Acid 跨客户端测试，暗色模式可使用透明 PNG 横幅或原生文字广告格式替代展示横幅。填充率低、广告位空白：症状为广告位有时显示空白而非广告；原因是当下没有匹配受众/类别的广告主出价，小型通讯或小众受众常见；解决方案是添加回填，在没有程序化广告填充时配置自家广告或联盟链接作为兜底，也可通过 Paved Ad Network 或 BuySellAds 补充需求，并确保通讯类别与受众数据配置准确。API 密钥无效：症状为 API 调用返回 401 Unauthorized；原因是密钥格式不正确或认证方式错误；解决方案是使用自定义请求头 ADMAILR-ADS-API-KEY: your-key，若使用 Bearer 认证则格式为 Authorization: Bearer your-key，API 密钥可在 Admailr 仪表盘账户设置中获取。
相关技能 /sales-newsletter 邮件通讯变现策略；/sales-paved Paved 通讯赞助市场；/sales-buysellads BuySellAds 上下文广告市场；/sales-hecto Hecto 通讯广告市场；/sales-adlynews adly.news 通讯广告市场；/sales-socialpresence Social Presence 通讯广告市场；/sales-sponsy Sponsy 赞助运营；/sales-sponsorgap SponsorGap 赞助商情报；/sales-deliverability 邮件送达率策略；/sales-do 不确定使用哪个技能时的路由器（安装：npx skills add sales-skills/sales --skill sales-do）。
暂未提供 上述资料未提供 Admailr 的具体价格与套餐档次、各功能的具体收费方式，以及部分功能模块的完整参数细节。