付费墙编辑工具中的自定义标签

自定义标签让你无需为不同场景创建多个付费墙，一个付费墙即可根据用户数据动态调整内容。例如，不再千篇一律地显示”Hello!”，而是个性化问候”Hello, John!”或”Hello, Ann!”

以下是一些常见的使用场景：

在付费墙上显示用户的姓名或邮箱。
展示当天是星期几，借此提升销量（例如”Happy Thursday”）。
添加所售产品的个性化信息（例如健身计划名称，或 VoIP 应用中的电话号码）。自定义标签可以帮助你创建灵活的付费墙，让界面适应各种场景，从而为用户提供更个性化、更有吸引力的体验。

请务必为每一行含有自定义标签的内容添加备用文本。

记得为所有包含自定义标签的行设置备用文本。

在某些情况下，应用可能无法识别该用什么内容替换自定义标签——尤其是当用户使用的是旧版 AdaptyUI SDK 时。为避免出现问题，请始终为含有未知自定义标签的行添加备用文本。否则，用户可能会直接看到原始标签代码（<USERNAME/>）。

如何向付费墙添加自定义标签

您可以在付费墙编辑工具的任意文本行中添加一个或多个自定义标签。

添加自定义标签的步骤：

在文本行中以 <CUSTOM_TAG/> 格式输入自定义标签，或输入左尖括号（<），系统将以正确格式提示该标签。

需要注意以下几点：
- 在 Adapty 付费墙编辑工具中，自定义标签用尖括号括起来（<CUSTOM_TAG/>），但在您的应用代码中，应直接引用（CUSTOM_TAG）。
- 自定义标签区分大小写。
- 自定义标签不能与 Adapty 中为产品信息保留的任何标签变量重叠。

添加自定义标签后，请务必输入备用文本行。如果您的应用无法识别某个自定义标签，该备用文本将在应用中显示，确保用户不会看到以代码形式呈现的标签。备用文本将替换包含该自定义标签的整行内容。

如何在移动应用中使用自定义标签

要在您的移动应用中使用自定义标签，请创建一个 tagResolver 对象——这是一个将自定义标签与字符串值配对的字典或映射，用于在付费墙渲染时替换相应标签。以下是示例：

let tagResolver = [
    "USERNAME": "John",
] 
  
let paywallConfiguration = try await AdaptyUI.getPaywallConfiguration(
    forPaywall: paywall,
    tagResolver: tagResolver // or any other AdaptyTagResolver protocol implementation
)

val customTags = mapOf("USERNAME" to "John")
val tagResolver = AdaptyUiTagResolver { tag -> customTags[tag] }

Map<String, String> customTags = new HashMap<>();
customTags.put("USERNAME", "John");
AdaptyUiTagResolver tagResolver = customTags::get;

val customTags = mapOf(
    "USERNAME" to "John",
    "CUSTOM_TAG_NAME" to "Walter White",
    "CUSTOM_TAG_PHONE" to "+1 234 567890"
)

val view = AdaptyUI.createPaywallView(
    paywall = paywall,
    customTags = customTags
)

final customTags = {
  'USERNAME': 'John',
};

try {
final view = await AdaptyUI().createPaywallView(
    paywall: paywall,
    customTags: customTags,
);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

var parameters = new AdaptyUICreateViewParameters()
  .SetCustomTags(
    new Dictionary<string, string> {
      { "CUSTOM_TAG_NAME", "John Appleseed" }
    }
  )

AdaptyUI.CreateView(paywall, parameters, (view, error) => {
  // handle the result
});

let customTags: Record<string, string> = { "USERNAME": "John" }
//and then you can pass it to createPaywallView as follows:
view = await createPaywallView(paywall, { customTags })

在此示例中，USERNAME 是您在 Adapty 看板中以 <USERNAME/> 格式输入的自定义标签。tagResolver 确保您的应用动态地将该自定义标签替换为指定的值——例如 John。

我们建议在展示付费墙之前创建并填充 tagResolver。准备就绪后，将其传递给您用于展示付费墙的 AdaptyUI 方法。您可以在以下平台了解更多关于展示付费墙的信息：iOS、Android、React Native、Flutter 或 Unity。