Edge实施概述

Adobe Experience Platform Edge Network允许您将发送到多个产品的数据发送到单个端点,然后将该相应信息转发到每个产品。 这是实施流媒体收藏集的推荐方法,也是从单个工具中同时支持Adobe Analytics和Customer Journey Analytics的唯一方法。

与旧版Media SDK方法(每个Adobe解决方案需要特定于产品的检测工具)不同,Edge实施使用共享XDM数据模型和单个数据流。 数据流从您的SDK或API流向Edge Network,然后路由到数据流中配置的任何Adobe产品(Analytics、CJA、AJO或RTCDP)。 这意味着以后切换或添加下游产品不需要重新检测您的媒体事件。

无论您使用哪个代码库(Web SDK、Mobile SDK(iOS或Android)、Roku SDK或Media Edge API),都必须首先完成本页中所述的平台设置:创建架构、创建数据集和配置数据流。

先决条件

  1. 完成常规先决条件。 请参阅常规先决条件

  2. 确认兼容的Adobe解决方案。 您必须至少具有下列项之一的有效实施:

在Adobe Experience Platform中设置架构

为了在使用Adobe Experience Platform的应用程序之间标准化数据收集,Adobe创建了一个公开记录的开放式Experience Data Model (XDM)标准。

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

  2. 在“架构详细信息”页面上,选择​ Experience Event ​作为架构的基类。

    已添加字段组

  3. 选择​下一步

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

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

    • End User ID Details
    • Implementation Details
    • MediaAnalytics Interaction Details

    添加字段组后,它们将显示在​ 字段组 ​部分中:

    已添加字段组

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

  7. (可选)您可以在架构UI中隐藏某些字段。 这些字段是Adobe在后端填充的服务器计算报表字段 — 它们并非由SDK或API发送,不会影响数据收集。 隐藏这些变量对功能没有影响;它仅减少在AEP UI中浏览架构时的视觉噪音。 这些字段仅引用MediaAnalytics Interaction Details字段组中的字段。

    accordion
    展开以查看有关可隐藏字段的说明。
    1. 在​ 结构 ​区域中,选择Media Collection Details字段,然后选择​管理相关字段

      管理相关字段

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

      • Media Collection Details > Advertising Details字段中,隐藏以下报表字段: Ad CompletedAd StartedAd Time Played

      • Media Collection Details > Advertising Pod Details字段中,隐藏以下报告字段: Ad Break ID

      • Media Collection Details > Chapter Details字段中,隐藏以下报告字段: Chapter CompletedChapter IDChapter StartedChapter Time Played

      • Media Collection Details字段中,隐藏List Of States字段。

        隐藏媒体收集状态

      • Media Collection Details > List Of States EndMedia Collection Details > List Of States Start字段中,隐藏以下报告字段: Player State CountPlayer State SetPlayer State Time

        要隐藏的 字段

      • Media Collection Details > Qoe Data Details字段中,隐藏以下报告字段: Average BitrateAverage Bitrate BucketBitrate Change Impacted StreamsBitrate ChangesBuffer Impacted StreamsBuffer EventsDropped Frame Impacted StreamsDrops Before StartsErrorsExternal Error IDsError Impacted StreamsMedia SDK Error IDsPlayer SDK Error IDsStalling Impacted StreamsStalling EventsTotal Buffer DurationTotal Stalling Duration

      • Media Collection Details > Session Details字段中,隐藏以下报告字段: 10% Progress Marker25% Progress Marker50% Progress Marker75% Progress Marker95% Progress MarkerAd CountAverage Minute AudienceContent CompletesChapter CountContent StartsContent Time SpentEstimated StreamsFederated DataMedia Segment ViewsMedia Downloaded FlagMedia StartsMedia Session IDMedia Session Server TimeoutMedia Time SpentPause EventsPause Impacted StreamsPev3PccrTotal Pause DurationUnique Time PlayedVideo Segment

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

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

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

      • List Of Media Collection Downloaded Content Events > Media Details > Advertising Details字段中,隐藏以下报告字段: Ad CompletedAd StartedAd 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 CompletedChapter IDChapter StartedChapter 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 EndMedia Collection Details > List Of States Start字段中,隐藏以下报告字段: Player State CountPlayer State SetPlayer State Time

      • List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details字段中,隐藏以下报告字段: Average BitrateAverage Bitrate BucketBitrate Change Impacted StreamsBitrate ChangesBuffer EventsBuffer Impacted StreamsDrops Before StartsDropped Frame Impacted StreamsError Impacted StreamsErrorsExternal Error IDsMedia SDK Error IDsPlayer SDK Error IDsStalling EventsStalling Impacted StreamsTotal Buffer DurationTotal Stalling Duration

      • List Of Media Collection Downloaded Content Events > Media Details > Session Details字段中,隐藏以下报告字段: 10% Progress Marker25% Progress Marker50% Progress Marker75% Progress Marker95% Progress MarkerAd CountAverage Minute AudienceChapter CountContent CompletesContent StartsContent Time SpentEstimated StreamsFederated DataMedia Downloaded FlagMedia Segment ViewsMedia Session IDMedia Session Server TimeoutMedia StartsMedia Time SpentPause EventsPause Impacted StreamsPccrPev3Total Pause DurationUnique Time PlayedVideo Segment

      • List Of Media Collection Downloaded Content Events > Media Details字段中,隐藏Media Session ID字段。

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

    7. 在​ 结构 ​区域中,选择Media Reporting Details字段,然后选择​管理相关字段

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

      • Media Reporting Details字段中,隐藏以下字段: Error DetailsList Of States EndList of States StartMedia Session ID
    9. 选择​确认 > 保存​以保存更改。

  8. (可选)您可以将自定义元数据添加到架构中。 这使您可以根据特定需求或上下文包含其他用户定义的元数据。 有关使用Media Edge API自定义元数据的详细信息,请参阅自定义元数据支持

    accordion
    展开以查看有关将自定义元数据添加到架构的说明。
    1. 通过选择​帐户信息 > 分配的组织 > 组织名称 > 租户,找到组织的租户名称。

      通过此路径接收自定义字段。 (例如,租户名称: _dcbl → myCustomField path: _dcbl.myCustomField。)

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

      add-custom-metadata

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

      add-custom-metadata

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

      add-custom-metadata

