使用Edge Network实施流媒体收集加载项

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined
undefined
undefined

Adobe Experience Platform Edge Network 允许您将发送到多个产品的数据发送到一个集中的位置。 Experience Edge 将适当的信息转发给所需的产品。此概念允许您整合实施工作，尤其是跨多个数据解决方案进行整合。

下图说明了如何实施Adobe流媒体收集加载项，以使用Experience PlatformEdge在Adobe Analytics或Customer Journey Analytics中使数据在Analysis Workspace中可用：

CJA 工作流

有关所有实施选项的概述，包括不使用Experience PlatformEdge的实施方法，请参阅实施流媒体收集加载项。

无论您是使用Adobe Experience Platform Web SDK、Adobe Experience Platform Mobile SDK、Adobe Experience Platform Roku SDK还是API来使用Experience Edge实施流媒体收集加载项，都必须首先完成以下部分：

在Adobe Experience Platform中设置架构

为了标准化数据收集以在利用 Adobe Experience Platform 的应用程序中使用，Adobe 创建了开放且公开记录的标准，即体验数据模型 (XDM)。

创建和设置方案：

在Adobe Experience Platform中，按照在UI中创建和编辑架构中的说明开始创建架构。
在创建架构时，请在“架构详细信息”页面上，为架构选择基类时选择 体验事件。
选择 下一步。
指定架构显示名称和说明，然后选择完成。
在构成区域的 字段组 部分中，选择添加，然后搜索并将以下新字段组添加到架构中：
- Adobe Analytics ExperienceEvent Template
- Implementation Details
- MediaAnalytics Interaction Details
添加字段组后，它们应显示在 字段组 部分，如下所示：
选择保存以保存更改。
（可选）您可以隐藏Media Edge API未使用的某些字段。隐藏这些字段使架构更易于阅读和理解，但并非必需。这些字段仅引用MediaAnalytics Interaction Details字段组中的字段。

展开此处可查看有关可隐藏字段的说明。

在结构区域中，选择Media Collection Details字段，然后选择 管理相关字段。
启用该选项以 显示字段 的显示名称，然后按如下方式更新架构：
- 在Media Collection Details > Advertising Details字段中，隐藏以下报表字段： Ad Completed、Ad Started和Ad Time Played。
- 在Media Collection Details > Advertising Pod Details字段中，隐藏以下报告字段： Ad Break ID
- 在Media Collection Details > Chapter Details字段中，隐藏以下报告字段： Chapter Completed、Chapter ID、Chapter Started和Chapter Time Played。
- 在Media Collection Details字段中，隐藏List Of States字段。
- 在Media Collection Details > List Of States End和Media Collection Details > List Of States Start字段中，隐藏以下报告字段： Player State Count、Player State Set和Player State Time。
  
  要隐藏的
- 在Media Collection Details > Qoe Data Details字段中，隐藏以下报告字段： Average Bitrate、Average Bitrate Bucket、Bitrate Change Impacted Streams、Bitrate Changes、Buffer Impacted Streams、Buffer Events、Dropped Frame Impacted Streams、Drops Before Starts、Errors、External Error IDs、Error Impacted Streams、Media SDK Error IDs、Player SDK Error IDs、Stalling Impacted Streams、Stalling Events、Total Buffer Duration和Total Stalling Duration。
- 在Media Collection Details > Session Details字段中，隐藏以下报告字段： 10% Progress Marker、25% Progress Marker、50% Progress Marker、75% Progress Marker、95% Progress Marker、Ad Count、Average Minute Audience、Content Completes、Chapter Count、Content Starts、Content Time Spent、Estimated Streams、Federated Data、Media Segment Views、Media Downloaded Flag、Media Starts、Media Session ID、Media Session Server Timeout、Media Time Spent、Pause Events、Pause Impacted Streams、Pev3、Pccr、Total Pause Duration、Unique Time Played和Video Segment。
选择确认以保存更改。
在结构区域中，启用选项 显示字段的显示名称，然后选择List Of Media Collection Downloaded Content Events字段。
选择 管理相关字段，然后按如下方式更新架构：
- 在List Of Media Collection Downloaded Content Events > Media Details > Advertising Details字段中，隐藏以下报告字段： Ad Completed、Ad Started和Ad Time Played。
- 在List Of Media Collection Downloaded Content Events > Media Details > Advertising Pod Details字段中，隐藏以下报告字段： Ad Break ID
- 在List Of Media Collection Downloaded Content Events > Media Details > Chapter Details字段中，隐藏以下报告字段： Chapter Completed、Chapter ID、Chapter Started和Chapter Time Played。
- 在List Of Media Collection Downloaded Content Events > Media Details字段中，隐藏List Of States字段。
- 在List Of Media Collection Downloaded Content Events > Media Details > List Of States End和Media Collection Details > List Of States Start字段中，隐藏以下报告字段： Player State Count、Player State Set和Player State Time。
- 在List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details字段中，隐藏以下报告字段： Average Bitrate、Average Bitrate Bucket、Bitrate Change Impacted Streams、Bitrate Changes、Buffer Events、Buffer Impacted Streams、Drops Before Starts、Dropped Frame Impacted Streams、Error Impacted Streams、Errors、External Error IDs、Media SDK Error IDs、Player SDK Error IDs、Stalling Events、Stalling Impacted Streams、Total Buffer Duration和Total Stalling Duration。
- 在List Of Media Collection Downloaded Content Events > Media Details > Session Details字段中，隐藏以下报告字段： 10% Progress Marker、25% Progress Marker、50% Progress Marker、75% Progress Marker、95% Progress Marker、Ad Count、Average Minute Audience、Chapter Count、Content Completes、Content Starts、Content Time Spent、Estimated Streams、Federated Data、Media Downloaded Flag、Media Segment Views、Media Session ID、Media Session Server Timeout、Media Starts、Media Time Spent、Pause Events、Pause Impacted Streams、Pccr、Pev3、Total Pause Duration、Unique Time Played和Video Segment。
- 在List Of Media Collection Downloaded Content Events > Media Details字段中，隐藏Media Session ID字段。
选择确认以保存更改。
在结构区域，选择Media Reporting Details字段，选择 管理相关字段。
启用该选项以 显示字段 的显示名称，然后按如下方式更新架构：
- 在Media Reporting Details字段中，隐藏以下字段： Error Details、List Of States End、List of States Start和Media Session ID。
选择确认 > 保存以保存更改。
继续在Adobe Experience Platform中创建数据集。

