在此页面上：了解如何配置读取受众活动，按需或按计划将Adobe Experience Platform受众中的配置文件纳入历程，并个性化每个配置文件的路径。
使用读取受众活动，开始具有已定义受众的历程。 您可以选择受众及其运行时间；然后使用条件、计时器和操作来个性化每个用户档案的路径。
关于读取受众活动 about-segment-trigger-activity
读取受众活动是历程入口点活动，可将选定Adobe Experience Platform受众的所有配置文件添加到历程。 您可以按一次或定期计划运行入口。 在API和技术参考中，此活动也称为区段触发器或基于受众的历程条目。
何时使用“读取受众”与“受众资格”
- 每周新闻稿→读取受众。 您的受众是每日批次快照。 您计划每个星期一早上9点到达。 所有符合条件的配置文件一起输入。
- 忠诚度级别升级→受众资格。 用户档案一在流受众中达到“金级”状态，就会立即进入历程并收到祝贺电子邮件。
- 重新参与系列→读取受众。 您每30天运行一次定期历程，以长达90天以上的不活跃用户档案为目标。
键限制：每个历程一个读取受众（必须是第一个活动）；每个活动一个受众；每个组织最多并发运行五个读取受众；每个沙盒每秒有20,000个配置文件；12小时作业超时。 护栏和限制中的完整详细信息。
先决条件：已生成并评估的Adobe Experience Platform受众（已实现状态）、为历程选择的基于人员的身份命名空间，以及对于定期运行，了解计划和吞吐量限制。
例如，在生成受众用例中创建的Luma app opening and checkout受众可以用作入口点。 所有符合条件的用户档案都会使用条件、计时器、事件和操作进入旅程并经过个性化路径。
➡️ 通过观看视频了解此功能
- 在使用读取受众活动之前，请阅读护栏和限制。
配置活动 configuring-segment-trigger-activity
您将设置：受众（必需）、命名空间（必需）、读取率（必需，默认5,000/s）和计划（历程运行时）。 可以选择添加 标签 和补充标识符。 以下步骤将指导您完成每个设置。
添加活动并选择受众 add-activity-and-select-audience
-
展开 编排 类别并将 读取受众 活动拖放到画布中。
必须将活动定位为历程的第一步。
-
向活动添加标签（可选）。 可选标签可帮助您在报告和测试模式日志中识别活动。
-
在 受众 字段中，选择将进入历程的Adobe Experience Platform受众，然后单击保存。 您可以选择使用区段定义生成的任何Adobe Experience Platform受众。
note NOTE 此外，您还可以定位使用受众合成创建的Adobe Experience Platform受众。
您还可以定位从CSV文件🔗上传的受众。
了解有关如何在Journey Optimizer中生成和定位受众的更多信息。请注意，您可以自定义列表中显示的列，并对其进行排序。
添加受众后，复制按钮允许您复制其名称和ID：
{"name":"Luma app opening and checkout","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}
note NOTE 只有具有 已实现 受众参与状态的个人才能进入历程。 有关如何评估受众的更多信息，请参阅分段服务文档。 -
在 命名空间 字段中，选择要使用的命名空间以标识个人。 默认情况下，这个字段会预填充为上次使用的命名空间。 了解有关命名空间的更多信息。
note NOTE 如果受众的不同身份中没有选定的身份（命名空间），则属于该受众的个人无法进入历程。 您只能选择基于人员的身份命名空间。 如果您为查找表定义了命名空间（例如：产品查找的ProductID命名空间），则该命名空间在 命名空间 下拉列表中不可用。
补充标识符 read-audience-supplemental-id
您可以选择启用 使用补充标识符 在配置文件标识符之外的辅助标识符（例如，订单ID或预订ID）的上下文中运行历程。 当补充标识符不同时，这允许同一配置文件的多个入口。
了解如何在历程中使用补充标识符。 对于读取受众历程，补充标识符是从 统一配置文件服务 受众的 联合/配置文件架构 中准备的，或者从 外部受众 的合格属性中选择的（例如，从CSV文件🔗导入的受众或从组合工作流生成的受众）。 使用补充ID时，每个历程实例的读取率限制为每秒500个配置文件。
护栏和建议 must-read
读取受众活动的所有护栏和限制（并发、吞吐量、每个活动一个受众、作业超时、重试等等）都列在护栏和限制中。
推荐
轮廓进入与读取速率 profile-entry-and-reading-rate
设置读取率（必需）。 这是每秒可以进入历程的配置文件的最大数量。 此比率仅适用于此活动，不适用于历程中的其他活动。 例如，如果您想对自定义操作定义限制速率，则需要使用限制API。 请参见此页面。
此值存储在历程版本有效负载中。 默认值为每秒5,000个配置文件。 您可以将此值从每秒500个配置文件修改为20,000个配置文件。
计划历程 schedule
默认情况下，历程配置为运行一次。 要定义历程应运行的特定日期/时间和频率，请执行以下步骤。
-
在 读取受众 活动属性中，选择编辑历程计划。
读取受众活动属性中的
-
旅程的属性随即显示。 在 计划程序类型 下拉列表中，选择您希望历程运行的频率。
对于定期历程，提供特定选项以帮助您管理将用户档案输入历程。 展开以下部分，了解有关每个选项的更多信息。
当具有定期 读取受众 的历程首次执行时，受众中的所有用户档案都进入该历程。 利用此选项，可在首次发生后仅定向自上次执行历程以来进入受众的个人。
使用此选项时，系统会从Adobe Experience Platform的分段服务执行的上次受众评估作业的时间开始，回顾24小时。
分段完成后，将开始配置文件快照导出作业，该作业允许Journey Optimizer检测和处理新配置文件。 如果在这两个作业之间计划了历程，则增量读取将不会选取自上次执行历程以来成为受众成员的用户档案。
要最大限度地降低丢失用户档案的风险，请执行以下操作：
- 启用 在批量受众评估后触发 选项，将回顾时间扩展到上一次成功执行历程的时间，而不管它是在多长时间之前发生的
- 安排在每日批处理分段作业完成后运行良好的历程（通常为2-3小时的缓冲）
- 对于需要立即包含用户档案的时间关键用例，请考虑改用具有流式受众的受众资格活动
| note caution |
|---|
| CAUTION |
| 对于自定义上传受众 （CSV上传）和其他外部受众（例如，联合受众合成），当前在功能上不支持增量读取。 在每个循环中，都会处理整个受众，而不管增量读取切换设置如何。 |
| 若要控制周期性条目，请使用强制重复重入。 |
利用此选项，可让历程中仍存在的所有用户档案在下次执行时自动退出该历程。
例如，如果您在每日循环历程中等待2天，则激活此选项会将用户档案移动到下一个历程执行。 此事件发生在第二天，无论它们是否处于下次运行的受众中。
如果此历程中用户档案的生命周期可能长于重复频率，请勿激活此选项以确保用户档案可以完成其历程。
这两个选项控制旅程执行的不同部分：
- 增量读取控制 从受众 中为下一次定期运行选择哪些配置文件。
- 强制循环重入控制 当下一次循环运行开始时，在历程 中仍处于活动状态的用户档案会发生什么情况。
请使用下表了解下次运行时的组合行为。
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 | ||
|---|---|---|
| 增量读取 | 在重复时强制重入 | 下次运行时的行为 |
| 关闭 | 关闭 | Journey Optimizer读取该运行的完整受众。 在历程中仍处于活动状态的用户档案不会自动重置。 |
| 于 | 关闭 | Journey Optimizer仅读取自上次执行以来添加到受众的用户档案。 在历程中仍处于活动状态的用户档案不会自动重置。 |
| 关闭 | 于 | Journey Optimizer在开始下一次运行之前从当前历程执行中删除活动参与者，然后再次读取完整受众。 这允许用户档案在新发生次数时重新开始。 |
| 于 | 于 | Journey Optimizer在开始下一次运行之前从当前历程执行中删除活动参与者，然后仅读取自上次执行以来添加到受众的用户档案。 强制重新进入会重置活动历程参与，但增量读取仍会将选择限制为新添加的受众成员。 |
换句话说，在重复时强制重入不会禁用增量读取。 如果同时启用这两个选项，则在下一次发生开始之前，会从其活动历程实例中删除用户档案，但下一次发生时仍会仅选择自上次执行以来被视为新的受众成员。
| note important |
|---|
| IMPORTANT |
| 强制重复登录删除的配置文件不会自动视为 增量读取 的新受众成员。 受众选择仍取决于自上次执行以来是否将用户档案新添加到受众。 |
对于安排在每日和定向批处理受众的历程，您可以定义一个长达6小时的时间范围，以便该历程从批处理分段作业中等待新的受众数据。 如果分段作业在时间范围内完成，则历程将触发。 否则，它会跳过旅程，直到下一次出现。 此选项确保历程使用准确且最新的受众数据运行。
例如，如果旅程安排在每日下午6点，则可以指定在旅程运行之前等待的分钟数或小时数。 当旅程在下午6点唤醒时，它会检查是否有新受众，这意味着受众比上一个旅程执行中使用的受众新。 在指定的时间范围内，将在检测到新受众后立即执行历程。 如果未检测到新受众，则将跳过当天的历程执行。
测试并发布历程 testing-publishing
读取受众活动允许您在单一配置文件上测试历程。
为此，请激活测试模式。
像往常一样配置和运行测试模式。 了解如何测试历程。
测试运行后，显示日志按钮允许您查看测试结果。 有关详细信息，请参阅此部分
测试成功后，即可发布历程（请参阅发布历程）。 属于受众的个人将在历程的属性 调度程序 部分中指定的日期/时间进入历程。
历程中的受众定位 audience-targeting-in-journeys
基于受众的历程始终以 读取受众 活动开始，以检索属于Adobe Experience Platform受众的个人。 这些用户档案读取一次或按定期计划读取。
进入历程后，您可以使用 条件 活动对其进行编排：按属性或行为分段、排除部分群体或将分支合并在一起（合并）。 以下各部分描述了每种模式。
区段
您可以使用 条件 活动使用条件执行分段。 例如，您可以让VIP人员采用特定的路径，而非VIP人员采用其他路径。
分段可以基于：
- 数据源数据
- 事件上下文是历程数据的一部分，例如：某人是否单击了一小时前收到的消息？
- 例如，日期：人员完成旅程时是否为六月？
- 时间，例如：上午是人员时区吗？
- 一种算法，根据百分比拆分历程中流动的受众，例如：90% - 10%以排除控制组
排除
用于分段的相同 条件 活动（请参阅上文）还允许您排除部分群体。 例如，您可以排除VIP人员，方法是：让这些人员流入分支中，并在其后执行结束步骤。
此排除可能紧随受众检索之后、出于群体计数目的或随着多步历程而发生。
使用结束历程
并集
历程允许您创建N个分支，并在分段后将它们连接在一起。 因此，您可以使两个受众返回同一个体验。
例如，在旅程中的十天中完成其他体验后，VIP和非VIP客户可以返回到同一路径。 合并后，您可以通过执行分段或排除来再次拆分受众。
使用并集进行分段后，
疑难解答 audience-count-mismatch
此部分可帮助您解决受众规模不匹配（输入的配置文件少于或超过预期数）、已处理个配置文件（读取受众警报或没有条目）以及延迟或缺少条目（时间和数据传播）。
segmentExportJob事件）以跟踪受众导出操作的生命周期。 这些事件在活动级别进行记录，而不是按个人资料进行记录，并且可供查询以用于监控和故障排除目的。 了解有关查询读取受众事件的详细信息。查找您的问题：
零个配置文件已处理 zero-profiles-processed
如果 读取受众 活动尚未处理任何配置文件（例如，您看到了读取受众警报）：
- 检查受众是否为空 — 在Adobe Experience Platform中，验证受众大小以及配置文件是否处于 已实现 状态。 如果受众为空或未评估，则不会生成任何条目。
- 检查命名空间 — 在读取受众活动中选择的命名空间必须存在于受众的用户档案中。 没有该身份的用户档案无法进入历程。 了解有关命名空间的更多信息。
- 查看警报和重试 - 警报中报告失败。 系统每10分钟重试一次导出作业创建，最长可为1小时。 了解有关重试和警报的详细信息。
如果在这些检查后问题仍然存在，请参阅计时和数据传播和数据验证和监视以了解批处理原因和配置原因。
定时和数据传播 timing-and-data-propagation
-
批处理分段作业完成：对于批处理受众，请确保在历程运行之前已完成每日批处理分段作业并更新快照。 分段作业完成后约 2小时 批次受众即可使用。 了解有关受众评估方法的更多信息。
-
数据摄取时间：验证在历程执行之前配置文件数据摄取是否已完全完成。 如果在历程开始前不久摄取了用户档案，则这些用户档案可能尚未反映在受众中。 了解有关 Adobe Experience Platform🔗中数据摄取的更多信息。
-
使用“批次受众评估后触发”选项：对于使用批次受众的每日计划历程，请考虑启用 批次受众评估后触发 选项。 这可确保历程在执行之前等待新的受众数据（最多6个小时）。 了解有关计划的更多信息
-
添加等待活动：对于包含最近摄取的数据的流受众，请考虑在历程开始时添加 等待 活动，以便有时间进行数据传播和配置文件鉴别。 了解有关等待活动的更多信息
-
inAudience()条件计时：在读取受众历程的条件节点中使用inAudience()时，将从用户档案的批量投影中读取区段成员资格。 此投影中的数据在摄取后 2小时 内刷新。 有关传播计时方案的完整详细信息，请参阅inAudience函数文档。
数据验证 data-validation-and-monitoring
-
检查分段作业状态：在Adobe Experience Platform 监视仪表板中监视批处理分段作业完成时间。 使用它来验证受众数据何时准备就绪。
-
验证合并策略：确保为受众配置的合并策略与组合来自不同源的配置文件数据的预期行为相匹配。 了解有关 Adobe Experience Platform🔗中合并策略的更多信息。
-
查看区段定义：确认区段定义配置正确并包括所有预期的资格条件。 了解有关构建受众的更多信息。 请特别注意：
- 可能根据事件时间戳排除用户档案的基于时间的条件
- 取决于最近更新数据的属性资格
- 流式评估方法与批量评估方法
-
验证命名空间配置：确保 读取受众 活动中选择的命名空间与受众中配置文件使用的主要标识匹配。 没有选定命名空间的配置文件将不会进入历程。 了解有关身份命名空间的更多信息。
最佳实践
-
在分段后安排历程：对于批处理受众，安排历程在典型的批处理分段作业完成时间后至少2-3小时执行。 了解有关历程计划的更多信息
-
将流式受众用于实时用例：如果您需要即时配置文件资格和历程条目，请使用具有流式受众的受众资格活动，而不是具有批处理受众的“读取受众”。
-
首先使用较小的受众进行测试：在启动大规模历程之前，请使用较小的子集进行测试，以验证计数是否与预期相符。 了解如何测试历程
-
定期监控：设置定期监控受众大小和历程进入量度，以尽早检测到差异。 了解有关历程处理率和条目管理的更多信息。
何时联系支持人员
如果在执行上述步骤后，计数不匹配或零配置文件运行仍然存在，请与Adobe支持部门联系。 准备就绪：受众名称/ID、历程名称/ID、计划运行时间、沙盒和差异的简短描述（例如“受众展示已实现10,000项，只有2,000项在[日期]进入历程”）。
重试 read-audience-retry
在检索导出作业时，重试操作会被默认应用于受众触发的历程（从 读取受众 或 业务事件 开始）。 如果在创建导出作业期间发生错误，则每 10 分钟重试一次，最多 1 小时。 之后，我们将它视为失败。 因此，这些类型的历程可以在预定时间之后 1 小时内执行。
捕获了失败的 读取受众 触发器并显示在 警报 中。 如果 读取受众 活动在计划执行时间10分钟后未处理任何配置文件，则 读取受众警报 会警告您。 此故障可能由技术问题或空受众导致。 如果失败是由技术问题引起的，则根据问题类型，重试仍可能发生。 例如，如果导出作业创建失败，我们每10分钟重试一次，最长为1小时。 了解详情
有关读取受众护栏（包括重试和吞吐量限制）的完整列表，请参阅护栏和限制。
相关主题
- 构建受众 — 创建和管理要在读取受众历程中定位的受众区段。
- 受众资格活动 — 在用户档案进入或退出受众时实时触发历程，而不是批量处理。
- 在历程中使用补充标识符 — 将读取受众历程扩展到目标辅助实体，例如预订、合同或链接到用户档案的订阅。
- 护栏和限制 — 在大规模启动之前，请检查吞吐量限制、重试行为和受众大小阈值。
- 历程处理速率和条目管理 — 了解如何将配置文件插入历程以及哪些内容控制条目和再次条目。
- 测试历程 — 在上线之前使用测试配置文件验证历程逻辑。
- 发布历程 — 激活您的历程并监视其初始执行。
- 向订阅者发送消息 — 端到端用例：从设置到投放，使用读取受众历程定位订阅列表。
- 读取受众历程的最佳实践 — 社区博客，其中涵盖常见缺陷、计数差异和经验证的最佳实践。
操作方法视频 video
了解由读取受众活动触发的历程的适用用例。 了解如何构建基于批次的历程以及可以应用的最佳实践。
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure and use the Read Audience activity in Adobe Journey Optimizer to add profiles from an Adobe Experience Platform audience into a journey, either once or on a recurring schedule, with guidance on scheduling, throughput, troubleshooting, and best practices.
Intents:
- Configure a Read Audience activity as the entry point of a journey
- Select an Adobe Experience Platform audience and identity namespace for the journey
- Set the reading rate to control how many profiles enter per second
- Schedule a journey to run once, daily, weekly, or on a custom recurrence
- Enable Incremental read to process only new audience members on recurring runs
- Troubleshoot audience count mismatches, zero-profile runs, and delayed entries
- Decide between Read Audience and Audience Qualification based on batch vs. real-time needs
Glossary:
- Read Audience activity: The journey entry-point activity that reads all qualified profiles from a selected Adobe Experience Platform audience and adds them to the journey (product-specific)
- Reading rate: The maximum number of profiles that can enter the journey per second (500–20,000; default 5,000) (product-specific)
- Incremental read: A recurring journey option that processes only profiles newly added to the audience since the last journey execution (product-specific)
- Force reentrance on recurrence: A scheduling option that removes all active journey participants before each new run so profiles can re-enter fresh (product-specific)
- Trigger after batch audience evaluation: A scheduling option that delays journey execution until a fresh batch audience snapshot is available (up to 6 hours) (product-specific)
- Supplemental identifier: A secondary identifier (e.g., order ID) that allows the same profile to enter the journey multiple times when the identifier differs (product-specific)
Guardrails:
- Only one Read Audience activity is allowed per journey, and it must be the first activity.
- Only one audience can be selected per Read Audience activity.
- Up to five concurrent Read Audience runs per organization.
- Maximum reading rate is 20,000 profiles per second per sandbox (sum of all concurrent Read Audience activities).
- Reading rate is limited to 500 profiles per second when a supplemental identifier is used.
- Only profiles with Realized audience participation status enter the journey.
- Only people-based identity namespaces are available; profiles without the selected namespace cannot enter.
- The 12-hour job timeout applies to Read Audience export jobs.
- Retries for failed export jobs occur every 10 minutes for up to 1 hour.
- For custom upload audiences with Incremental read enabled, profiles are only retrieved on the first recurrence (these audiences are fixed).
- Scale the Winner is not available for Read Audience journeys (path experimentation).
Terminology:
- Canonical name: Read Audience — Acronym: none — variants: segment-trigger, audience-based journey entry, Read Segment (legacy API name)
- Synonyms: “Read Audience” = “segment trigger” = “audience-triggered journey”
- Do not confuse: “Read Audience” ≠ “Audience Qualification” (Read Audience is batch/scheduled; Audience Qualification is real-time streaming)
FAQ:
- Q: When should I use Read Audience instead of Audience Qualification? — Use Read Audience for batch, scheduled use cases (e.g., weekly newsletters, re-engagement campaigns). Use Audience Qualification when profiles must enter the journey immediately as they qualify in real time.
- Q: Why are fewer profiles entering the journey than the audience size? — Common causes include profiles not having the selected namespace, batch segmentation jobs not yet completed before the journey ran, or profiles not being in Realized status. Enable “Trigger after batch audience evaluation” and check namespace configuration.
- Q: What does Incremental read do on the first run? — On the first execution, all audience profiles enter. On subsequent runs, only profiles newly added to the audience since the last execution are processed.
- Q: What happens if the export job fails? — The system retries every 10 minutes for up to 1 hour. Failures are reported in Alerts. After 1 hour without success, the run is considered failed.
- Q: Can the same profile enter a Read Audience journey multiple times? — Yes, if a supplemental identifier is configured and differs between entries, or if Force reentrance on recurrence is enabled. Without these, a profile cannot be present multiple times at the same time.
- Q: How long does a one-shot Read Audience journey remain live? — It auto-stops to Stopped when the last profile exits, unless the journey includes Wait, Reaction, or event-triggered transitions — in which case the 91-day global timeout applies. It does not remain Live until Finished at 91 days by default.