用途：通过 Zernio Ads API 统一管理 Meta(FB/IG)、Google、TikTok、LinkedIn、Pinterest、X 等平台的付费广告，无需各平台开发者应用、审核或 SDK，仅用 Bearer 令牌即可；若已使用 Zernio 发布 API，可复用同一账号与密钥。
主要能力：A. 推广已发布帖子，使用 Zernio 发布/排期的 postId 调用 POST /v1/ads/boost；B. 创建独立广告系列，调用 POST /v1/ads/create，需提供平台、账号、广告账号、目标、预算、排期、版位与创意（标题、正文、图片 URL、CTA、带 UTM 的落地页 URL）；C. 受众管理，POST /v1/ads/audiences 创建自定义受众（客户名单/网站/相似受众），POST /v1/ads/audiences/{id}/users 添加客户名单（自动 SHA-256 哈希）；D. 运营与分析，GET /v1/ads/{id} 查看状态与支出，PUT /v1/ads/{id} 修改预算、排期、定向或暂停，GET /v1/ads/{id}/analytics 获取支出、展示、点击、CTR、CPC、CPM、ROAS 及年龄/性别/国家/设备细分，GET /v1/ads/campaigns 列出全部系列。
使用方式：设置环境变量 ZERNIO_API_KEY（勿写入文件或聊天），Base 为 https://zernio.com/api/v1，请求头 Authorization: Bearer $ZERNIO_API_KEY；在 Zernio Dashboard 的 Accounts 中连接各平台广告账号（Meta 为 act_…），并用 GET /v1/accounts 验证平台与 adAccount。所有调用建议用 Python urllib + utf-8（Windows 下 curl+cp1252 处理 emoji 响应会崩溃），更新用 PUT（该服务器 PATCH 返回 405）。
限制与前置条件：必须在获得用户对平台、预算（金额/日或总额）、周期、定向的明确“go”批准后才能调用任何 ads 端点；模糊错误或超时不得盲目重试，应先 GET /v1/ads/campaigns 查列表，避免重复系列与重复扣费；创建响应需断言状态，与预期不符立即报告。测量前置条件包括 GA4 与 Google Ads 连接、转化事件、落地页 UTM 就绪，未就绪不应开始投放。A/B 为默认要求，每个系列至少 2 个创意（建议 3–4 个），命名 {campaign}_{axis}，24–48 小时检查后暂停表现差的素材。图片为 JPEG/PNG ≤30MB，建议 1080×1080 或 1200×628。完整文档见 docs.zernio.com。