在Adobe Experience Platform中创建数据集

请确保按照在Adobe Experience Platform中设置架构中所述设置架构。
在Adobe Experience Platform中，按照数据集UI指南中的说明开始创建数据集。

为数据集选择架构时，请选择您之前创建的架构，如在Adobe Experience Platform中设置架构中所述。
继续在Customer Journey Analytics中配置数据流。

在Adobe Experience Platform中配置数据流

请确保按照在Adobe Experience Platform中创建数据集中的说明创建了数据集。

按照配置数据流中的说明创建新数据流。

创建数据流时，请确保您进行了以下配置选择：

创建数据流时，在 事件架构 字段中，确保选择您在中创建的架构。在Adobe Experience Platform中设置架构。选择保存。

note important
IMPORTANT
不要选择保存并添加映射，因为这样做会导致时间戳字段出现映射错误。

创建数据流并选择架构

根据您使用的是Adobe Analytics还是Customer Journey Analytics，将以下任一服务添加到数据流：
- Adobe Analytics (如果使用Adobe Analytics)
  
  如果您使用的是Adobe Analytics，请确保定义报表包，如创建报表包中所述。
- Adobe Experience Platform (如果使用Customer Journey Analytics)
有关如何将服务添加到数据流的信息，请参阅配置数据流中的“将服务添加到数据流”部分。
展开 高级选项，然后启用 Media Analytics 选项。

您现在可以实施Media Edge API或Media Edge SDK以开始收集Media Analytics数据。

收集一些数据后，您可以在Customer Journey Analytics中创建连接。

在 Customer Journey Analytics 中创建连接

note note
NOTE
只有在使用Customer Journey Analytics时，才需要执行以下过程。

请确保按照在Customer Journey Analytics中配置数据流中的说明创建了数据流。
在Customer Journey Analytics中，按照创建连接中的说明创建连接。

创建连接时，需要以下配置选择才能实施流媒体收集加载项：
1. 选择您之前创建的数据集，如在Adobe Experience Platform中创建数据集中所述。
2. 确保已启用 导入所有新数据 设置。
继续在Customer Journey Analytics中创建数据视图。

在Customer Journey Analytics中创建数据视图

note note
NOTE
只有在使用Customer Journey Analytics时，才需要执行以下过程。

请确保在Customer Journey Analytics中创建了连接，如在Customer Journey Analytics中创建连接中所述。

在客户历程分析中，按照创建或编辑数据视图中的说明创建数据视图。

创建数据视图时，需要以下配置选择才能实施流媒体收集加载项：

在连接字段中，选择您之前创建的连接，如在Customer Journey Analytics中创建连接中所述。

最多可能需要15分钟才能选择您创建的连接。

在组件选项卡的 架构字段 部分中，搜索下表列出的每个组件，并将其拖到量度面板中。如果存在多个同名字段，请使用XDM路径以确保它是正确的字段。

