为Adobe Analytics配置视频跟踪

有多种方法可用于跟踪视频事件,其中2种是旧版Adobe Analytics的旧版选项。 这些旧版选项包括:旧版里程碑和旧版秒数。

注意

在继续之前,请确保已在AEM中上传​可播放视频

要确保视频在页面上播放,请参阅​**本教程**,以了解有关如何在AEM中转码视频文件的信息。

请按照以下过程使用每个方法设置视频跟踪框架。

注意

对于新实施,建议您​不要使用​旧版视频跟踪选项。 请改用​Milestones​方法。

常见步骤

  1. 通过从Sidekick中拖动​视频组件​并将可播放的​视频添加为组件的资产​来设置网页

  2. 创建Adobe Analytics配置和框架

    • 以下部分中的示例对配置使用名称​my-sc-configuration,对框架使用名称​videow
  3. 在框架页面上,选择一个RSID并将用法设置为all。 (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. 从Sidekick中的“常规”组件类别中,将视频组件拖动到框架上。

  5. 选择跟踪方法:

  6. 选择跟踪方法时,CQ变量列表会相应地发生更改。 使用下面的部分了解有关如何进一步配置组件以及如何将CQ变量映射到Adobe Analytics属性的信息。

里程碑

里程碑方法可跟踪有关视频的最多信息,并且高度可自定义且易于配置。

要使用里程碑方法,请指定基于时间的跟踪偏移以定义里程碑。 当视频播放超过里程碑时,页面会调用Adobe Analytics以跟踪事件。 对于您定义的每个里程碑,组件会创建一个CQ变量,您可以将其映射到Adobe Analytics属性。 这些CQ变量的名称使用以下格式:

eventdata.events.milestoneXX

XX后缀是定义里程碑的跟踪偏移。 例如,指定4、8、16、20和28秒的跟踪偏移,会生成以下CQ变量:

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

下表介绍了为里程碑方法提供的默认CQ变量:

CQ变量 Adobe Analytics资产
eventdata.videoName 如果在DAM中设置了映射到此变量的变量,则将包含视频的用户友好名称(Title);如果未设置此设置,则将发送视频的文件名。 在播放视频开始时,只发送一次。
eventdata.videoFileName 映射到此变量的变量将包含文件名。 仅与eventdata.events.a.media.view一起发送
eventdata.videoFilePath 映射到此变量的变量将在服务器上包含文件的路径。 仅与eventdata.events.a.media.view一起发送
eventdata.events.a.media.segmentView 每次传递区段里程碑时发送
eventdata.events.a.media.timePlayed 每次触发里程碑时发送,用户在观看给定区段时所花费的秒数也会随此事件一起发送。 例如eventX=21
eventdata.events.a.media.view 在初始化视频查看时发送
eventdata.events.a.media.complete 视频播放完
时发送
eventdata.events.milestoneX 当给定里程碑传递时,X表示在
触发里程碑的秒数
eventdata.a.contentType 在每个里程碑时发送;在Adobe Analytics调用中显示为pev3,通常以“video”
发送
eventdata.a.media.name 完全匹配eventdata.videoName
eventdata.a.media.segment 包含有关已查看的区段的信息,如2:O:4-8
注意

您可以设置视频的​用户友好​名称,方法是在DAM中打开要编辑的视频,并将​Title​元数据字段设置为所需的名称。

  1. 选择里程碑作为跟踪方法后,在“跟踪偏移”框中,输入以逗号分隔的跟踪偏移列表(以秒为单位)。 例如,以下值定义了视频开始后4、8、16、20和28秒的里程碑:

    4,8,16,20,24
    

    偏移值必须是大于0的整数。 默认值为 10,25,50,75.

  2. 要将CQ变量映射到Adobe Analytics属性,请将Adobe Analytics属性从ContentFinder拖动到组件上CQ变量旁边。

    有关优化映射的信息,请参阅在Adobe Analytics中测量视频指南。

  3. 将框架 添加到页面。

  4. 要在​预览模式​中测试设置,请播放视频以触发Adobe Analytics调用。

以下Adobe Analytics跟踪数据示例适用于使用4,8,16,20和24的跟踪偏移量进行的里程碑跟踪,以及CQ变量的以下映射:

CQ 变量 Adobe Analytics资产
eventdata.videoName prop2
eventdata.videoFileName prop3
eventdata.videoFilePath prop4
eventdata.events.a.media.segmentView event1
eventdata.events.a.media.timePlayed event2
eventdata.events.a.media.view event3
eventdata.events.a.media.complete event4
eventdata.events.milestone4 event10
eventdata.events.milestone8 event11
eventdata.events.milestone16 event12
eventdata.events.milestone20 event13
eventdata.events.milestone24 event14
eventdata.a.contentType eVar3
eventdata.a.media.name eVar1、prop1
eventdata.a.media.segment eVar2

在此示例中,视频组件在框架页面上如下所示:

video1

注意

要查看对Adobe Analytics发出的调用,请使用适当的工具,如DigitalPulse Debugger或Fiddler。

使用提供的示例调用Adobe Analytics时,使用DigitalPulse Debugger查看时,应如下所示:

chlimage_1-156

这是对Adobe Analytics 的第​一个调用,其中包含以下值:

  • eventdata.a.media.name的prop1和eVar1,
  • prop2-4,以及包含contentType(video)和segment(1:O:1-4)的eVar2和eVar3
  • event3,该事件已映射到eventdata.events.a.media.view。

chlimage_1-157

这是第三​​致Adobe Analytics:

  • prop1和eVar1包含a.media.name;
  • event1,因为已查看区段
  • 通过播放时间发送的事件2 = 4
  • event11已发送,因为已到达eventdata.events.milestone8
  • prop2至4未发送(因为未触发eventdata.events.a.media.view)

非旧版里程碑

非旧版里程碑方法与里程碑方法类似,不同之处在于里程碑是使用跟踪长度的百分比来定义的。 共性如下:

  • 当视频播放超过里程碑时,页面会调用Adobe Analytics以跟踪事件。
  • 为与Adobe Analytics属性映射而定义的CQ变量静态集。
  • 对于您定义的每个里程碑,组件会创建一个CQ变量,您可以将其映射到Adobe Analytics属性。

这些CQ变量的名称使用以下格式:

XX后缀是定义里程碑的跟踪长度的百分比。 例如,指定10、25、50和75的百分比会生成以下CQ变量:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. 选择非旧版里程碑作为跟踪方法后,在“跟踪偏移”框中,输入以逗号分隔的跟踪长度百分比列表。 例如,以下默认值定义的里程碑长度为跟踪长度的10%、25%、50%和75%:

    10,25,50,75
    

    偏移值必须是大于0的整数。

  2. 要将CQ变量映射到Adobe Analytics属性,请将Adobe Analytics属性从ContentFinder拖动到组件上CQ变量旁边。

    有关优化映射的信息,请参阅在Adobe Analytics中测量视频指南。

  3. 将框架 添加到页面。

  4. 要在​预览模式​中测试设置,请播放视频以触发Adobe Analytics调用。

旧版里程碑

此方法与Milestones方法类似,其差异在于,在​跟踪偏移​字段中指定的里程碑是百分比,而不是视频中的设置点。

注意

“跟踪偏移”字段仅接受以逗号分隔的列表,其中包含1到100之间的整数。

  1. 设置“跟踪偏移”。

    • e.g.10,50,75,100

    此外,发送到Adobe Analytics的信息不太可定制;只有3个变量可用于映射:

eventdata.videoName
如果在DAM中设置了映射到此变量的变量,则将包含视频的用户友好名称(Title);如果未设置标题,则将发送视频的文件名。 在播放视频开始时只发送一次。
eventdata.videoFileName 映射到此变量的变量将包含文件名。 在播放视频开始时,只发送一次。
eventdata.videoFilePath 映射到此变量的变量将在服务器上包含文件的路径。 在播放视频开始时,只发送一次。
注意

您可以设置视频的​用户友好​名称,方法是在DAM中打开要编辑的视频,并将​标题​元数据字段设置为所需的名称。 您还需要保存完成后所做的更改。

  1. 将这些变量映射到prop 1到3

    调用中的​其余相关信息​将被合并到名为​pev3​的​变量中。

    使用 提供的示例向Adobe Analytics发出的示例调用在使用DigitalPulse Debugger查看时应如下所示:

    lmilestones1

    调用​中发送的pev3​变量包含以下信息:

    • 名称 — 视频文件的名称(film.avi)
    • 长度 — 视频文件的长度,以秒为单位(100)
    • 播放器名称 — 用于播放视频文件的视频播放器(HTML5视频)
    • 播放的总秒数 — 视频播放的总秒数(25)
    • 开始时间戳 — 标识视频播放何时开始的时间戳(133103567)
    • 播放会话 — 播放会话的详细信息。此字段指示用户如何与视频交互。 这可能包括一些数据,例如他们开始播放视频的位置、是否使用视频滑块来推进视频,以及他们停止播放视频的位置(L10E24S58L58 — 视频在秒处停止。 L10节的25秒,然后跳到秒。 48)

旧版秒数

使用​旧版秒数​方法时,每第N秒触发一次Adobe Analytics调用,其中N是在“跟踪偏移”字段中指定的。

  1. 将“跟踪偏移”设置为任意秒数,

    • 例如6
    注意

    “跟踪偏移”字段仅接受大于0的整数

    发送到Adobe Analytics的信息不太可自定义。 只有3个变量可用于映射:

eventdata.videoName
如果在DAM中设置了映射到此变量的变量,则将包含视频的用户友好名称(Title);如果未设置标题,则将发送视频的文件名。 在播放视频开始时只发送一次。
eventdata.videoFileName 映射到此变量的变量将包含文件名。 在播放视频开始时,只发送一次。
eventdata.videoFilePath 映射到此变量的变量将在服务器上包含文件的路径。 在播放视频开始时,只发送一次。
注意

您可以设置视频的​用户友好​名称,方法是在DAM中打开要编辑的视频,并将​Title​元数据字段设置为所需的名称。 您还需要保存完成后所做的更改。

  1. 将这些变量映射到prop1、prop2和prop3

    调用中的​其余相关信息​将被合并到名为​pev3​的​变量中。

    使用提供的示例调用Adobe Analytics时,使用DigitalPulse Debugger查看时,应如下所示:

    lseconds

    该调用与上述旧版里程碑调用类似。请参阅此处提供的pev3 上的信息

本教程中使用的引用:

[0] https://docs.adobe.com/content/help/zh-Hans/media-analytics/using/sdk-implement/setup/setup-overview.html

在此页面上