在 Adobe Experience Platform 中创建数据集

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

    为数据集选择架构时,请选择之前创建的架构。

在Adobe Experience Platform中配置数据流

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

    创建数据流时,进行以下选择:

    • 在​ 事件架构 ​字段中,选择您在中创建的架构。在Adobe Experience Platform中设置架构。

      note important
      IMPORTANT
      选择​保存;不要选择​保存并添加映射。 选择​ 保存并添加映射 ​会导致时间戳字段出现映射错误。

      创建数据流并选择架构

    • 根据您的Adobe解决方案,将相应的服务添加到数据流。 有关添加服务的信息,请参阅配置数据流中的“将服务添加到数据流”。

      • Adobe Analytics(如果使用Adobe Analytics) — 按照创建报表包中的说明定义报表包。

      • Adobe Experience Platform(如果使用Customer Journey Analytics、Adobe Journey Optimizer或Real-Time Customer Data Platform)

      添加Adobe Analytics服务

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

      Media Analytics选项

选择实施方法

准备好架构、数据集和数据流后,实施以下代码库之一以开始将流媒体数据发送到Edge Network。 每个页面都涵盖特定于流媒体的设置;每个事件和每个变量的代码都存在于事件变量中。

代码内​实现直接在应用程序源代码中写入SDK调用。 使用标记​实施使用Adobe Experience Platform标记,这使您能够在不修改应用程序代码的情况下配置和部署跟踪规则。 选择适合您的部署工作流的任意方法。

代码库
In-code
使用标记
Web
Web SDK
Web SDK标记扩展
iOS
iOS
iOS (标记)
Android
Android
Android (标记)
Roku
Roku
API
Media Edge API

下一步

开始收集数据后,您可以配置报表:

recommendation-more-help
media-analytics-help