主内容 — 内容量度

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
组件名称	XDM 路径
媒体开始	mediaReporting.sessionDetails.isViewed
媒体区段查看次数	mediaReporting.sessionDetails.hasSegmentView
内容开始	mediaReporting.sessionDetails.isPlayed
内容结束	mediaReporting.sessionDetails.isCompleted
内容逗留时间	mediaReporting.sessionDetails.timePlayed
平均逗留时间	mediaReporting.sessionDetails.totalTimePlayed
不重复播放时间	mediaReporting.sessionDetails.uniqueTimePlayed
10% 进度标记	mediaReporting.sessionDetails.hasProgress10
平均受众访问分钟数	mediaReporting.sessionDetails.averageMinuteAudience

章节和广告 — 章节和广告量度

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
组件名称	XDM 路径
章节开始	mediaReporting.chapterDetails.isStarted
章节已完成	mediaReporting.chapterDetails.isCompleted
章节播放时间	mediaReporting.chapterDetails.timePlayed
广告开始	mediaReporting.advertisingDetails.isStarted
广告已完成	mediaReporting.advertisingDetails.isCompleted
广告播放时间	mediaReporting.advertisingDetails.timePlayed

QoE - QoE量度

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 10-row-2
组件名称	XDM 路径
开始时间	mediaReporting.qoeDataDetails.timeToStart
开始前丢帧	mediaReporting.qoeDataDetails.isDroppedBeforeStart
受缓冲影响的流	mediaReporting.qoeDataDetails.hasBufferImpactedStreams
受比特率更改影响的流	mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
比特率更改	mediaReporting.qoeDataDetails.bitrateChangeCount
平均比特率	mediaReporting.qoeDataDetails.bitrateAverage
丢帧	mediaReporting.qoeDataDetails.droppedFrames
错误数	mediaReporting.qoeDataDetails.errorCount
受错误影响的流	mediaReporting.qoeDataDetails.hasErrorImpactedStreams
受丢帧影响的流	mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

播放器状态 — 播放器状态量度

table 0-row-2 1-row-2 2-row-2 3-row-2
组件名称	XDM 路径
播放器状态设置	mediaReporting.states.isSet
播放器状态计数	mediaReporting.states.count
播放器状态时间	mediaReporting.states.time

更新下表中组件的标签（在 上下文标签 下拉菜单中）。搜索指标面板中尚未出现的任何组件，并将其拖到面板中。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
组件名称	上下文标签
媒体会话服务器超时	媒体：上次调用后经过的秒数
平均逗留时间	媒体：媒体逗留时间
缓冲总持续时间	媒体：缓冲总持续时间
开始时间	Media：开始时间
暂停总持续时间	媒体：暂停总持续时间

要将划分添加到Customer Journey Analytics项目，请将以下维度添加到 Dimension 面板：

table 0-row-2 1-row-2 2-row-2
XDM 路径	组件名称
mediaReporting.states.name	播放器状态名称
mediaReporting.sessionDetails.ID	媒体会话 ID

除了此表中的维外，您还可以添加任何其他要用于在Customer Journey Analytics项目中过滤数据的维。

选择 保存并继续 > 保存并完成 以保存更改。
继续在Customer Journey Analytics中创建并配置项目。

在Customer Journey Analytics中创建并配置项目

请确保已按照在Customer Journey Analytics中创建数据视图中的说明在Customer Journey Analytics中创建数据视图。
在Customer Journey Analytics的 Workspace 选项卡的项目区域，选择 创建项目。
选择 空白项目 > 创建。
在新项目中，选择您之前创建的数据视图。

在项目中创建面板时，您可以使用添加到数据视图的任何组件，如在Customer Journey Analytics中创建数据视图中所述。

以下4个面板是您可以创建的面板示例：
选择左边栏中的面板图标，然后拖入 媒体并行查看者 面板和 媒体播放耗时 面板。

这两个面板应当如下所示：

按照共享项目中的说明共享项目。

note note
NOTE
如果要与共享的用户不可用，请确保这些用户具有在Adobe Admin Console中Customer Journey Analytics的用户和管理员访问权限。

继续将数据发送到Experience PlatformEdge。

将数据发送到Experience PlatformEdge

根据要发送到Experience PlatformEdge的数据类型，您可以使用以下任一方法：

Web：使用Adobe Experience Platform Web SDK

Mobile：使用Adobe Experience Platform Mobile SDK

使用以下文档资源完成iOS和Android的实施：

Roku：Adobe Experience Platform Roku SDK

API： Web和其他

此API是当前唯一受支持的将Web数据发送到Experience PlatformEdge的方法。

如果您要使用Edge API的自定义实施，则该API也将可用。

有关media Edge API的更多信息，请参阅以下资源：

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb