创建和配置数据流

本文档介绍了在 UI 中配置数据流的步骤。

访问数据流工作区

您可以通过在左侧导航中选择​ 数据流 ​来在数据收集 UI 或 Experience Platform UI 中创建和管理数据流。

数据收集 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

设备查找 ​设置允许您选择要收集的特定于设备的信息。

展开​ 设备查找 ​部分以配置下述设置。

数据流配置屏幕中突出显示了设备查找设置。

IMPORTANT
下表中所示的设置是互斥的。 不能同时选择用户代理信息​ ​设备查找数据。
设置
描述
保留用户代理和客户端提示标头
选择此选项可仅收集用户代理字符串中存储的信息。 默认情况下,此设置处于选中状态。 填充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

无法收集设备查找信息以及用户代理和客户端提示。 选择收集设备信息会禁用用户代理和客户端提示的收集,反之亦然。

不收集任何设备信息
如果不想收集任何设备查找信息,请选择此选项。 未收集任何设备、硬件、浏览器、操作系统、用户代理或客户端提示数据。

如果您为数据收集启用以上任何字段,请确保在配置Web SDK时正确设置context数组属性。

设备和硬件信息使用context数组字符串"device",而浏览器和操作系统信息使用context数组字符串"environment"

此外,请确保架构中存在每个所需的XDM字段。 如果不适用,您可以将Adobe提供的Environment Details字段组添加到您的架构中。

配置高级选项 @advanced-options

要显示高级配置选项,请选择​ 高级选项。 在这里,您可以配置其他数据流设置,如IP模糊处理、第一方ID Cookie等。

高级配置选项

IMPORTANT
您有责任确保已获得适用法律和法规规定的收集、处理和传输个人数据(包括精确的地理位置信息)所需的所有必要权限、同意、许可和授权。
您的IP地址模糊处理选择不会影响从IP地址派生并发送到配置的Adobe解决方案的地理位置信息级别。 必须单独限制或禁用地理位置查找。
设置
描述
IP 模糊处理

指示要应用于数据流的 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
  • 完全:对整个 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

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
第一方 ID Cookie
启用后,此设置将告知 Edge Network 在查找第一方设备 ID 时引用指定的 Cookie,而不是在“标识映射”中查找该值。

在启用此设置时,必须提供应存储ID的Cookie的名称。
第三方 ID 同步
ID 同步可分组到容器中,以允许不同的 ID 同步在不同时间运行。启用后,此设置可让您指定为该数据流运行哪个 ID 同步容器。
第三方 ID 同步容器 ID
要用于第三方 ID 同步的容器的数字 ID。
容器 ID 覆盖
在此部分中,您可以定义其他第三方ID同步容器ID,以将其用于覆盖默认ID。
访问类型

为数据流定义 Edge Network 接受的身份验证类型。

  • 混合身份验证:选择此选项时,Edge Network 接受经过身份验证和未经身份验证的请求。当您计划使用 Web SDK 或 Mobile SDK服务器 API,请选择此选项。
  • 仅经过身份验证:选择此选项时,Edge Network 仅接受经过身份验证的请求。当您计划仅使用服务器 API 并希望防止 Edge Network 处理任何未经身份验证的请求时,请选择此选项。
Media Analytics
启用流跟踪数据的处理,以便通过Experience PlatformSDK或Media Edge API进行Edge Network集成。 从文档了解Media Analytics。

从该位置,如果您要为 Experience Platform 配置数据流,请按照为数据收集准备数据教程操作,在返回本指南之前将您的数据映射到 Platform 事件架构。否则,请选择​ 保存 ​并继续下一部分。

查看数据流详细信息 view-details

在配置新的数据流或选择要查看的现有数据流后,将显示该数据流的详细信息页面。在该页面中,可以找到有关数据流的更多信息,包括其 ID。

数据流详细信息页面。

从数据流详细信息屏幕中,可以添加服务以启用您有权访问的 Adobe Experience Cloud 产品中的功能。您还可以编辑数据流的基本配置、更新其映射规则复制数据流或将其完全删除。

将服务添加到数据流 add-services

在数据流的详细信息页面上,选择​ 添加服务 ​以开始为该数据流添加可用服务。

选择“添加服务”以继续。

在下一个屏幕上,使用下拉菜单选择要为此数据流配置的服务。此列表中仅显示您有权访问的服务。

从列表中选择服务。

选择所需的服务,填写显示的配置选项,然后选择​ 保存 ​以将服务添加到数据流。所有添加的服务都会显示在数据流的详细信息视图中。

添加到数据流的服务

以下子部分描述了每项服务的配置选项。

NOTE
每个服务配置均包含一个​ 已启用 ​开关,它在选择服务时自动激活。要禁用此数据流的选定服务,请再次选择​ 已启用 ​开关。

Adobe Analytics 设置 analytics

此服务控制数据是否以及如何发送到 Adobe Analytics。请参阅将数据发送到Adobe Analytics

Adobe Analytics数据流设置。

设置
描述
报表包 ID
(必需) ​要将数据发送到的 Analytics 报表包的 ID。可以在 Adobe Analytics UI 中的管理员 > 报表包下找到此 ID。如果指定了多个报表包,则数据将复制到每个报表包。
访客ID命名空间
(可选)要用于Adobe Analytics visitorID的命名空间。 当您发送一个具有为此命名空间指定的值的事件时,它将自动用作Analytics中的visitorID
报表包覆盖
在此部分中,您可以添加其他报表包 ID,它们可用于覆盖默认报表包 ID。

