inAudience 函数 inAudience
inAudience函数是一个Adobe Experience Platform函数，可用于检查旅程中的个人是否属于特定受众。 借助这项强大的功能，您可以根据受众成员资格创建个性化的历程路径，从而在客户体验中实现复杂的分段和定位。
当您需要以下操作时，请使用inAudience函数：
- 基于受众成员资格的分支旅程路径。 了解详情
- 应用取决于配置文件是否属于特定区段的条件逻辑
- 使用个性化体验定位特定的客户组
- 评估历程条件中的实时受众参与
- 合并多个受众检查以创建复杂的定位规则
此函数实时评估受众成员资格并返回一个布尔值，使其非常适用于决策节点和条件表达式。 在Adobe Experience Platform中定义和管理受众（了解有关Journey Optimizer中使用受众的详细信息），表达式编辑器提供自动完成建议以帮助您准确引用受众。
受众状态：
受众可以有两种参与状态：
- 已实现：该个人符合受众定义的条件，并且是活动成员
- 已退出：个人已离开受众，不再符合条件
只有状态为 已实现 的个人才会被视为活动受众成员。 当函数返回true时，它确认个人已实现状态；当函数返回false时，它指示退出状态。 有关受众评估的详细信息，请参阅分段服务文档。
inAudience(<parameter>)| table 0-row-3 1-row-3 | ||
|---|---|---|
| 参数 | 说明 | 类型 |
| 受众 | 受众名称 | <string> |
重要约束：
- 受众名称必须为字符串常量
- 不能是字段引用或表达式
- 在一个历程中最多可检索100个受众
inAudience(<string>)
返回布尔值：
-
true：个人是受众的成员（已实现状态） -
false：个人不是受众的成员（退出状态）
inAudience("men over 50")
如果历程实例中的个人是名为“50岁以上的男性”的Adobe Experience Platform受众的一部分，则返回true，否则返回false。
实际用例：
| code language-none |
|---|
|
护栏和限制 guardrails
在您的历程中使用inAudience函数时，请注意以下护栏和限制：
受众检索限制：
- 在一个历程中最多可检索100个受众
- 表达式编辑器提供自动完成的可用受众列表，以帮助您正确引用它们
参数约束：
- 受众名称必须为字符串常量
- 不支持将字段引用和表达式作为参数
受众名称更改：
- 更改Adobe Experience Platform中现有受众的名称不会自动更新历程表达式中对该受众的任何引用
- 如果条件节点使用
inAudience('oldAudienceName')，则必须手动编辑表达式以使用新名称 - 未能更新受众名称将导致历程条件中断，并可能导致错误的历程行为
合并策略注意事项：
- 通过
inAudience函数使用多个受众时，与合并策略不一致可能会导致错误或警报 - 有关合并历程行为的详细信息，请参阅策略属性
传播计时：
在条件节点中使用inAudience()时，区段成员资格评估时间因条件在历程中的出现位置而异：
- 在读取受众历程中，等待活动开始之前： Journey Optimizer从用户档案的批量投影中读取。此投影中的数据在摄取后 2小时 内刷新。 依赖于基于天或基于时间的条件的受众可能会遇到额外的延迟。 在历程开始时添加短的等待活动，或允许缓冲时间以确保反映最新的区段成员资格。
- 在单一事件历程中或等待活动后：从流式传输（单一）投影读取区段成员资格。 数据通常在 15分钟 内可用。 有关更多详细信息，请参阅Adobe Experience Platform流式摄取文档。
相关主题
了解有关在Adobe Journey Optimizer中使用受众的更多信息：
- 关于受众 — 了解受众在Adobe Experience Platform和Journey Optimizer中的工作方式，包括如何创建和管理受众
- 读取受众活动 — 使用受众触发历程条目并使所有受众成员进入历程
- 受众资格事件 — 侦听受众的个人资料入口和出口，以实时触发历程操作
- 在条件中使用受众 — 使用优化活动，根据受众成员资格创建条件历程路径
- 历程属性 — 合并策略 — 了解在inAudience函数中使用多个受众时，合并策略的工作方式
本节包含结构化知识，用于支持与本主题相关的解释、检索和问答。
要全面了解相关信息，应将此信息与本页上的文档相结合。 这两个源都不是独立的；页面描述了功能，而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。
- TL；DR：此页面记录了
inAudience函数，该函数实时检查历程配置文件是否属于指定的Adobe Experience Platform受众，并返回在历程条件中使用的布尔值。
意图：
- 使用
inAudience根据用户档案是否为特定受众的成员来分支历程路径 - 将多个
inAudience检查与AND/OR逻辑结合以创建复杂的定位条件 - 使用否定检查(
inAudience("...") == false)验证配置文件是否未进入特定受众 - 了解读取受众历程与单一事件历程之间的传播时间差异
- 识别并修复Adobe Experience Platform中由受众重命名导致的受众引用断行
术语表：
- 已实现：受众参与状态，指示个人当前符合受众定义条件并且是活动成员（产品特定）
- 已退出：受众参与状态指示个人已离开受众，不再符合 （产品特定） 的条件
- 合并策略： Adobe Experience Platform中的规则，用于确定在评估受众成员资格 （产品特定） 时如何合并来自多个数据集的配置文件数据
- 批次投影：已按读取受众历程 （产品特定） 使用的计划（摄取后2小时内）刷新配置文件数据存储
- 流式投影：在单一事件历程中和等待活动（产品特定）后使用的实时配置文件数据存储（通常在15分钟内可用）
护栏：
- 单个历程最多可检索100个受众
- 受众名称参数必须是字符串常量；不支持字段引用和动态表达式
- 在Adobe Experience Platform中重命名受众不会自动更新历程表达式中的
inAudience引用 — 需要手动更新 - 在同一历程中使用的多个受众的合并策略不一致，可能会导致错误或警报
术语：
- 规范名称：inAudience — 缩写：none — 变体：inSegment（旧名称）
- 同义词： “inAudience” = “audience membership check function”
- 请勿混淆：“已实现”（活动成员）≠“已退出”（不再是成员）
- 请勿混淆：“inAudience”（当前函数）≠“inSegment”（已弃用的旧版函数）
常见问题解答：
- 问：当个人资料退出受众时，
inAudience返回什么？ — 它返回false；只有具有“已实现”状态的配置文件才被视为活动成员并返回true。 - 问：一个历程中可以登记多少个受众？ — 在单个历程中最多可检索100个受众。
- 问：在历程中使用受众后，如果在Adobe Experience Platform中重命名受众，会发生什么情况？ — 历程表达式不会自动更新；您必须手动编辑
inAudience调用以使用新的受众名称，否则条件将中断。 - 问：在读取受众历程中更新个人资料后，受众成员资格有多快？ — 在等待活动之前的读取受众历程中，从摄取后2小时内刷新的批量投影中读取数据。
- 问：能否将配置文件属性作为受众名称参数传递？ — 否，受众名称必须是字符串常量；不支持字段引用和表达式。