在UI中创建Adobe Analytics源连接

本教程提供了在UI中创建Adobe Analytics源连接的步骤,以便将Adobe Analytics报表包数据引入Adobe Experience Platform。

快速入门

本教程需要对以下Experience Platform组件有一定的了解:

  • Experience Data Model (XDM)系统:Experience Platform用于组织客户体验数据的标准化框架。
  • Real-time Customer Profile:根据来自多个来源的汇总数据提供统一的实时使用者个人资料。
  • 沙盒:Experience Platform提供了可将单个Platform实例划分为多个单独的虚拟环境的虚拟沙箱,以帮助开发和改进数字体验应用程序。

关键术语

请务必了解本文档中使用的以下关键术语:

  • 标准属性:标准属性是Adobe预定义的任何属性。 它们对于所有客户具有相同的含义,并且在 Analytics 源数据和 Analytics 架构字段组。
  • 自定义属性:自定义属性是中自定义变量层次结构中的任何属性 Analytics. 在Adobe Analytics实施中使用自定义属性将特定信息捕获到报表包中,这些属性的使用因报表包而异。 自定义属性包括eVar、prop和列表。 请参阅以下内容 Analytics 有关转化变量的文档 以了解有关eVar的更多信息。
  • 自定义字段组中的任何属性:源自客户创建的字段组的属性都是用户定义的属性,既不是标准属性,也不是自定义属性。
  • 友好名称:友好名称是中由人工提供的自定义变量标签 Analytics 实现。 请参阅以下内容 Analytics 有关转化变量的文档 以了解有关友好名称的详细信息。

创建与Adobe Analytics的源连接

NOTE
在生产沙盒中创建Analytics源数据流时,将创建两个数据流:
  • 一个数据流,将历史报表包数据回填到13个月的数据湖。 此数据流在回填完成后结束。
  • 将实时数据发送到数据湖和的数据流 Real-Time Customer Profile. 此数据流持续运行。

在Platform UI中,选择 从左侧导航访问 源 工作区。 此 目录 屏幕中显示多种来源,您可以使用这些来源创建帐户。

您可以从屏幕左侧的目录中选择相应的类别。 您还可以使用搜索栏缩小显示的源。

Adobe应用程序 类别,选择 Adobe Analytics 然后选择 添加数据.

目录

选择数据

IMPORTANT
屏幕上列出的报表包可能来自不同的区域。 您有责任了解您的数据限制和义务,以及如何跨地区在Adobe Experience Platform中使用这些数据。 请确保贵公司允许这样做。

Analytics源添加数据 步骤为您提供以下列表 Analytics 用于创建源连接的报表包数据。

报表包是构成基础的数据容器 Analytics 报表。 一个组织可以有多个报表包,每个报表包中包含不同的数据集。

您可以从任何区域(美国、英国或新加坡)摄取报告包,前提是它们映射到与在中创建源连接的Experience Platform沙盒实例相同的组织。 只能使用单个活动数据流摄取报表包。 已在您使用的沙盒或其他沙盒中摄取不可选的报告包。

可以建立多个绑定内连接,将多个报表包纳入同一沙盒中。 如果报表包具有不同的变量架构(例如eVar或事件),则应将其映射到自定义字段组中的特定字段,并使用避免数据冲突 数据准备. 只能将报表包添加到单个沙盒中。

NOTE
只有不存在数据冲突(例如两个含义不同的自定义属性(eVar、列表和prop)),才能为实时客户资料启用多个报表包的数据。

创建 Analytics 源连接,选择一个报表包,然后选择 下一个 以继续。

<!—Analytics报告包一次只能为一个沙盒配置。 要将同一报表包导入其他沙盒,必须通过对其他沙盒的配置删除数据集流并重新实例化。—>

映射

IMPORTANT
数据准备转换可能会增加整个数据流的延迟。 附加的延迟因转换逻辑的复杂性而异。

在映射您的 Analytics 将数据定位到XDM架构,您必须首先选择是使用默认架构还是自定义架构。

默认架构代表您创建新架构,包含 Adobe Analytics ExperienceEvent Template 字段组。 要使用默认架构,请选择 默认架构.

default-schema

使用自定义架构,您可以为您的选择任何可用的架构 Analytics 数据,只要该架构具有 Adobe Analytics ExperienceEvent Template 字段组。 要使用自定义架构,请选择 自定义架构.

custom-schema

此 映射 页面提供了一个将源字段映射到其相应目标架构字段的界面。 在此处,您可以将自定义变量映射到新架构字段组并应用数据准备支持的计算。 选择目标架构以启动映射过程。

