通过Mobile SDK引入数据
本快速入门指南介绍如何使用Adobe Experience Platform Mobile SDK和Edge Network将移动应用程序跟踪数据直接摄取到Adobe Experience Platform。 然后将这些数据用于Customer Journey Analytics。
要完成此实施,您需要:
-
在 Adobe Experience Platform 中 设置模式和数据集 ,以定义要收集的数据的模型(模式)以及实际收集数据的位置(数据集)。
-
设置数据流 以配置 Adobe Experience Platform Edge Network,将您收集的数据路由到您在 Adobe Experience Platform 中配置的数据集。
-
使用标记 针对移动应用程序中的数据轻松配置规则和数据元素。 然后确保数据发送到在 Adobe Experience Platform Edge Network 上配置的数据流。
-
部署和验证。拥有一个可以迭代标签开发的环境,一旦所有内容都经过验证,就可以在您的生产环境中实时发布。
-
在 Customer Journey Analytics 中 设置连接。此连接应(至少)包含 Adobe Experience Platform 数据集。
-
在 Customer Journey Analytics 中 设置数据视图 以定义要在 Analysis Workspace 中使用的量度和维度。
-
在 Customer Journey Analytics 中 设置一个项目 以构建报告和可视化图表。
设置模式和数据集
要将数据导入 Adobe Experience Platform,首先需要定义要收集的数据。引入 Adobe Experience Platform 的所有数据都必须符合标准的非规范化结构,以便下游功能和特性对其进行识别和操作。体验数据模型(XDM)是一种标准框架,它以架构的形式提供结构。
定义模式后,您可以使用一个或多个数据集来存储和管理数据集合。数据集是用于数据集合(通常是表)的存储和管理结构,其中包含架构(列)和字段(行)。
摄取到 Adobe Experience Platform 中的所有数据都必须符合预定义的模式,然后才能作为数据集保存。
设置模式
您希望使用移动应用程序跟踪用户档案中的一些最小数据,例如场景名称、标识。
您首先需要定义一个模式来模拟此数据。
设置您的模式:
-
在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的 模式。
-
选择 创建架构。
. -
在“创建模式”向导的“选择类”步骤中:
-
选择 体验事件。
note info INFO 体验事件架构用于为配置文件的_行为_建模(如场景名称、要添加到购物车的按钮)。 个人轮廓模式用于对轮廓_属性_(如姓名、电子邮件、性别)建模。 -
选择 下一步。
-
-
在创建架构向导的名称和审核步骤中:
-
为您的架构输入 架构显示名称 和(可选)描述。
-
选择 完成。
-
-
在示例架构的结构选项卡中:
-
在字段组中选择 + 添加。
字段组是可重用的对象和属性集合,可让您轻松扩展模式。
-
在添加字段组对话框中,从列表中选择 AEP Mobile SDK ExperienceEvent 字段组。
您可以选择预览按钮,以查看属于该字段组的字段的预览,例如
application > name
。选择 返回 关闭预览。
-
选择 添加字段组。
-
-
在结构面板中选择模式名称旁边的 +。
-
在字段属性面板中,输入
identification
作为字段名称,输入 标识 作为显示名称,选择 对象 作为类型,并选择 ExperienceEvent Core v2.1 作为字段组。note note NOTE 如果该字段组不可用,请查找另一个包含标识字段的字段组。 或者创建新的字段组和将新的标识字段(如 ecid
、crmId
和其他您需要的字段)添加到该字段组,并选择该新字段组。标识对象将标识功能添加到架构中。 对于您的情况,您希望使用Experience CloudID和电子邮件地址来识别使用移动应用程序的用户档案。 还有许多其他属性可用于跟踪您的人员标识(例如客户ID、忠诚度ID)。
选择 应用 将此对象添加到您的模式中。
-
选择刚刚添加的身份标识对象中的 ecid 字段,选择 身份标识 和 主要身份标识 和 ECID 来自右侧面板中的 身份标识命名空间 列表。
您将 Experience Cloud Identity 指定为 Adobe Experience Platform Identity 服务可用于组合(缝合)具有相同 ECID 的轮廓行为的主要身份。
选择 应用。您会看到 ecid 属性中出现指纹图标。
-
选择刚刚添加的身份标识对象中的 邮件 字段,选择 身份标识 和 邮件 和 身份标识命名空间 列表中的 字段属性 面板。
您将电子邮件地址指定为 Adobe Experience Platform Identity 服务可用于组合(拼接)轮廓行为的另一个标识。
选择 应用。您会看到电子邮件属性中显示指纹图标。
选择 保存。
-
选择显示模式名称的模式的根元素,然后选择 轮廓 开关。
系统会提示您启用轮廓的模式。一旦启用,当数据被引入基于此模式的数据集中时,该数据将合并到实时客户轮廓。
有关详细信息,请参阅启用模式以在实时客户轮廓中使用。
note important IMPORTANT 一旦您保存了为轮廓启用的模式,就不能再为轮廓禁用它。 -
选择 保存 以保存模式。
您已创建一个最小架构,用于为您可从移动应用程序中捕获的数据建模。 该模式允许使用 Experience Cloud Identity 和电子邮件地址来识别轮廓。通过为配置文件启用架构,您可以确保将从移动应用程序捕获的数据添加到实时客户配置文件。
除了行为数据之外,您还可以从移动应用程序捕获配置文件属性数据(例如订阅新闻通讯的配置文件详细信息)。
要捕获用户档案数据,您应:
-
基于 XDM 个人轮廓类创建模式。
-
将 Profile Core v2 字段组添加到模式中。
-
添加基于 Profile Core v2 字段组的标识对象。
-
将Experience CloudID定义为主标识符,将电子邮件定义为标识符。
-
为轮廓启用模式
请参阅在 UI 中创建和编辑模式,了解有关向模式添加和删除字段组和单个字段的更多信息。
设置数据集
使用您的模式,您已经定义了数据模型。现在,您必须定义结构以使用数据集存储和管理这些数据。
设置您的数据集
-
在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的 数据集。
-
选择 创建数据集。
-
选择 使用模式创建数据集。
-
选择您之前创建的模式,然后选择 下一个。
-
为您的数据集命名并(可选)提供描述。
-
选择 完成。
-
选择 轮廓 开关
系统会提示您启用轮廓的数据集。启用后,数据集会使用其摄取的数据丰富实时客户轮廓。
note important IMPORTANT 只有当数据集所依附的模式也为轮廓启用时,您才能为轮廓启用数据集。
有关如何查看、预览、创建和删除数据集的更多信息,请参阅数据集 UI 指南。以及如何为实时客户轮廓启用数据集。
设置数据流
数据流表示实施 Adobe Experience Platform Web 和移动 SDK 时的服务器端配置。使用 Adobe Experience Platform SDK 收集数据时,数据会发送到 Adobe Experience Platform Edge Network。它是确定数据转发到哪些服务的数据流。
在设置中,您希望将从移动应用程序中收集的数据发送到Adobe Experience Platform中的数据集。
设置您的数据流
-
在 Adobe Experience Platform UI 的左边栏中,选择 数据收藏集 中的 数据流。
-
选择 新数据流。
-
命名并描述您的数据流。从 事件模式 列表中选择您的模式。
-
选择 保存。
-
选择 添加服务。
-
在 添加服务屏幕:
-
从 服务 列表中选择 Adobe Experience Platform。
-
确保选择 Enabled。
-
从 事件数据集 列表中选择您的数据集。
-
保留其他设置并选择 保存 以保存数据流。
-
您的数据流现在配置为将从移动应用程序收集的数据转发到Adobe Experience Platform中的数据集。
有关如何配置数据流和如何处理敏感数据的更多信息,请参阅数据流概述。
使用标签
要在您的网站上实施代码以实际收集数据,请使用Adobe Experience Platform中的标记功能。 这一款标记管理解决方案,可让您在满足其他标记要求的同时部署代码。标记通过Adobe Experience Platform Mobile Adobe Experience Platform扩展提供了与SDK的无缝集成。
创建您的标记
-
在 Adobe Experience Platform UI 的左边栏中,选择 数据收藏集 中的 标签。
-
选择 新属性。
为标记命名,选择 移动设备。 选择 保存 继续。
配置您的标签
创建标签后,您需要使用正确的扩展名对其进行配置,并根据您希望如何跟踪站点并将数据发送到 Adobe Experience Platform 配置数据元素和规则。
要配置,请从标记属性列表中选择新创建的标记。
扩展
将Adobe平台Edge Network扩展添加到您的标记中,以确保您可以(通过数据流)将数据发送到Adobe Experience Platform。
要创建并配置Adobe Experience Platform Mobile SDK扩展,请执行以下操作:
-
在左边栏中选择 扩展。 您会看到移动核心扩展和配置文件扩展已经可用。
-
在顶部栏中选择 目录 。
-
搜索或滚动到 Adobe Experience PlatformEdge Network 扩展,然后在右侧窗格中选择 安装 以安装该扩展。
-
选择您的沙盒和您之前为您的生产环境和(可选)暂存环境和创建的数据流开发环境。
-
在域配置下输入您的 Edge Network域。 通常使用
<organizationName>.data.adobedc.net
。 -
选择 保存。
有关详细信息,请参阅配置Adobe Experience PlatformEdge Network扩展。
您还需要从目录设置以下其他扩展:
- 身份。
- AEP Assurance。
- 同意。
有关扩展及其配置的更多信息,请参阅Experience Platform的移动应用程序教程中的配置标记属性。
数据元素
数据元素是数据词典(或数据映射)的构建块。使用数据元素可跨市场营销和广告技术收集、组织和交付数据。您可以在标记中设置数据元素,该数据元素可从移动设备应用程序数据或事件中读取,并可用于将数据交付到Adobe Experience Platform中。
例如,要从移动设备应用程序中收集运营商名称。
要定义运营商名称数据元素,请执行以下操作:
-
选择左边栏中的 数据元素。
-
选择 添加数据元素。
-
在创建数据元素对话框中:
-
为数据元素命名,例如,
Carrier Name
。 -
从扩展列表中选择 移动核心。
-
从数据元素类型列表中选择 运营商名称。
-
选择 保存。
-
您可以创建所需数量的数据元素,并在规则中使用它们。
规则
Adobe Experience Platform 中的标签遵循基于规则的系统。他们寻找用户交互和相关数据。如果满足您的规则中所列的标准,则规则会触发您已识别的扩展、脚本或客户端代码。您可以使用规则通过Adobe Experience PlatformEdge Network扩展将数据发送到Adobe Experience Platform中(如XDM对象)。
例如,您希望在使用移动设备应用程序时(在前台)和不使用移动设备应用程序时(推送回后台)发送事件数据。
去定义规则
-
选择左边栏中的 规则。
-
选择 创建新规则。
-
在创建规则对话框中:
-
命名规则,例如
Application Status
。 -
选择并在事件下方 +添加
-
在事件配置对话框中:
-
从扩展列表中选择 移动核心。
-
从事件类型列表中选择 前台。
-
选择 保留更改。
-
-
单击移动核心 — 前台旁边的
-
从扩展列表中选择 移动核心。
-
从事件类型列表中选择 背景。
-
选择 保留更改。
-
-
单击ACTIONS下的
-
从扩展列表中选择 Adobe Experience PlatformEdge Network。
-
从操作类型列表中选择 将事件转发到Edge Network。
-
选择 保留更改。
-
-
您的规则应如下所示:
-
选择 保存。
-
以上只是定义规则的示例,该规则会将包含应用程序状态的XDM数据发送到Adobe Edge网络和Adobe Experience Platform。
您可以在标记中以各种方式使用规则来操作变量(使用数据元素)。
有关详细信息,请参阅规则。
生成并发布标签
在定义了数据元素和规则之后,您需要构建和发布标签。创建库生成时,必须将其分配给环境。然后,将会编译该内部版本的扩展、规则和数据元素,并将这些内容放入分配的环境。每个环境都提供了一个唯一的嵌入代码,从而允许您将其分配的内部版本集成到网站中。
要生成并发布您的标签:
-
从左边栏中选择 发布流。
-
选择 选择工作库,然后选择 添加库…。
-
在创建库对话框中:
-
命名库。
-
选择 开发(开发) 环境 列表。
-
选择 + 添加所有更改的资源。
-
选择 保存并生成到开发。
您的标记已保存并为开发环境构建。 绿色圆点表示在开发环境中成功构建了标记。
-
-
您可以选择 … 重建库或将库移动到临时或生产环境。
Adobe Experience Platform标记支持从简单到复杂的发布工作流程,这些工作流程应该可以适应Adobe Experience PlatformEdge Network的部署。
有关详细信息,请参阅 发布概述 。
检索您的标签代码
最后,您需要在要跟踪的移动应用程序中使用标记。
要获取说明如何设置移动应用程序并在应用程序中使用标记的代码说明,请执行以下操作:
-
选择左边栏中的 环境。
-
从环境列表中选择正确的安装
在移动设备安装说明对话框中,选择适当的平台(iOS,Android)。 然后,使用要用于设置和初始化移动设备应用程序的每个相关代码片段旁边的复制
-
选择 关闭。
您可能已根据部署Adobe Experience Platform Mobile SDK的过程中所处的位置选择其他环境(暂存、生产),而不是开发环境的代码。
有关详细信息,请参阅 环境 。
部署和验证
您现在可以在移动应用程序中部署代码。 部署后,您的移动应用程序会开始将数据收集到Adobe Experience Platform中。
验证您的实现,在必要时进行更正,更正后,使用标签的发布工作流功能将其部署到您的暂存和生产环境中。
有关更多详细信息,请参阅在移动应用程序中实施Adobe Experience Cloud教程。
设置连接
要在 Customer Journey Analytics 中使用 Adobe Experience Platform 数据,您需要创建一个连接,其中包含因设置模式、数据集和工作流所产生的数据。
通过创建连接,您可以将 Adobe Experience Platform 中的数据集集成到工作区中。要报告这些数据集,您必须首先在Adobe Experience Platform和Workspace中的数据集之间建立连接。
创建您的连接:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 连接。
-
选择 创建新连接。
-
在无标题连接屏幕中:
在连接设置中命名并描述您的连接。
从数据设置中的沙盒列表中选择正确的沙盒,并从平均每日事件数列表中选定每日事件数。
选择 添加数据集。
在添加数据集的选择数据集步骤中:
-
选择您之前创建的数据集和/或要包含在连接中的其他相关数据集(例如来自Adobe Journey Optimizer的推送跟踪体验事件数据和推送配置文件数据)
-
选择 下一步。
在添加数据集的设置数据集步骤中:
-
对于每个数据集:
-
在 Adobe Experience Platform 中,从在数据集模式中定义的可用身份标识中选择人员 ID。
-
从数据源类型列表中选择正确的数据源。如果指定 其他,则为您的数据源添加描述。
-
根据您的首选项设置 导入所有新数据 和 数据集回填现有数据。
-
-
选择 添加数据集。
选择 保存。
-
有关如何创建和管理连接以及如何选择和组合数据集的更多信息请参阅连接概述。
设置数据视图
数据视图是 Customer Journey Analytics 专属的容器,通过它,可决定如何解释来自连接的数据。 它指定所有可在 Analysis Workspace 中找到的维度和量度,以及这些维度和量度从哪些列获取其数据。为准备 Analysis Workspace 中的报告而定义数据视图。
创建您的数据视图:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 数据视图。
-
选择 创建新数据视图。
-
在配置步骤中:
从连接列表中选择您的连接。
名称并(可选)描述您的连接。
选择 保存并继续。
-
在组件步骤中:
将要包含的任何模式字段和/或标准组件添加到量度或维度组件框中。
选择 保存并继续。
-
在设置步骤中:
保持设置不变并选择 保存并完成。
请参阅数据视图概述,了解有关如何创建和编辑数据视图、哪些组件可供您在数据视图中使用以及如何使用过滤器和会话的更多信息设置。
设置项目
Analysis Workspace 是一个灵活的浏览器工具,允许您快速构建分析并基于数据共享见解。您可以使用工作区项目来组合数据组件、表和可视化,以制作分析并与组织中的任何人共享。
要创建您的项目:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 项目。
-
选择左侧导航中的 项目。
-
选择 创建项目。
选择 空白项目。
-
从列表中选择您的数据视图。
-
要创建您的第一个报告,请在面板中的自由格式表上开始拖放维度和量度。 例如,将
Events
作为量度拖动,将Push Title
作为维度拖动,并按Event Type
进行划分,即可大致了解移动应用程序的推送通知以及推送通知发生的情况。
请参阅 Analysis Workspace 概述,了解有关如何使用组件、可视化和面板创建项目和构建分析的更多信息。