创建和配置数据流
本文档介绍了在 UI 中配置数据流的步骤。
访问数据流工作区
您可以通过在左侧导航中选择 数据流 来在数据收集 UI 或 Experience Platform UI 中创建和管理数据流。
数据流 选项卡显示现有数据流的列表,包括其友好名称、ID 和上次修改日期。要查看其详细信息并配置服务,请选择数据流的名称。
要显示特定数据流的更多选项,请选择“更多”图标(…)。 要更新数据流的基本配置,请选择 编辑。 要删除数据流,请选择 删除。
创建数据流 create
要创建数据流,请首先选择 新数据流。
数据流创建工作流随即出现,从配置步骤开始。从该位置,您必须提供数据流的名称和可选描述。
如果配置数据流以用于Experience Platform,并且还使用Web SDK,则还必须选择基于事件的体验数据模型(XDM)架构来表示您计划引入的数据。
配置地理位置和网络查找 geolocation-network-lookup
地理位置和网络查找设置可帮助您定义要收集的地理和网络级别数据的粒度级别。
展开 地理位置和网络查找 部分以配置下述设置。
根据访客的IP地址为所选选项启用地理位置查找。 可用选项包括:
- 国家/地区:填充
xdm.placeContext.geo.countryCode
- 邮政编码:填充
xdm.placeContext.geo.postalCode
- 州/省:填充
xdm.placeContext.geo.stateProvince
- DMA:填充
xdm.placeContext.geo.dmaID
- 城市:填充
xdm.placeContext.geo.city
- 纬度:填充
xdm.placeContext.geo._schema.latitude
- 经度:填充
xdm.placeContext.geo._schema.longitude
选择 城市、纬度 或 经度 将提供最多两位小数的坐标,而不管选择的其他选项如何。这被视为城市级别的粒度。
不选择任何选项将禁用地理位置查找。 地理位置发生在IP模糊处理之前,这意味着它不受IP模糊处理设置的影响。
根据访客的IP地址启用所选选项的网络查找。 可用选项包括:
- 移动设备运营商:填充
xdm.environment.carrier
- 域:填充
xdm.environment.domain
- ISP:填充
xdm.environment.ISP
- 连接类型:填充
xdm.environment.connectionType
如果您为数据收集启用以上任何字段,请确保在配置Web SDK时正确设置context
数组属性。
地理位置查找字段使用context
数组字符串"placeContext"
,而网络查找字段使用context
数组字符串"environment"
。
此外,请确保架构中存在每个所需的XDM字段。 如果不适用,您可以将Adobe提供的Environment Details
字段组添加到您的架构中。
配置设备查找 geolocation-device-lookup
设备查找 设置允许您选择要收集的特定于设备的信息。
展开 设备查找 部分以配置下述设置。
xdm.environment.browserDetails.userAgent
如果要收集以下一个或多个特定于设备的信息,请选择此选项:
-
设备 信息:
- 设备制造商:填充
xdm.device.manufacturer
- 设备模型:填充
xdm.device.modelNumber
- 营销名称:填充
xdm.device.model
- 设备制造商:填充
-
硬件 信息:
- 硬件类型:填充
xdm.device.type
- 显示高度:填充
xdm.device.screenHeight
- 显示宽度:填充
xdm.device.screenWidth
- 显示颜色深度:填充
xdm.device.colorDepth
- 硬件类型:填充
-
浏览器 信息:
- 浏览器供应商:填充
xdm.environment.browserDetails.vendor
- 浏览器名称:填充
xdm.environment.browserDetails.name
- 浏览器版本:填充
xdm.environment.browserDetails.version
- 浏览器供应商:填充
-
操作系统 信息:
- OS供应商:填充
xdm.environment.operatingSystemVendor
- OS名称:填充
xdm.environment.operatingSystem
- OS版本:填充
xdm.environment.operatingSystemVersion
- OS供应商:填充
无法收集设备查找信息以及用户代理和客户端提示。 选择收集设备信息会禁用用户代理和客户端提示的收集,反之亦然。
如果您为数据收集启用以上任何字段,请确保在配置Web SDK时正确设置context
数组属性。
设备和硬件信息使用context
数组字符串"device"
,而浏览器和操作系统信息使用context
数组字符串"environment"
。
此外,请确保架构中存在每个所需的XDM字段。 如果不适用,您可以将Adobe提供的Environment Details
字段组添加到您的架构中。
配置高级选项 @advanced-options
要显示高级配置选项,请选择 高级选项。 在这里,您可以配置其他数据流设置,如IP模糊处理、第一方ID Cookie等。
指示要应用于数据流的 IP 模糊处理的类型。任何基于客户IP的处理都受IP模糊设置的影响。 这包括从数据流接收数据的所有 Experience Cloud 服务。
可用选项:
-
无:禁用 IP 模糊处理。完整用户IP地址通过数据流发送。
-
部分:对于 IPv4 地址,对用户 IP 地址的最后一个八位字节进行模糊处理。对于 IPv6 地址,对地址的最后 80 位进行模糊处理。
示例:
- IPv4:
1.2.3.4
->1.2.3.0
- IPv6:
2001:0db8:1345:fd27:0000:ff00:0042:8329
->2001:0db8:1345:0000:0000:0000:0000:0000
- IPv4:
-
完全:对整个 IP 地址进行模糊处理。
示例:
- IPv4:
1.2.3.4
->0.0.0.0
- IPv6:
2001:0db8:1345:fd27:0000:ff00:0042:8329
->0:0:0:0:0:0:0:0
- IPv4:
IP 模糊处理对其他 Adobe 产品的影响:
- Adobe Target:在Adobe Target中执行IP模糊处理之前,将数据流级别IP模糊处理应用于请求上存在的所有IP地址。 例如,如果数据流级别IP模糊处理选项设置为 Full,而Adobe Target IP模糊处理选项设置为 最后一个八位字节模糊处理,则Adobe Target会收到完全模糊处理的IP。 如果数据流级别IP模糊处理选项设置为 部分,而Adobe Target IP模糊处理选项设置为 完整,则Adobe Target会收到部分模糊处理的IP,然后对其应用完全模糊处理。 Adobe Target IP模糊处理是独立于数据流进行管理的。 请参阅介绍 IP 模糊处理和地理定位的 Adobe Target 文档以了解更多详细信息。
- Audience Manager:在Audience Manager中执行IP模糊处理之前,将数据流级别IP模糊处理设置应用于请求中存在的所有IP地址。 Audience Manager 完成的任何地理位置查找都将受数据流级别的 IP 模糊处理选项的影响。在Audience Manager中,基于完全模糊处理的IP的地理位置查找会生成未知区域,并且任何基于所生成的地理位置数据的区段都不会实现。 请参阅介绍 IP 模糊处理的 Audience Manager 文档以了解更多详细信息。
- Adobe Analytics:如果数据流级别的IP模糊处理设置设置为 完整,Adobe Analytics会将IP地址视为空白。 这会影响任何依赖于IP地址的Analytics处理,例如地理位置查找和IP过滤。 若要让Analytics接收未模糊处理或部分模糊处理的IP地址,请将IP模糊处理设置设置为 部分 或 无。 在Analytics中,可以进一步对部分模糊处理和未模糊处理的IP地址进行模糊处理。 有关如何在Analytics中启用IP模糊处理的详细信息,请参阅Adobe Analytics 文档。 如果IP地址被完全模糊处理,并且页面点击既没有ECID也没有VisitorID,则Analytics将丢弃该点击,而不是生成一个部分基于IP地址的回退ID。
为数据流定义 Edge Network 接受的身份验证类型。
- 混合身份验证:选择此选项时,Edge Network 接受经过身份验证和未经身份验证的请求。当您计划使用 Web SDK 或 Mobile SDK 与服务器 API,请选择此选项。
- 仅经过身份验证:选择此选项时,Edge Network 仅接受经过身份验证的请求。当您计划仅使用服务器 API 并希望防止 Edge Network 处理任何未经身份验证的请求时,请选择此选项。
从该位置,如果您要为 Experience Platform 配置数据流,请按照为数据收集准备数据教程操作,在返回本指南之前将您的数据映射到 Platform 事件架构。否则,请选择 保存 并继续下一部分。
查看数据流详细信息 view-details
在配置新的数据流或选择要查看的现有数据流后,将显示该数据流的详细信息页面。在该页面中,可以找到有关数据流的更多信息,包括其 ID。
从数据流详细信息屏幕中,可以添加服务以启用您有权访问的 Adobe Experience Cloud 产品中的功能。您还可以编辑数据流的基本配置、更新其映射规则、复制数据流或将其完全删除。
将服务添加到数据流 add-services
在数据流的详细信息页面上,选择 添加服务 以开始为该数据流添加可用服务。
在下一个屏幕上,使用下拉菜单选择要为此数据流配置的服务。此列表中仅显示您有权访问的服务。
选择所需的服务,填写显示的配置选项,然后选择 保存 以将服务添加到数据流。所有添加的服务都会显示在数据流的详细信息视图中。
以下子部分描述了每项服务的配置选项。
Adobe Analytics 设置 analytics
此服务控制数据是否以及如何发送到 Adobe Analytics。请参阅将数据发送到Adobe Analytics。
visitorID
。Adobe Audience Manager 设置 audience-manager
此服务控制数据是否以及如何发送到 Adobe Audience Manager。只需启用此部分即可将数据发送到 Audience Manager。其他设置是可选的,但建议使用。
Adobe Experience Platform 设置 aep
此服务控制数据是否以及如何发送到 Adobe Experience Platform。
有关 Offer Decisioning 功能的更多信息,请参阅 Adobe Journey Optimizer 文档。
您可以通过Edge目标或Offer Decisioning将此选项与 Personalization目标 结合用于同页和下一页个性化用例。
启用此选项将允许数据流从 Adobe Journey Optimizer 中基于 Web 和应用程序的入站营销活动返回个性化内容。此选项要求边缘分段处于活动状态。如果未选中Edge分段,则此选项将灰显。
Adobe Target 设置 target
此服务控制数据是否以及如何发送到 Adobe Target。
最佳实践是为每个
dev
、stage
和 prod
数据流环境进行不同设置,以简化操作。但是,如果您已定义 Adobe Target 环境,则可以使用这些环境。mbox3rdPartyId
的标识命名空间。如果您使用与Adobe Target的Customer Attributes集成,或使用thirdPartyId
通过Adobe Target配置文件API更新或创建配置文件,则必须提供您选择的命名空间值。 您必须在XDM架构的IdentityMap
部分使用此命名空间来发送在客户属性文件上传或配置文件更新API调用中使用的customerID
或thirdPartyId
。 有关更多信息,请参阅有关使用 Web SDK 实施 mbox3rdPartyId
的指南。事件转发设置
此服务控制数据是否以及如何发送到事件转发。
数据流配置屏幕的
复制数据流 copy
您可以创建现有数据流的副本并根据需要更改其详细信息。
从数据流工作区的主页中,为相关数据流选择省略号 (…),然后选择 复制。
或者,您可以从给定数据流的详细信息视图中选择 复制数据流。
将出现一个确认对话框,提示您为要创建的新数据流提供唯一名称,以及有关将复制的配置选项的详细信息。准备就绪后,选择 复制。
数据流工作区的主页将重新出现,并列出了新数据流。
后续步骤
本指南介绍如何在数据收集 UI 中管理数据流。有关如何在设置数据流后安装和配置 Web SDK 的更多信息,请参阅数据收集 E2E 指南。