在 Unity SDK 中向流程传递数据

自定义标签是一个带有来自应用中的值的自定义变量。在变量设置中选择 Value comes from outside the app 后，你的应用就可以通过 Adapty SDK 为其设置值。例如，某个文本元素包含”Coins:“和一个自定义标签。如果你的应用为该标签传入”120”，用户将看到”Coins: 120”。

开始之前

您需要使用 Adapty SDK v4 或更高版本。v4 之前的版本不支持显示流程。

向流程添加自定义标签

要在流程中显示应用的数据，请在编辑工具中设置自定义标签：

1. 为应用传递的每个值创建一个自定义标签。

   

2. 将每个标签插入文本元素。

3. 记录每个标签的完整名称，包括其所属分组。应用代码在传递对应值时需使用该名称。例如，若 user 分组中包含 streak 标签，则该标签的完整名称为 user.streak。

   

传递自定义标签值

将应用的值以字符串到字符串字典（如 Dictionary<string, string>）的形式传递给 AdaptyUICreateFlowViewParameters 对象的 SetCustomTags 方法，然后使用该对象调用 AdaptyUI.CreateFlowView：

• 每个键是自定义标签的完整名称，例如 user.streak。
• 每个值是用户在标签位置看到的字符串。
• 每个值必须是易于阅读的格式，例如 “1,250”，而非 “1250.0”。Adapty 不会对其进行格式化或翻译。

SDK 在创建视图时读取一次这些值，因此在流程打开期间这些值不会发生变化。

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetCustomTags(new Dictionary<string, string> {
        { "username", "DragonSlayer42" },
        { "coins", "1,250" }
    });

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    // present the view
});

要测试自定义标签，请在添加设置其值的代码后，在应用中打开流程。编辑工具画布和在设备上预览只显示初始值：Adapty 移动应用不会设置自定义标签的值。

如果您的应用已经为旧版付费墙编辑工具的付费墙设置了自定义标签值，请查看流程中自定义标签的差异。

用户在未设置值时看到的内容

在以下情况下，用户会看到自定义标签的初始值作为备用内容：

• 您的应用未为该标签传递任何值。
• 用户尚未将应用更新到能传递该值的版本。
• 应用代码中的名称与标签的完整名称不匹配，包括字母大小写。
• 同一文本元素中的另一个自定义标签没有值。此时该文本元素中的每个自定义标签都会显示其初始值。

如需在标签位置不显示任何内容，请传入空字符串。Adapty 将空字符串视为有效值，因此不会显示备用内容。

示例：根据用户引导答案显示 BMI

流程可以收集用户的答案，自定义标签可以显示来自你应用的值。将两者结合，即可向用户展示由你的应用根据其答案计算得出的结果，例如得分、推荐套餐或健康指标：

1. 流程收集答案并将其发送给你的应用。
2. 你的应用计算结果。
3. 你的应用将结果作为自定义标签值传递给下一个流程。

在此示例中，一个用户引导流程收集用户的体重和身高。当用户在最后一屏关闭用户引导流程后，你的应用会计算其身体质量指数（BMI）。然后它会打开一个付费墙流程，显示该 BMI 值。

设置流程

1. 创建两个流程：一个用于收集用户体重和身高的用户引导流程，以及一个展示 BMI 的付费墙流程。

2. 在用户引导流程中添加两个 Number 输入框：

   • 一个用于输入体重（千克），Element ID 设为 weight。
   • 一个用于输入身高（厘米），Element ID 设为 height。

   两个输入框的 Format 均设为 Integer。输入框会将用户输入的内容原样以文本形式发送，示例代码对 “70.5” 和 “70,5” 的解析结果并不相同。整数没有小数分隔符，因此在任何语言环境下代码的解析结果都一致。

3. 为确保您的应用能收到两个值，请在用户引导流程的最后添加一个不含输入框的屏幕。在该屏幕上添加一个带有 Close flow 操作的按钮。输入框会在失去焦点或用户切换到其他屏幕时发送其值，而 Close flow 操作不会触发发送。示例代码只有在用户到达最后一屏时才会打开付费墙。

4. 在付费墙流程中，创建一个名为 bmi 的自定义标签。在 Initial value 字段中输入一个破折号（—）。如果您的应用未传入 BMI 值，用户将看到该破折号。

