创建数据馈送
创建数据馈送时,您向 Adobe 提供:
-
您想将原始数据文件发送到那里的目标的信息
-
您想在每一个文件中包含的数据
-
发送数据的频率(包括用于捕获延迟到达事件的处理延迟)
在创建数据馈送之前,重要的是要对数据馈送有基本的了解,并确保满足所有前提条件。 更多信息请参阅数据馈送概述。
创建和配置数据馈送 create-and-configure-data-feed
-
使用您的 Adobe ID 凭据登录 experiencecloud.adobe.com。
-
从界面右上角的应用切换器 应用程序 中选择
。 -
在顶部导航栏中,转到组件 > 导出。
-
选择 数据馈送 选项卡。
-
选择屏幕右上角的创建。
或者,如果之前未创建任何数据馈送,则在空表中选择创建数据馈送。
显示的页面具有以下选项卡: 详细信息、数据结构和投放。
-
在 详细信息 选项卡上,完成以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 字段 功能 名称 数据馈送的名称。 名称在所选数据视图中必须是唯一的,长度最多为255个字符。 标记 将任何标记应用到数据馈送以方便分类。 描述 指定数据馈送的说明(最多500个字符)。 编辑数据馈送时,您添加的描述可见。 数据视图 选择包含要导出的数据的数据视图。
选择数据视图时,请考虑以下事项:
- 如果为同一数据视图创建了多个数据馈送,则每个数据馈送必须具有不同的列定义。
- 可用列的列表取决于所选数据视图所属的登录公司。 如果更改数据视图,则可用列的列表可以更改。
-
选择下一步。
-
在 数据结构 选项卡上,确保在 数据视图 字段中选择了正确的数据视图。
-
在 区段 下拉菜单中,搜索并选择任何区段以过滤馈送中包含的数据。
应用多个区段时,它们与一个AND运算符连接在一起。 要使用OR运算符连接区段,必须首先在区段生成器中创建新区段,然后将新区段应用于数据馈送。
您在此处应用的区段是对可能已应用于数据视图的任何区段之外的区段。
-
(可选)在左边栏中,使用 搜索 字段来查找特定组件。 或者,选择 排序 图标
以应用以下任何排序选项:table 0-row-2 1-row-2 2-row-2 3-row-2 选项 功能 建议 为组件排序,将推荐的组件置于列表的顶部。 您或您组织中的其他人最频繁且最近使用的组件显示在列表的较高位置。 按字母顺序 按字母顺序为组件排序。 分类 与 推荐 类似的组件排序,不同之处在于组件是单独分组的,而不是混合在一起。 -
将组件添加到数据馈送配置。 左边栏仅显示对数据馈送有效的组件。
- 拖放:将组件从左边栏拖到画布上。 按住Shift,或按住Command (macOS)或Ctrl (Windows)以同时选择和拖动多个组件。
- 加号按钮:选择左边栏中任何组件旁边的加号
图标以将其添加到画布中。 - 全部显示:选择组件列表底部的 全部显示 以打开显示所有可用组件的对话框。 选中要添加的每个组件旁边的复选框,然后选择添加选定项。 当搜索词或筛选器标记在左边栏中处于活动状态时,还会显示 全部添加 按钮,允许您一次添加所有筛选结果。
添加字段时,请考虑以下事项:
-
(可选)通过拖动组件对画布上的组件重新排序。 您定义的顺序将保留为导出数据馈送文件中的列顺序。
-
(可选)通过拖动列边框调整画布上的列大小。
列宽将保存在Cookie中,并在您下次在同一浏览器上返回此数据馈送时保留。
-
(可选)更改组件的输出ID。 输出ID是数据馈送输出中的列名称。
默认情况下,输出ID是snake_case中的组件ID。 更改输出ID仅影响此数据馈送。 它不会更改数据视图中的组件ID。 在架构预览中,
id值是输出ID。输出ID必须:
- 在数据馈送中唯一。
- 仅包含字母、数字和下划线(
_)。 不允许使用空格、句点(.)、连字符(-)、正斜杠(/)和其他特殊字符。 - 以字母或下划线开头。
- 不超过255个字符。
输出ID不能以
_cja开头,它是保留给Adobe使用的。您可以逐个或批量更改输出ID:
accordion 更改单个组件的输出ID -
将鼠标悬停在画布上的组件上,然后选择信息图标
。 -
选择ID旁边的编辑图标
,然后指定新的输出ID。
accordion 一次更改多个输出ID -
在 架构预览 面板下,选择批量编辑输出ID。
-
选择复制,然后将JSON粘贴到文本编辑器或其他工具中。
-
更新
id值,即输出ID。 您无法更改组件名称(name)或类型(type和dataType)。 -
将编辑的JSON粘贴回对话框,替换现有JSON,然后选择验证。
-
查看已更改的ID数、未更改的ID数和错误数。 如果出现错误,请选择 上一步 以修复错误。
-
选择应用更改。
-
(可选)在继续之前,请使用页面右侧的 信息源摘要 和 架构预览 面板来查看您的数据结构:
- 信息源摘要显示您添加的组件、列、维度和量度总数的实时计数。
- 架构预览显示了数据馈送架构的JSON表示形式,该表示形式会在您添加或重新排序组件时更新。
- 使用 示例行 按钮可打开一个显示示例输出行的对话框,以便您可以验证结构是否正确显示。 此对话框仅显示示例数据,而不反映您的实际数据。
-
在 投放 选项卡的 计划 部分中,选择要创建的馈送类型(实时或回填),然后指定频率、处理延迟和其他配置选项:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 字段 功能 馈送类型 选择要创建的信息源类型:
- 实时馈送:导出当前和未来的数据。
- 回填馈送:导出历史数据。
开始日期 数据馈送开始的日期。 对于实时馈送,这必须是今天或未来的日期。 对于回填馈送,此日期必须是数据视图的数据保留窗口中的过去日期。 开始日期基于数据视图的时区。 到期日期
仅适用于实时馈送数据馈送过期且不再运行的日期。 日期基于数据视图的时区。 结束日期
仅适用于回填馈送数据馈送结束的日期。 结束日期不能是将来的日期。 日期基于数据视图的时区。 频率
仅适用于实时馈送选择应发送数据馈送的频率。 时间戳位于频率范围内的事件将包含在数据馈送交付中。
选择以包含一小时的数据或一天的数据。
- 每日:馈送包含一整天的数据,从数据视图时区的午夜到午夜。
- 小时:馈送包含一小时的数据。
每次投放还使用滚动的30天处理时段(在频率时段之前或之后),来限定区段、计算会话以及保留维度值。 处理窗口和 处理延迟 设置都会影响包含哪些事件。 有关详细信息,请参阅了解处理窗口和了解处理延迟。
粒度
仅适用于回填馈送用于将历史数据划分为块的时间间隔。 每个区块包含一整天的数据,时间范围从数据视图时区的午夜到午夜。
粒度决定着数据的分组方式,而不是数据的提交频率。 回填数据会尽快提供,而不是每天提供一次。
此字段始终设置为每日,无法修改。
处理延迟 Customer Journey Analytics 在处理数据馈送文件之前等待的时间。 在处理延迟期间到达的所有迟到事件都会包含在数据馈送中。
选择足够长的延迟,以便连接中最慢的数据完成处理。 如果延迟时间过短,仍在处理中的数据将不会包含在数据馈送文件中。
最小处理延迟为2小时。 默认值基于连接中的数据集。 例如,如果启用了拼接,则默认为6小时。 某些类型的数据需要较长的延迟。 您选择的延迟取决于连接中的数据类型,例如流式传输、批处理、拼接、查找或配置文件数据。
在配置此选项之前,请参阅以下部分中描述的详细信息和示例,了解处理延迟。
压缩格式 为传送到云目标的Parquet输出文件选择压缩格式。 从以下格式中选择:
- Snappy:文件大小适中的快速压缩和解压缩。 现代数据平台(如BigQuery、Snowflake和Apache Spark)广泛支持。
- GZip:广泛兼容,包括与本身不支持Snappy的工具兼容。 如果您的下游管道需要广泛识别的压缩标准,则建议使用。
- Z标准(Zstd):压缩效率高,解压缩速度快。 如果优先考虑最小化文件大小,并且您的工具支持Zstd,则适合。
所有格式都压缩每个Parquet文件中的数据,一次压缩一列,因此您的数据仓库仍然可以只读取查询所需的列。
有关Parquet的优势以及如何在文件传送后查询或加载文件的信息,请参阅在数据馈送中使用Parquet文件。
-
在 投放 选项卡的 目标 部分中,配置要将数据发送到的目标。
note NOTE 在配置报表目标时,请考虑以下事项: -
您之前配置的任何云帐户均可用于数据馈送。 您可以从位置管理器的组件>导出>位置帐户中配置云帐户。
-
Cloud帐户与您的Customer Journey Analytics用户帐户相关联。 其他用户无法使用或查看您配置的云帐户,除非您将其提供给组织中的所有用户。
-
您可以在组件>导出>位置中编辑从“位置”管理器创建的任何位置。
请完成以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 字段 功能 查看所有用户的目标 如果您是系统管理员,则可以启用此选项以查看由组织中的所有用户创建的目标。 禁用此选项后,仅显示您创建的目标。 帐户 执行以下其中一项操作:
-
使用现有帐户:选择 帐户 字段旁边的下拉菜单。 或者,开始键入帐户名称,然后从下拉菜单中选择该名称。
只有在配置帐户或与您所属的某个组织共享帐户后,您才可以使用帐户。
-
创建新帐户:在 帐户 下拉菜单中选择添加帐户。 有关如何配置帐户的信息,请参阅配置云导出帐户。
位置 执行以下其中一项操作:
- 使用现有位置:选择 位置 字段旁边的下拉菜单。 或者,开始键入位置名称,然后从下拉菜单中选择该位置。
- 创建新位置:在 位置 下拉菜单中选择添加位置。 有关如何配置位置的信息,请参阅配置云导出位置。
覆盖默认路径或文件名 启用此选项可覆盖为所选位置设置的默认路径或文件名。 覆盖仅适用于这个数据馈送,并决定了数据馈送文件发送到哪里。
启用此选项后,将显示 路径或文件名 字段。
路径或文件名
仅在启用 覆盖默认路径或文件名 时可用指定一个路径或文件名(或两者),以确定文件发送到选定位置中的什么地方。 要将文件保存到位置的顶层文件夹,请指定
/。对于实时馈送,您可以使用以下任意变量使路径或文件名成为动态路径:
- {yyyy}: 4位数的日历年(区分大小写)
- {yy}:2位数的日历年(区分大小写)
- {MM}:2位数月份(区分大小写)
- {dd}:2位数日(区分大小写)
- {HH}:2位数小时(区分大小写)
- {mm}:2位数的分钟数(区分大小写)
- {ss}:2位数秒数(区分大小写)
- {fff}: 3位数纳秒(区分大小写)
- {instance_id}:请求(实例) UUID
- {export_id}:导出(计划) UUID
- {idx}:索引从0开始(每个文件都增加)
- {total}:整个传输作业的文件总数
- {completion_millis}:传输时间(以毫秒为单位)
例如,如果您指定
${yyyy}/${MM}/${dd}/my-feed-${instance_id}-${idx},则在2027年1月15日交付的实时馈送将具有以下文件路径和名称:[prefix_folder_name]/2027/01/15/my-feed-[UUID]-1.parquet完成时和到期时通知问题 指定一个或多个电子邮件地址,以便在数据馈送完成、即将过期或遇到问题时接收通知。 请使用逗号分隔多个电子邮件地址。 启用清单 选择是否在每次数据馈送传递时附带一个清单文件。 清单文件包含数据馈送中包含的每个文件的信息。 -
-
选择保存。
了解处理窗口 data-feed-processing-window
处理时间范围是一个滚动的30天时间段,它可到达并包括所选的频率范围(小时或天)。 Customer Journey Analytics使用“处理”窗口中的数据来处理每个数据馈送的提交。 处理时段始终为30天,无法更改。
频率窗口确定投放中包含哪些事件。 处理窗口提供了正确为这些事件分类所需的历史上下文,例如这些事件符合条件的区段、它们属于哪个会话以及哪些维度值会保留到这些区段。
处理窗口和频度窗口的功能与Analysis Workspace报表窗口类似。 但是,存在主要差异。 这些差异可能会导致Workspace报表和数据馈送交付之间存在数据差异。
在处理窗口内处理数据时,将分别考虑区段鉴别、会话计算、维度持久性和派生字段转换:
细分资格筛选
将区段应用于数据馈送定义后,处理窗口中的数据将确定哪些事件、会话或人员符合该区段的条件。 区段的容器设置确定范围。 (可能的容器包括:“人员”、“会话”或“事件”。 B2B包括以下附加容器:全球客户、客户、商机、购买团体。)
示例:
假设您要创建一个数据馈送,以了解参与特定营销活动(营销活动B)的用户的行为。
要完成此操作,请将区段应用于促销活动B 中名为用户的数据馈送,以指示只有与此区段中的用户关联的事件应包含在数据馈送中。
在这种情况下,仅当用户同时满足以下两个条件中的 和 时,才会将其包含在数据馈送中:
-
用户有一个时间戳位于数据馈送频率窗口(数据馈送的给定小时或日期)内的事件。
-
该用户在处理时段 内有时符合_促销活动B_区段 的资格。
例如,9天前符合区段资格的用户包含在数据馈送中。 不包括前最后获得资格的45天用户,因为该事件超出30天处理时段。
会话计算
会话边界是使用处理窗口中的所有事件计算的,而不仅仅是频率窗口中的事件。 在频率窗口之前启动的会话仍被识别为同一会话。
会话ID基于您的数据视图中的人员、会话开始时间和会话设置。 会话在投放之间保留相同的会话ID,以便您可以加入跨多个小时或每日投放的会话中的事件。
使用数据馈送中的会话时,请考虑以下事项:
- 如果会话在处理窗口之前启动,则其早期事件将不可用,因此会话值可能与Analysis Workspace不同。 有关详细信息,请参阅了解数据馈送与Analysis Workspace之间的数据差异。
- 更改数据视图中的会话设置会更改会话ID。 后续投放中的会话ID与早期投放中的会话ID不匹配。
Dimension持久性
在维度上设置持久性时,您还可以设置一个过期时间,以确定维度项在从中设置它的事件之外保持多久。
处理窗口限制每个到期设置的持久性。 不考虑在处理窗口之前设置的值,但 自定义时间 过期除外:
-
会话:值将保留到会话结束为止。 如果会话在处理窗口之前启动,则不会考虑在处理窗口之前设置的值。
-
人员报告窗口:30天的处理窗口用作过期时间。 只有在处理窗口中设置的值会保留。
-
自定义时间:维度上设置的自定义时间的值将保留。 如果自定义时间长于30天处理时段,则数据馈送会在处理时段(最长90天)开始之前进行回顾,这样在处理时段之前设置的维度值可以保留到投放中的事件。
note NOTE 目前,自定义过期时间限制为30天处理时段。 如果自定义时间超过30天,则使用处理窗口代替过期,并且不考虑在处理窗口之前设置的值。 即将支持超出处理时段的自定义时间。 -
量度:在选定量度发生之前,值会一直保留。 不考虑在处理窗口之前设置的值。
有关在数据视图中设置维度的持久性的详细信息,请参阅持久性组件设置。 有关数据馈送中的持久性与Analysis Workspace有何不同的信息,请参阅了解数据馈送和Analysis Workspace之间的数据差异。
示例:
假设您希望在访问您的网站之前,在数据馈送中了解最初看到哪些营销活动。
要完成此操作,请在促销活动维度上设置持久性,其中原始维度作为分配模型,人员报告窗口作为过期时间。
在这种情况下,仅当用户同时满足 和 以下条件时,原始营销活动才会显示在数据馈送输出中:
-
用户有一个时间戳位于数据馈送频率窗口(数据馈送的给定小时或日期)内的事件。
-
在处理时段 内的某个时间该用户符合原始营销活动 的资格。
如果用户在9天前符合原始营销活动的资格,则原始营销活动包含在数据馈送中。 如果用户在45天前符合条件,则不包括原始营销活动,因为它在30天处理窗口之外。
派生字段转换
引用容器的任何派生字段函数都会使用数据馈送导出中的处理窗口。 派生字段中提供了哪些日期功能?
了解处理延迟 data-feed-processing-delay
处理延迟的工作方式
处理延迟是Customer Journey Analytics在处理数据馈送文件之前等待的时间。 在处理延迟期间到达的所有迟到事件都会包含在数据馈送中。
由于各种原因,需要处理延迟,例如为了说明管道延迟,为了让移动设备实施有机会使离线设备联机并发送数据,或者在管理以前处理的文件时适应组织的服务器端流程。
最短处理延迟为 2 小时,但某些类型的数据需要更长的延迟。
示例:
假设每小时数据馈送包括从中午1:00到下午2:00的数据,并且处理延迟为2小时。 对该数据馈送文件的处理于下午4:00开始,包括处理开始前到达的任何数据。
根据您的数据选择处理延迟
不同类型的数据需要经过不同的时间才能在Customer Journey Analytics中使用。 数据经过两个处理阶段,每个阶段的时间将相加为总时间。
选择足够长的处理延迟,以便连接中最慢的数据完成两个阶段。 如果延迟时间过短,仍在处理中的数据将不会包含在数据馈送文件中。
在创建数据馈送时,处理延迟会根据连接中的数据集默认为推荐值。 例如,如果为连接启用了拼接,则默认为6小时。 您可以选择更短的延迟(最少2小时),但会出现警告,因为某些数据可能未包含在数据馈送中。
阶段1:数据到达Experience Platform数据湖
到达时间因您收集的数据类型而异。 选择适合您正在收集的数据类型的延迟。
-
来自Edge Network或流式摄取的事件数据集:数据通常在60分钟内到达数据湖(请参阅延迟)。
-
Analytics源连接器数据集:数据通常在2.25小时内到达数据湖(请参阅延迟)。
-
来自其他源连接器的数据集:延迟因源连接器和发送批次的时间而异。 Experience Platform中的上游处理(例如数据准备)可以添加更多时间。
-
查找数据集:数据到达数据湖的时间取决于数据的上传频率。 查找数据通常作为数据库的完整副本上传,其中只有一小部分记录发生了更改。 以较小的批次上载查找数据以缩短处理时间。
小型上传通常在最小延迟内处理。
大型上传(例如,每周上传数百万条记录)的处理优先级较低,并且可能需要3到4小时的时间。 如果上载量很大,则不会延迟事件数据,但查找值可能不会反映最新的更新。
-
配置文件数据集:数据到达数据湖的时间取决于数据上传的频率。 配置文件数据通常批量摄取,例如完整配置文件表的每日快照。 以较小的批次上载配置文件数据以缩短处理时间。
小型上传通常在最小延迟内处理。
大型上传(例如,每周上传数百万条记录)的处理优先级较低,并且可能需要3到4小时的时间。 在大量上传的情况下,事件数据不会延迟,但配置文件值可能不会反映最新的更新。
阶段2:数据从数据湖摄取到Customer Journey Analytics
根据数据集是否已启用拼合,数据摄取时间会有所不同。
示例:
如果您的连接包含多种类型的数据,请选择包含最慢数据的延迟。 在下面的示例中,大约为8小时。
拼合过程最多需要4小时才能将信息摄取到Customer Journey Analytics中。 因此,对于任何经过拼接的数据,请将延迟时间延长 4 小时。
90分钟
不拼合
90分钟+ 4小时用于拼合
通过拼合