Adobe Audience Manager 设置 audience-manager

此服务控制数据是否以及如何发送到 Adobe Audience Manager。只需启用此部分即可将数据发送到 Audience Manager。其他设置是可选的,但建议使用。

Adobe的受众管理数据流设置。

设置
描述
已启用 Cookie 目标
允许 SDK 通过 Cookie 目标从 Audience Manager 共享区段信息。
已启用 URL 目标
允许 SDK 通过 URL 目标从 Audience Manager 共享区段信息。

Adobe Experience Platform 设置 aep

IMPORTANT
为 Platform 启用数据流时,请记下您当前正在使用的 Platform 沙盒,如 UI 的顶部功能区中所示。
选定的沙盒
沙盒是 Adobe Experience Platform 中的虚拟分区,可让您将您的数据和实施与组织中的其他数据和实施隔离开来。一旦创建数据流,其沙盒便无法更改。有关沙盒在 Experience Platform 中发挥的作用的更多详细信息,请参阅沙盒文档

此服务控制数据是否以及如何发送到 Adobe Experience Platform。

Adobe Experience Platform数据流设置。

设置
描述
事件数据集
(必需) ​选择客户事件数据将流式传输到的 Platform 数据集。此架构必须使用 XDM ExperienceEvent 类。要添加其他数据集,请选择​ 添加事件数据集
配置文件数据集
选择客户属性数据将发送到的 Platform 数据集。此架构必须使用 XDM 单个配置文件类
Offer Decisioning
为Web SDK实施启用Offer decisioning。 有关更多实现详细信息,请参阅有关将Offer decisioning与Web SDK结合使用的指南

有关 Offer Decisioning 功能的更多信息,请参阅 Adobe Journey Optimizer 文档
边缘分段
为此数据流启用边缘分段。 当Web SDKEdge Network服务器API通过启用了边缘分段的数据流发送数据时,相关个人资料的任何更新受众成员资格将在响应中发送回。

您可以通过Edge目标或Offer Decisioning将此选项与​ Personalization目标 ​结合用于同页和下一页个性化用例。
个性化目标
如果在选中边缘分段复选框后启用此选项,将允许数据流连接到个性化目标,例如自定义个性化

有关配置个性化目标的具体步骤,请参阅目标文档。
Adobe Journey Optimizer
为此数据流启用Adobe Journey Optimizer

启用此选项将允许数据流从 Adobe Journey Optimizer 中基于 Web 和应用程序的入站营销活动返回个性化内容。此选项要求边缘分段处于活动状态。如果未选中Edge分段,则此选项将灰显。

Adobe Target 设置 target

此服务控制数据是否以及如何发送到 Adobe Target。

Adobe Target数据流设置。

设置
描述
属性令牌
Target允许客户使用属性控制权限。 有关属性的更多信息,请参阅 Target 文档中有关配置企业权限的指南。

可以在 Adobe Target UI 中的设置 > 属性下找到属性令牌。
Target 环境 ID
Adobe Target 中的环境可帮助您在开发过程的所有阶段管理实施。此设置指定您将用于此数据流的环境。

最佳实践是为每个 devstageprod 数据流环境进行不同设置,以简化操作。但是,如果您已定义 Adobe Target 环境,则可以使用这些环境。
Target 第三方 ID 命名空间
要用于此数据流的 mbox3rdPartyId 的标识命名空间。如果您使用与Adobe Target的Customer Attributes集成,或使用thirdPartyId通过Adobe Target配置文件API更新或创建配置文件,则必须提供您选择的命名空间值。 您必须在XDM架构的IdentityMap部分使用此命名空间来发送在客户属性文件上传或配置文件更新API调用中使用的customerIDthirdPartyId。 有关更多信息,请参阅有关使用 Web SDK 实施 mbox3rdPartyId 的指南。
属性令牌覆盖
在此部分中,您可以定义其他可用于覆盖默认属性令牌的属性。

事件转发设置

此服务控制数据是否以及如何发送到事件转发

数据流配置屏幕的 事件转发部分。

设置
描述
Launch 属性
(必需) ​要将数据发送到的事件转发属性。
Launch 环境
(必需) ​要将数据发送到的所选属性中的环境。
NOTE
您可以选择​ 手动输入 ID 以键入属性和环境名称,而不是使用下拉菜单。

复制数据流 copy

您可以创建现有数据流的副本并根据需要更改其详细信息。

NOTE
数据流只能在同一个沙盒中复制。换句话说,您无法将数据流从一个沙盒复制到另一个沙盒。

从数据流工作区的主页中,为相关数据流选择省略号 (),然后选择​ 复制

显示正在从数据流列表视图中选择的复制选项的图像。

或者,您可以从给定数据流的详细信息视图中选择​ 复制数据流

从数据流详细信息视图中选择的复制选项。

将出现一个确认对话框,提示您为要创建的新数据流提供唯一名称,以及有关将复制的配置选项的详细信息。准备就绪后,选择​ 复制

复制数据流的确认对话框。

数据流工作区的主页将重新出现,并列出了新数据流。

后续步骤

本指南介绍如何在数据收集 UI 中管理数据流。有关如何在设置数据流后安装和配置 Web SDK 的更多信息,请参阅数据收集 E2E 指南

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac