为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属性映射的信息,请使用下面的部分。

里程碑

Milestones方法可跟踪有关视频的大多数信息,并且可高度自定义,且易于配置。

要使用里程碑方法,请指定基于时间的跟踪偏移以定义里程碑。 当视频播放通过里程碑时,该页面将调用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.事件.a.media.视图一起发送
eventdata.videoFilePath 映射到该变量的变量将包含文件在服务器上的路径。 仅与eventdata.事件.a.media.视图一起发送
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中打开视频进行编辑,并将​标题​元数据字段设置为所需名称,来设置视频的​用户友好的​名称。

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

    4,8,16,20,24
    

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

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

    有关优化映射的信息,请参见《Adobe Analytics测量视频指南》🔗

  3. 将framework 添加到页面。

  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 事件1
eventdata.events.a.media.timePlayed 事件2
eventdata.events.a.media.view 事件3
eventdata.events.a.media.complete 事件4
eventdata.events.milestone4 事件10
eventdata.events.milestone8 事件11
eventdata.events.milestone16 事件12
eventdata.events.milestone20 事件13
eventdata.events.milestone24 事件14
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 ​第一个调用,其中包含以下值:

  • prop1和eVar1(eventdata.a.media.name,
  • props2-4,以及包含contentType(视频)和segment(1:O:1-4)的eVar2和eVar3
  • 事件3,映射到eventdata.事件.a.media.视图。

chlimage_1-157

这是第三​​给Adobe Analytics打电话:

  • prop1和eVar1包含a.media.name;
  • 事件1,因为已查看区段
  • 事件2(已播放时间)= 4
  • 事件11已发送,因为已达到eventdata.事件.milestone8
  • prop2至4不发送(因为eventdata.事件.a.media.视图未触发)

非传统里程碑

除里程碑是使用跟踪长度的百分比定义的以外,“非旧版里程碑”方法与“里程碑”方法类似。 共性如下:

  • 当视频播放通过里程碑时,该页面将调用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属性从组件上CQ变量旁的ContentFinder拖动。

    有关优化映射的信息,请参见《Adobe Analytics测量视频指南》🔗

  3. 将framework 添加到页面。

  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. 将这些变量映射到props 1到3

    调用中的其余相关信息​将被发送到名为 pev3 ​一个​变量。

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

    lmilestones1

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

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

旧秒

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

  1. 将“轨道偏移”设置为任意秒数,

    • 例如6
    注意

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

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

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

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

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

    调用中的其余相关信息​将被发送到名为 pev3 ​一个​变量。

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

    秒

    *此调用与上述旧版里程碑调用类似。请参见此处提供的有关pev3 的信息。*

本教程中使用的参考:

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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now