5. 在付费墙流程中添加一个文本元素，内容为”Your BMI:“。在这些文字后面插入 bmi 自定义标签。

6. 将用户引导流程添加到某个版位，例如 onboarding。将付费墙流程添加到 ID 为 bmi_paywall 的版位。将 BMI 传递给付费墙中的代码通过此 ID 获取付费墙。

将 BMI 传递给付费墙

从用户引导流程的 flow_user_input 事件中收集体重和身高数据，具体方法请参考处理流程数据。若要判断用户是否到达了最后一个屏幕，可以监听 flow_screen_showed 事件中 is_last_screen 为 true 的情况，详见跟踪流程屏幕浏览。当用户关闭该屏幕后的用户引导流程时，计算 BMI，然后创建付费墙视图，并将 BMI 传入 bmi 自定义标签。

在使用 Adapty.SetFlowsEventsListener 注册的监听器上实现以下方法。FlowViewDidDisappear 仅在你的应用关闭用户引导流程后触发，因此监听器还必须处理关闭流程操作，详见关闭流程和付费墙：

private readonly Dictionary<string, string> bodyAnswers = new Dictionary<string, string>();
private bool reachedLastScreen;

public void FlowViewDidReceiveAnalyticEvent(
    AdaptyUIFlowView view,
    string name,
    IReadOnlyDictionary<string, object> parameters
) {
    if (name == "flow_screen_showed") {
        if (parameters.TryGetValue("is_last_screen", out var lastScreen)
            && lastScreen is bool isLast && isLast) {
            reachedLastScreen = true;
        }
        return;
    }
    if (name != "flow_user_input") return;
    if (!parameters.TryGetValue("value", out var raw) || !(raw is string value)) return;

    if (!parameters.TryGetValue("element_id", out var idRaw) || !(idRaw is string elementId)) return;

    bodyAnswers[elementId] = value;
}

public void FlowViewDidDisappear(AdaptyUIFlowView view) {
    // The listener receives events from every flow. Reset `bodyAnswers` and
    // `reachedLastScreen` whenever a flow disappears, so that the paywall
    // doesn't open again when the user closes it.
    var answers = new Dictionary<string, string>(bodyAnswers);
    var finished = reachedLastScreen;
    bodyAnswers.Clear();
    reachedLastScreen = false;

    // Number inputs send their values as strings.
    if (!finished) return;
    if (!answers.TryGetValue("weight", out var weightText)
        || !double.TryParse(weightText, out var weight)) return;
    if (!answers.TryGetValue("height", out var heightText)
        || !double.TryParse(heightText, out var height)
        || height <= 0) return;

    var heightInMeters = height / 100;
    var bmi = weight / (heightInMeters * heightInMeters);
    ShowBmiPaywall(bmi.ToString("0.0"));
}

private void ShowBmiPaywall(string bmi) {
    Adapty.GetFlow("bmi_paywall", (flow, flowError) => {
        if (flowError != null) {
            // handle the error
            return;
        }

        var parameters = new AdaptyUICreateFlowViewParameters()
            .SetCustomTags(new Dictionary<string, string> { { "bmi", bmi } });

        AdaptyUI.CreateFlowView(flow, parameters, (view, viewError) => {
            if (viewError != null) {
                // handle the error
                return;
            }

            view.Present((presentError) => {
                if (presentError != null) {
                    // handle the error
                }
            });
        });
    });
}

ToString("0.0") 使用当前区域设置的小数分隔符：英语环境下为 “22.7”，德语环境下为 “22,7”。

将 BMI 保存到用户画像

要根据用户的 BMI 展示不同的流程，将其作为自定义属性保存到用户画像中。在 Adapty 看板中，创建一个 Number 类型的自定义属性，键名设为 bmi。然后将每个流程展示给根据该属性创建的目标受众。

在 FlowViewDidDisappear 中调用 Adapty.UpdateProfile 方法，紧跟在计算 bmi 的那行代码之后。传入 double 值而非格式化后的字符串，这样市场细分才能将 BMI 与阈值进行比较：

var parameters = new AdaptyProfileParameters.Builder()
    .SetCustomDoubleAttribute("bmi", bmi)
    .Build();

Adapty.UpdateProfile(parameters, (error) => {
    if (error != null) {
        // handle the error
    }
});