收錄和使用 Experience Platform 受众
本用例探索了一个将Experience Platform受众摄取到Customer Journey Analytics的临时解决方案。 这些受众可能创建于Experience Platform区段生成器、51黑料不打烊 Audience Manager或其他工具中,并存储在实时客户档案中。 受众包含一组配置文件ID,以及任何适用的属性、事件等。 您希望将该受众数据纳入Customer Journey Analytics以进行进一步分析。
先决条件
- 访问Experience Platform,特别是实时客户个人资料。
 - 创建和管理Experience Platform 架构和数据集的访问权限。
 - 访问Experience Platform查询服务 (以及编写厂蚕尝的能力)。
 - 访问可执行某些数据转换的工具。
 - 访问 Customer Journey Analytics. 您需要是Customer Journey Analytics产物管理员才能创建和修改Customer Journey Analytics连接和数据视图。
 - 验证并访问Experience Platform API(目录服务API和分段服务API)。 您需要在组织和沙盒的“开发人员”控制台中创建项目,并确保您具有成功提交API调用所需的信息。
 
步骤
临时解决方案涉及以下步骤:
选择受众
解决方案首先是要标识要摄取到Customer Journey Analytics的受众。
在 Experience Platform UI 中:
- 
                  
选择?客户 >
 受众。 - 
                  
选择? 浏览 ?并搜索要摄取和用于Customer Journey Analytics的受众。 记下每个受众的? 受众滨顿 ?以供将来使用。
                     
创建启用配置文件的数据集
您需要基于基于核心的? XDM Individual Profile ?架构创建数据集。 在Experience Platform UI中创建数据集时,无法选择该基于核心的XDM Individual Profile作为架构。 请改用目录服务础笔滨基于架构创建数据集_xdm.context.profile__union。
请求
| code language-shell | 
|---|
                      
                     | 
                  
其中:
DATASET_NAME是数据集的友好名称。 例如,Segment Export Job Dataset for CJA。
响应
| code language-json | 
|---|
                      
                     | 
                  
其中:
DATASET_ID是已创建数据集的数据集标识符。
导出受众
将所选受众导出到刚刚创建的数据集中。 使用分段服务础笔滨创建将受众发送到数据集的导出作业。
| code language-shell | 
|---|
                      
                     | 
                  
执行
COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES可能类似于_demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName。 确保您至少包含要在客户历程分析中使用的相关字段(如人员ID(电子邮件))。AUDIENCE_ID_x是要导出的受众的受众标识符。DATASET_ID是您创建的数据集。
响应
| code language-json | 
|---|
                      
                     | 
                  
执行
EXPORT_JOB_ID是导出作业的标识符。
使用分段服务础笔滨检查导出作业的状态。
请求
| code language-shell | 
|---|
                      
                     | 
                  
响应
| code language-json | 
|---|
                      
                     | 
                  
导出作业成功后,验证数据集是否包含已成功摄取的批次。
在 Experience Platform UI 中:
- 
                  
选择?数据管理 >
 数据集。 - 
                  
选择您创建的数据集,例如:颁闯础的区段导出作业数据集。
                     - 
                  
验证摄取的批次。 如果数据集包含失败的批次,请使用?数据管理 >
 监视?查看原因。 例如,您使用的字段名称在架构中不存在。 - 
                  
复制数据集的?表名称。 例如:segment_export_job_dataset_for_cja。 在下一步中使用该名称。
 
转换输出
数据集中的数据格式不适用于Customer Journey Analytics。 要转换数据,请使用Experience Platform查询服务获取数据。
使用连接到Experience Platform查询服务的PSQL客户端。
在 Experience Platform UI 中:
- 选择?数据管理 > 
                  
 查询。 - 选择 
                  
 凭据。 
使用凭据将PSQL客户端配置为连接到Customer Journey Analytics查询服务。
查询
执行此查询以从数据集中检索受众数据:
| code language-sql | 
|---|
                      
                     | 
                  
其中:
IDENTITY_TO_USE_AS_PERSON_ID是您定义为导出作业一部分的字段之一。 例如:_demoemea.identification.core.email。DATASET_TABLE_NAME是数据集的表名称。AUDIENCE_ID_x是您定义为导出作业一部分的受众。 您需要再次指定这些受众,因为导出作业中的规范是行级过滤器。 该行级过滤器返回指定区段的配置文件,以及每个配置文件的所有区段成员资格。
结果
以闯厂翱狈格式表示的查询结果应当如下所示:
| code language-json | 
|---|
                      
                     | 
                  
其中:
PERSON_ID_x是要用作人员ID的标识符的标识符值。 例如,使用电子邮件时john.doe@gmail.com。AUDIENCE_ID_x是受众标识符。
您需要转换此闯厂翱狈数据以添加环境的租户名称并为受众提供更用户友好的名称。
最终闯厂翱狈应如下所示:
| code language-json | 
|---|
                      
                     | 
                  