TIP
仅限具有以下特征的架构: Adobe Analytics ExperienceEvent Template 字段组显示在架构选择菜单中。 忽略其他架构。 如果您的报表包数据没有合适的架构,则必须创建新架构。 有关创建架构的详细步骤,请参阅 在UI中创建和编辑架构.

select-schema

此 映射标准字段 部分显示面板 应用的标准映射, 不匹配的标准映射 和 自定义映射. 有关每个类别的具体信息,请参阅下表:

映射标准字段
描述
应用的标准映射
此 应用的标准映射 面板显示已映射属性的总数。 标准映射是指源中所有属性之间的映射集 Analytics 中的数据和相应属性 Analytics 字段组。 它们是预映射的,无法编辑。
不匹配的标准映射
此 不匹配的标准映射 面板是指包含友好名称冲突的映射属性的数量。 如果您重复使用的架构已填充了来自其他报表包的字段描述符集,则会出现这些冲突。 您可以继续您的 Analytics 即使存在友好名称冲突的数据流。
自定义映射
此 自定义映射 面板显示映射的自定义属性的数量,包括eVar、prop和列表。 自定义映射是指源中自定义属性之间的映射集 Analytics 所选架构中包含的自定义字段组中的数据和属性。

map-standard-fields

要预览 Analytics ExperienceEvent模板架构字段组,选择 视图 在 应用的标准映射 面板。

视图

此 Adobe Analytics ExperienceEvent模板架构字段组 页面为您提供了一个用于检查架构结构的界面。 完成后,选择 关闭.

field-group-preview

Platform会自动检测您的映射集是否存在任何友好名称冲突。 如果映射集没有冲突,请选择 下一个 以继续。

映射

TIP
如果源报表包与所选架构之间存在友好名称冲突,您仍可以继续使用 Analytics 数据流,确认不会更改字段描述符。 或者,您可以选择使用一组空白描述符创建新架构。

自定义映射

您可以使用数据准备函数为自定义属性添加新的自定义映射或计算字段。 要添加自定义映射,请选择 自定义.

自定义

根据需要,您可以选择以下任一选项 添加新映射添加计算字段 ,然后继续为自定义属性创建自定义映射。 有关如何使用数据准备功能的完整步骤,请参阅 数据准备UI指南.

以下文档提供了有关了解数据准备、计算字段和映射函数的更多资源:

筛选实时客户配置文件 filtering-for-profile

完成映射后, Analytics 报表包数据之后,您可以应用过滤规则和条件来有选择地将数据包含或排除到实时客户档案的摄取中。 仅支持筛选 Analytics 仅在输入之前过滤数据和数据 Profile. 所有数据都会摄取到数据湖中。

recommendation-more-help

有关为实时客户个人资料准备和筛选Analytics数据的更多信息

  • 您可以将筛选功能用于流向个人资料的数据,但不能用于流向数据湖的数据。
  • 可以对实时数据使用筛选,但无法筛选回填数据。
    • 此 Analytics 源不会将数据回填到配置文件中。
  • 如果您在数据的初始设置期间使用数据准备配置, Analytics 流量,这些更改也将应用于自动13个月的回填。
    • 但是,不适用于筛选,因为筛选仅保留用于实时数据。
  • 数据准备会同时应用于流摄取路径和批量摄取路径。 如果您修改了现有的数据准备配置,则这些更改会应用到流摄取和批量摄取路径中的新传入数据。
    • 但是,任何数据准备配置均不适用于已引入Experience Platform的数据,无论它是流数据还是批量数据。
  • Analytics中的标准属性始终会自动映射。 因此,不能将转换应用于标准属性。
    • 但是,您可以筛选掉标准属性,只要Identity Service或配置文件中不需要这些属性。
  • 无法使用列级筛选来筛选必填字段和标识字段。
  • 虽然您可以过滤掉次要身份,特别是AAID和AACustomID,但无法过滤ECID。
  • 发生转换错误时,相应的列将导致NULL。

行级筛选

IMPORTANT
使用行级筛选来应用条件并指示要​ 为配置文件提取包含 ​的数据。使用列级过滤功能选择所需的数据列 排除配置文件摄取.

您可以筛选以下项的数据 Profile 在行级别和列级别引入。 行级筛选允许您定义字符串包含、等于、开始或结束于等条件。 您还可以使用行级筛选来连接条件,方法是 AND 以及 OR,并使用否定条件 NOT.

要筛选您的 Analytics 行级别的数据,选择 行筛选器.

row-filter

使用左边栏在架构层次结构中导航,并选择您选择的架构属性以进一步向下钻取特定架构。

左边栏

标识要配置的属性后,选择属性并将其从左边栏拖到筛选面板。

