付费墙编辑工具中产品信息的标签变量
Adapty 的付费墙编辑工具允许您自定义产品及其优惠的所有文本内容。如果您需要支持多种语言区域，我们强烈建议使用变量。
工作原理
当您将我们列表中的标签变量添加到产品文本中时，我们的 SDK 会从应用商店拉取预先获取的本地化数据来替换这些标签。这确保了您的付费墙上的文本始终完美适配正确的语言区域。
示例：假设您有一个”高级订阅”产品，同时在美国和西班牙提供。在美国，它可能显示为”Premium Subscription for $4.99/month”，而在西班牙则会显示为”Suscripción Premium por €4.99/mes”。
标签变量允许您根据直接来自应用商店的数据自动对这些字符串进行本地化，确保标题和价格始终准确无误。
本节介绍新版付费墙编辑工具，该工具适用于 iOS、Android 和 React Native SDK 3.0 及更高版本，以及 Flutter 和 Unity SDK 3.3.0 及更高版本。有关兼容 Adapty SDK v2.x 或更早版本的旧版付费墙编辑工具的信息，请参阅旧版付费墙编辑工具标签变量。
如何使用标签变量
您只能在付费墙编辑工具的产品组件中描述产品和优惠时使用标签变量。
- 在付费墙编辑工具的左侧面板中，选择您要自定义的产品。
- 在任意文本字段中使用下表中的变量来描述产品及其优惠。
- 检查屏幕右侧的预览，确保一切按预期渲染。
预览不会使用真实值来替换您的变量；这些值仅由我们的 SDK 在设备上获取。但预览会以与实际结果相同的格式显示模板数据。您可以通过点击预览右下角的眼睛图标并关闭 Tags preview values 开关来禁用此行为。届时预览将显示变量的实际值：
变量完整列表
| 标签变量 | 描述 | 示例 |
|---|---|---|
<PROD_TITLE/> | 产品的本地化标题 | Premium Subscription |
<PROD_PRICE/> | 产品的本地化价格。对于订阅，这是每个计费周期的价格。 | $9.99 |
<PROD_PRICE_PER_DAY/> | 订阅价格除以计费周期天数。对于非订阅商品返回空字符串。 | $0.33 |
<PROD_PRICE_PER_WEEK/> | 订阅价格除以计费周期周数。对于非订阅商品返回空字符串。 | $2.33 |
<PROD_PRICE_PER_MONTH/> | 订阅价格除以计费周期月数。如果计费周期不足一个月，则调整为代表完整一个月的价格。对于非订阅商品返回空字符串。 | $9.99 |
<PROD_PRICE_PER_YEAR/> | 调整为代表完整一年使用的订阅价格。例如，月订阅价格将乘以 12，而年订阅价格保持不变。对于非订阅商品返回空字符串。 | $119.88 |
<OFFER_PRICE/> | 优惠（新用户优惠或促销活动）的本地化价格。仅适用于自动续期订阅，如果用户不符合任何优惠资格则返回空字符串 | $0.99 |
<OFFER_BILLING_PERIOD/> | 优惠（新用户优惠或促销活动）的本地化计费周期。对于免费试用和预付费优惠，与 <OFFER_FULL_DURATION/> 相同。仅适用于自动续期订阅，如果用户不符合任何优惠资格则返回空字符串 | 1 week |
<OFFER_FULL_DURATION/> | 优惠（新用户优惠或促销活动）的本地化完整持续时间。仅适用于自动续期订阅，如果用户不符合任何优惠资格则返回空字符串 | 1 month |
不同优惠类型的优惠标签
您可以在此处了解更多关于优惠及如何在 Adapty 中配置它们的信息。
理解优惠标签可能有些复杂，让我们通过一个示例来说明。假设您有一个名为”Premium Subscription”的周订阅，价格为 $5，并提供三种可能的优惠：
- 按使用付费（Pay As You Go）：前 3 周每周 $3（按周计费），之后 $5/周。
- 预付费（Pay Up Front）：前 3 周共 $8（立即计费），之后 $5/周。
- 免费试用（Free Trial）：第一周免费，之后 $5/周。
对于该产品，<PROD_TITLE/> 为”Premium Subscription”，<PROD_PRICE/> 为 $5。然而，优惠标签的值——取决于用户符合哪种优惠资格——如下所示：
| 标签变量 | 按使用付费 | 预付费 | 免费试用 |
|---|---|---|---|
<OFFER_PRICE/> | $3 | $8 | $0 |
<OFFER_BILLING_PERIOD/> | 1 week | 3 weeks | 1 week |
<OFFER_FULL_DURATION/> | 3 weeks | 3 weeks | 1 week |
因此，对于非”按使用付费”类型的优惠，<OFFER_BILLING_PERIOD/> 和 <OFFER_FULL_DURATION/> 将会相同。