其中:
TENANT_NAME是租户的名称。 例如:_demoemea。PERSON_ID_x是要用作人员ID的标识符的标识符值。 例如,使用电子邮件时john.doe@gmail.com。AUDIENCE_ID_x是受众标识符。AUDIENCE_FRIENDLY_NAME_x是受众id的友好受众名称。 例如:Luma - Blue+ Members。
使用您喜爱的工具将原始闯厂翱狈转换为此格式。
创建架构和数据集
要在Customer Journey Analytics中将转换后的JSON用作导出的受众数据,您需要创建专用架构。
要创建架构,请执行以下操作:
在 Experience Platform UI 中:
- 
                  
选择?数据管理 >
 架构。 - 
                  
选择
 创建架构。 从下拉菜单中选择?Standard。 - 
                  
在? 创建架构 ?对话框中选择? 手动 ?并使用? 选择 ?继续。
 - 
                  
在? 创建架构 ?向导的? 选择类 ?步骤中:
- 选择?个人资料。
 - 选择?下一步。
 
 - 
                  
在? 创建架构 ?向导的? 名称和审阅 ?步骤中:
- 输入?架构显示名称。 例如:
Audience Export for CJA Schema。 - (可选)输入?描述。
 - 选择?完成。
 
 - 输入?架构显示名称。 例如:
 - 
                  
设置架构以包含自定义字段组(例如?受众成员资格),该自定义字段组包含名为? audienceMembershipId ?和? audienceMembershipName ?的两个字段。
 - 
                  
确保? personID ?字段是?标识、主标识,并且具有? 电子邮件 ?作为滨?标识命名空间。
用于导出的
                     - 
                  
应用?所有更改。 选择? 保存 ?以保存架构。
 
创建数据集并使用该数据集摄取转换后的闯厂翱狈数据。
在 Experience Platform UI 中:
- 
                  
选择?数据管理 >
 数据集。 - 
                  
选择
 创建数据集。 - 
                  
选择?使用架构创建数据集。
 - 
                  
在? 从架构 ?向导的? 选择架构 ?步骤中:
- 选择您刚刚创建的架构。 例如:颁闯础架构的受众导出。
 - 选择?下一步。
 
 - 
                  
在? 从架构创建数据集 ?向导的? 配置数据集 ?步骤中:
- 输入数据集的?名称。
 - (可选)输入数据集的?描述。
 - 选择?完成。
 
 - 
                  
在数据集? 的 ?数据集? > ?名称中,将转换后的闯厂翱狈数据文件拖放到? 拖放文件 ?上。 此操作会开始将导出的JSON数据引入数据集。
 - 
                  
验证摄取的批次。 如果数据集包含失败的批次,请使用?数据管理 >
 监视?查看原因。 例如,您在JSON中定义的字段名称在架构中不存在。 
添加或编辑连接
成功摄取包含Experience Platform中的受众数据的转换后的JSON数据后,您可以将该数据集添加到Customer Journey Analytics中的新连接或现有连接。
在Customer Journey Analytics UI中:
- 
                  
选择?数据管理 > 连接。
 - 
                  
创建新连接/定义? 连接设置 ?和?数据设置。 或者选择现有连接并使用
 编辑连接?编辑连接。 - 
                  
选择
 添加数据集。 - 
                  
选择您创建并在其中摄取了转换后的闯厂翱狈数据的数据集。
 - 
                  
配置数据集。 例如:
                     - 
                  
保存?连接。
 
配置数据视图
为刚刚创建或编辑的连接配置数据视图。
- 
                  
选择?数据管理 > 数据视图。
 - 
                  
编辑现有数据视图或创建新数据视图。
 - 
                  
在数据视图的? 组件 ?选项卡中,确保将? 受众成员资格滨顿 ?和? 受众成员资格名称 ?添加为维度组件。
                     - 
                  
选择? 保存并继续 ?以保存数据视图。
 
报告和分析
最后,使用Analysis Workspace在一个或多个面板中报告Experience Platform受众数据,这些面板将数据视图与受众成员资格组件(如audienceMembershipId、audienceMembershipIdName和personID)一起使用。
其他说明
- 
                  
您应该定期执行此过程,以便在Customer Journey Analytics中不断刷新受众数据。
 - 
                  
您可以在单个Customer Journey Analytics连接中导入多个受众。 这增加了流程的复杂性,但这是可能的。 为此,您需要对上述过程进行一些修改:
- 在 RTCP 中,为受众集合中的每个所需受众执行此过程。
 - Customer Journey Analytics支持配置文件数据集中的阵列/对象阵列。 最佳选项是为或使用
audienceMembershipId对象数组audienceMembershipIdName。 - 在数据视图中,在 
audienceMembershipId字段上使用子字符串转换创建新维度,以将逗号分隔的值字符串转换为数组。 注意:数组中当前限制为 10 个值。 - 您现在可以在Customer Journey Analytics Workspace中报告此新维度
audienceMembershipIds。