为 Adapty Mail 设置结账流程
每封邮件都会链接到浏览器中的结账页面，购买在该页面上完成。要创建结账页面，请在 Adapty Mail 中进入 Email Destinations，选择 Web Paywall，然后点击 Create。共有两种选项：
| AI 生成 | 自行托管 | |
|---|---|---|
| 页面构建方 | Adapty Mail（内置 Web 付费墙编辑工具） | 您 |
| 支付服务商 | 仅限 Stripe | 任意 |
| 项目 | 必须关联 Adapty 应用 | 任意 |
| 您的工作 | 选择方案，然后审核并发布 | 构建页面、从 URL 中读取收件人信息、回传购买数据 |
Adapty 核心产品有其自己的 Web 付费墙，这是一个独立功能——本文内容与其无关。
使用 AI 生成
AI 生成需要将项目关联到 Adapty 应用——即你第一次从 Adapty 看板打开 Mail 时，Adapty 为你创建的那个应用。如果你是在 Adapty Mail 中自行创建的项目，或使用独立账户或你自己的 Adapty 账户，请自行托管付费墙。
在 URL 字段下，找到 generate one with AI 链接并点击。
展开 Generation setup 面板，按顺序完成其中的六个步骤。每个按钮会打开对应操作的页面，返回后点击 Refresh 刷新状态。
| 清单项目 | 操作说明 |
|---|---|
| 1. Brand is ready | 如果你已设置好品牌，该项会自动勾选。否则点击 Set up brand。 |
| 2. Log in to the paywall builder dashboard | 点击 Log in 以完成编辑器认证。 |
| 3. Stripe account connected | 点击 Connect Stripe 并连接你的账户。 |
| 4. At least one Stripe product with a price | 点击 Open Stripe dashboard，添加一个带价格的产品。 |
| 5. Generate the paywall | 5.1. 点击 Generate。 5.2. 最多选择三个方案，第一个之后每个方案点击 Add plan。 5.3. 为每个方案设置生产环境价格、沙盒价格，或同时设置，且所有价格须使用同一货币。每个方案须填写同一列——某列数据填写不完整将无法生成。若未设置沙盒价格，测试邮件将使用生产环境付费墙，测试购买在该环境下无法正常进行。 5.4. 点击 Generate paywall，生成需要几分钟，完成后 URL 字段将自动填入。 |
| 6. Review and publish the paywall in the builder | 点击 Open editor，检查并发布。在付费墙生成之前该按钮处于禁用状态。 |
付费墙必须在发布后才能处理结账流量。未发布的付费墙在用户点击邮件结账链接时会返回错误。
付费墙发布后，点击 Save。
有关编辑工具中支付提供商的详细信息（Stripe 账户、测试与正式模式、产品设置），请参阅网页付费墙配置。
生成的付费墙长什么样
生成后会产生四个页面，收件人从邮件中点击链接后将依次看到：
- 邮箱 — 包含一个标题、一个副标题和一个邮箱输入框。Adapty Mail 会从链接中自动填入邮箱，这样营销活动带来的流量可以直接进入下一步；通过其他方式访问的用户则需要手动输入。
- 付费墙 — 销售页面，见下文。
- 支付成功或支付失败 — 二者只会显示其中一个。
AI 会根据你的品牌信息自动生成付费墙页面的所有内容：
| 版块 | 内容 |
|---|---|
| 标题与副标题 | 开篇宣传语 |
| 优惠徽章 | 紧迫感文案，不含虚构价格 |
| 主视觉图片 | 根据您的品牌生成 |
| 方案 | 标题、限时计时器以及您选择的方案 |
| 亮点 | 3–6 张卡片 |
| 功能特性 | 3–8 项，每项含标题和副标题 |
| 社会认同 | 一行证明文案，以及 3–5 条用户评价 |
| 常见问题 | 3–6 组问答 |
| 品质保障 | 退款或满意度承诺文案 |
CTA 和倒计时始终固定在顶部。Payment success 显示生成的图片和后续步骤；Payment failed 提示用户再次尝试，并保留结账状态。
使用您自己托管的付费墙
采用这种方式时，Adapty Mail 会将收件人引导至您自己托管的页面。URL 中包含占位符，用于传递用户信息。用户点击后的所有环节——优惠内容、支付流程、个性化体验——都由您来处理，可使用任意支付服务商。
- 为目标地址设置一个名称——在将其关联到推广活动时，你将通过该名称来选择它。
- 将托管付费墙的 URL 粘贴到 URL 字段中。URL 必须使用 HTTPS，并且可以包含占位符，用于替换每位收件人不同的值。
- 点击 Save。目标地址即可在推广活动中使用。
使用占位符和钩子个性化您的 URL
使用占位符和钩子，用每位收件人的唯一值来个性化您的付费墙 URL。占位符 列出了完整的占位符集合及使用规则。
重定向后您的页面需要完成的操作
Adapty Mail 在重定向后不执行任何操作。以下操作由您负责：
- 在结账开始前识别访客：从查询字符串中读取用户画像 ID 或邮箱，并将其与购买关联，确保付款记录到收到邮件的客户名下。
- 将购买结果回传：Adapty Mail 无法感知在您自有支付服务商处完成的付款。如果 Adapty Mail 不知道某笔购买的存在，该购买既不会被计为转化，也不会作为归因收入出现在数据分析中——更糟糕的是，系列邮件会继续发送给已经购买的用户。请通过您现有的数据传输路径回传购买信息：Adapty 集成，或 Adapty Mail API 的交易事件接口。
上线前测试付费墙
Send test email 可验证邮件是否正常渲染以及页面能否完成支付，但对于通过 URL 添加的付费墙，Sandbox 选项不可用——弹窗会提示 “This paywall has no sandbox products, so only production is available.” 因此测试会直接访问你的线上页面并使用真实产品：你可以用真实银行卡支付后申请退款，或在验证流程时将 URL 指向自己的测试环境。详情请参阅测试你的配置。
故障排除
| 问题 | 解决方案 |
|---|---|
| 结账链接无法打开 | 请确认付费墙已在 Web 付费墙编辑工具中发布 |
| 结账时用户未被识别 | 检查 URL 中是否包含与数据来源匹配的占位符。若占位符与数据来源不符，将解析为空字符串，导致该参数为空 |
| 购买未归因到对应邮箱 | 归因依赖于用户点击邮件中的 CTA 链接，因此收件人必须通过该链接进入结账页面，且购买记录需在同一用户画像下到达 Adapty Mail。若该购买已归因于早前的邮件，则保留原有归因 |