文档Analytics流媒体集合指南

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

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 用户
  • 管理员
  • 开发人员

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)。

创建和设置方案：

  1. 在Adobe Experience Platform中，按照在UI中创建和编辑架构中的说明开始创建架构。

  2. 在创建架构时，请在“架构详细信息”页面上，为架构选择基类时选择​ 体验事件。

    已添加字段组

  3. 选择​ 下一步。

  4. 指定架构显示名称和说明，然后选择​ 完成。

  5. 在​ 构成 ​区域的​ 字段组 ​部分中，选择​ 添加，然后搜索并将以下新字段组添加到架构中：

    • Adobe Analytics ExperienceEvent Template
    • Implementation Details
    • MediaAnalytics Interaction Details

    添加字段组后，它们应显示在​ 字段组 ​部分，如下所示：

    已添加字段组

  6. 选择​ 保存 ​以保存更改。

  7. （可选）您可以隐藏Media Edge API未使用的某些字段。 隐藏这些字段使架构更易于阅读和理解，但并非必需。 这些字段仅引用MediaAnalytics Interaction Details字段组中的字段。

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

  1. 在​ 结构 ​区域中，选择Media Collection Details字段，然后选择​ 管理相关字段。

    管理相关字段

  2. 启用该选项以​ 显示字段 ​的显示名称，然后按如下方式更新架构：

    • 在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。

  3. 选择​ 确认 ​以保存更改。

  4. 在​ 结构 ​区域中，启用选项​ 显示字段的显示名称，然后选择List Of Media Collection Downloaded Content Events字段。

  5. 选择​ 管理相关字段，然后按如下方式更新架构：

    • 在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字段。

  6. 选择​ 确认 ​以保存更改。

  7. 在​ 结构 ​区域，选择Media Reporting Details字段，选择​ 管理相关字段。

  8. 启用该选项以​ 显示字段 ​的显示名称，然后按如下方式更新架构：

    • 在Media Reporting Details字段中，隐藏以下字段： Error Details、List Of States End、List of States Start和Media Session ID。

  9. 选择​ 确认 > 保存 ​以保存更改。

  1. （可选）您可以将自定义元数据添加到架构中。 这允许您包含其他用户定义的元数据，这些元数据可以根据特定需求或上下文进行自定义。 在现有架构未涵盖所需数据点的情况下，此灵活性非常有用。 (您还可以将自定义元数据与Media Edge API结合使用。 有关详细信息，请参阅使用Media Edge API创建自定义元数据。)
展开此处可查看有关如何将自定义元数据添加到架构的说明。

  1. 通过选择​ 帐户信息 > 分配的组织 > 组织名称 > 租户，找到组织租户的名称。

    将通过此路径接收这些自定义字段。 (例如，租户名称： _dcbl → myCustomField path： _dcbl.myCustomField。)

  2. 将自定义字段组添加到您定义的媒体架构。

    add-custom-metadata

  3. 将您要跟踪的任何自定义字段添加到字段组。

    add-custom-metadata

  4. 为请求有效负载中的自定义字段使用生成的路径。

    add-custom-metadata

  1. 继续在Adobe Experience Platform中创建数据集。

在Adobe Experience Platform中创建数据集

  1. 请确保按照在Adobe Experience Platform中设置架构中所述设置架构。

  2. 在Adobe Experience Platform中，按照数据集UI指南中的说明开始创建数据集。

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

  3. 继续在Customer Journey Analytics中配置数据流。

在Adobe Experience Platform中配置数据流

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

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

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

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

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

      创建数据流并选择架构

    • 根据您使用的是Adobe Analytics还是Customer Journey Analytics，将以下任一服务添加到数据流：

      • Adobe Analytics (如果使用Adobe Analytics)

        如果您使用的是Adobe Analytics，请确保定义报表包，如创建报表包中所述。

      • Adobe Experience Platform (如果使用Customer Journey Analytics)

      有关如何将服务添加到数据流的信息，请参阅配置数据流中的“将服务添加到数据流”部分。

      添加Adobe Analytics服务

      • 展开​ 高级选项，然后启用​ Media Analytics ​选项。

      Media Analytics选项

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

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

在 Customer Journey Analytics 中创建连接

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

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

  2. 在Customer Journey Analytics中，按照创建连接中的说明创建连接。

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

    1. 选择您之前创建的数据集，如在Adobe Experience Platform中创建数据集中所述。

    2. 确保已启用​ 导入所有新数据 ​设置。

  3. 继续在Customer Journey Analytics中创建数据视图。

在Customer Journey Analytics中创建数据视图

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

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

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

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

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

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

    2. 在​ 组件 ​选项卡的​ 架构字段 ​部分中，搜索下表列出的每个组件，并将其拖到​ 量度 ​面板中。 如果存在多个同名字段，请使用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

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

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

    4. 要将划分添加到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项目中过滤数据的维。

  3. 选择​ 保存并继续 > 保存并完成 ​以保存更改。

  4. 继续在Customer Journey Analytics中创建并配置项目。

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

  1. 请确保已按照在Customer Journey Analytics中创建数据视图中的说明在Customer Journey Analytics中创建数据视图。

  2. 在Customer Journey Analytics的​ Workspace ​选项卡的​ 项目 ​区域，选择​ 创建项目。

  3. 选择​ 空白项目 > 创建。

  4. 在新项目中，选择您之前创建的数据视图。

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

    以下4个面板是您可以创建的面板示例：

    主内容面板

    章节和广告面板

    QoE面板

    平板状态面板

  5. 选择左边栏中的​ 面板 ​图标，然后拖入​ 媒体并行查看者 ​面板和​ 媒体播放耗时 ​面板。

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

    媒体并行查看者面板

    媒体播放耗时面板

  6. （视情况而定）如果您向架构添加了自定义元数据，如在Adobe Experience Platform中设置架构的步骤8中所述，那么您需要为自定义字段设置持久性，如Customer Journey Analytics指南中的持久性组件设置中所述。

    当数据到达Customer Journey Analytics时，自定义用户ID维度将可用。

    setup-custom-metadata

    note note
    NOTE
    如果您将Adobe Analytics设置为数据流的上游，则自定义元数据也会出现在ContextData中，其名称为您在架构中设置的（不带租户前缀，例如myCustomField）。 这使得可以使用所有可用于ContextData的Adobe Analytics功能，例如创建处理规则。

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

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

  8. 继续将数据发送到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