filtering-panel

要配置不同的条件,请选择 等于 然后从显示的下拉列表中选择一个条件。

可配置条件列表包括:

  • equals
  • 不等于
  • 开头为
  • 结束于
  • 结尾不是
  • 包含
  • 不包含
  • exists
  • 不存在

条件

接下来,根据所选的属性输入要包括的值。 在以下示例中, Apple 和 Google 选择作为的一部分进行摄取 制造商 属性。

include-manufacturer

要进一步指定筛选条件,请从架构中添加其他属性,然后根据该属性添加值。 在以下示例中, 模型 属性被添加,模型如 iPhone 13 和 Google Pixel 6 将进行筛选以供摄取。

include-model

要添加新容器,请选择省略号(...)图标,然后选择 添加容器.

add-container

添加新容器后,选择 包括 然后选择 排除 从出现的下拉窗口中。

排除

接下来,通过拖动架构属性并添加其要从筛选中排除的相应值来完成相同的过程。 在以下示例中, iPhone 12, iPhone 12 mini、和 Google Pixel 5 都是从的排除项中过滤而来的 模型 属性,横向排除在外 屏幕方向 ​和型号 A1633 排除自 型号.

完成后,选择 下一个.

exclude-examples

列级筛选

选择 列筛选条件 以应用列级筛选。

column-filter

页面将更新为交互式架构树,在列级别显示架构属性。 在此处,您可以选择要从中排除的数据列 Profile 摄取。 或者,您可以展开列并选择特定的排除属性。

默认情况下,所有 Analytics 转到 Profile 通过此过程,可以从中排除XDM数据的分支 Profile 摄取。

完成后,选择 下一个.

列已选择

筛选次要身份

使用列筛选器从配置文件摄取中排除辅助身份。 要筛选次要身份,请选择 列筛选条件 然后选择 _identities.

仅当标识被标记为次要标识时,该过滤器才适用。 如果选择了身份,但某个事件到达时带有标记为主ID之一,则不会过滤掉这些身份。

次要身份

提供数据流详细信息

数据流详细信息 此时将显示步骤,您必须在该步骤中提供数据流的名称和可选描述。 选择 下一个 完成后。

数据流详细信息

审核

此 审核 此时会显示步骤,允许您在创建新的Analytics数据流之前对其进行查看。 连接的详细信息按类别分组,包括:

  • 连接:显示连接的源平台。
  • 数据类型:显示选定的报表包及其对应的报表包ID。

审核

监测数据流 monitor-your-dataflow

数据流完成后,选择 数据流 ,以监控数据的活动和状态。

已选择数据流选项卡的源目录。

此时将显示您组织中现有Analytics数据流的列表。 在此处,选择一个目标数据集以查看其相应的摄取活动。

您的组织中现有Adobe Analytics数据流的列表。

此 数据集活动 页面提供了有关从Analytics发送到Experience Platform的数据进度的信息。 界面会显示一些量度,例如引入的记录数、引入的批次数量以及失败的批次数量。

源实例化两个数据集流。 一个流表示回填数据,另一个流表示实时数据。 回填数据未配置为摄取到Real-time Customer Profile,而是发送到数据湖,以用于分析和数据科学用例。

有关回填、实时数据及其各自延迟的更多信息,请阅读 Analytics源概述.

给定Adobe 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 8-row-2 9-row-2 layout-auto
量度 描述
批次ID 给定批次的ID。 此值在内部生成。
数据集名称 用于Analytics数据的给定数据集名称。
来源 所摄取数据的来源。
更新 最近的流运行迭代的日期。
数据集中的记录 数据集中的记录总数。 注意:此参数偶尔会显示状态 in-progress. 此状态表示记录摄取过程尚未完成。
新配置文件片段 已摄取的新配置文件片段的总数。
现有配置文件片段 现有配置文件片段的总数。
拼接的身份记录 摄取后拼合在一起的身份记录的总数。
配置文件中的记录 引入到Real-time Customer Profile的记录总数。

后续步骤和其他资源

创建连接后,将自动创建数据流以包含传入数据并使用您选择的架构填充数据集。 此外,还会进行数据回填,并摄取至多 13 个月的历史数据。当初始摄取完成时, Analytics 数据并由下游平台服务使用,例如 Real-Time Customer Profile 和分段服务。 有关更多详细信息,请参阅以下文档:

以下视频旨在支持您了解如何使用Adobe Analytics源连接器摄取数据:

WARNING
此 Platform 以下视频中显示的UI已过期。 有关最新的UI屏幕截图和功能,请参阅上述文档。
337b99bb-92fb-42ae-b6b7-c7042161d089