有多种方法可用于跟踪视频事件,其中2种是旧版Adobe Analytics的旧版选项。 这些旧版选项包括:旧版里程碑和旧版秒数。
在继续之前,请确保已在AEM中上传可播放视频。
要确保视频在页面上播放,请参阅**本教程**,以了解有关如何在AEM中转码视频文件的信息。
请按照以下过程使用每个方法设置视频跟踪框架。
对于新实施,建议您不要使用旧版视频跟踪选项。 请改用Milestones方法。
通过从Sidekick中拖动视频组件并将可播放的视频添加为组件的资产来设置网页
在框架页面上,选择一个RSID并将用法设置为all。 (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
从Sidekick中的“常规”组件类别中,将视频组件拖动到框架上。
选择跟踪方法:
选择跟踪方法时,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中打开要编辑的视频,并将标题元数据字段设置为所需的名称。
选择里程碑作为跟踪方法后,在“跟踪偏移”框中,输入以逗号分隔的跟踪偏移列表(以秒为单位)。 例如,以下值定义了视频开始后4、8、16、20和28秒的里程碑:
4,8,16,20,24
偏移值必须是大于0的整数。 默认值为 10,25,50,75
.
要将CQ变量映射到Adobe Analytics属性,请将Adobe Analytics属性从ContentFinder拖动到组件上CQ变量旁边。
有关优化映射的信息,请参阅在Adobe Analytics中测量视频指南。
将框架 添加到页面。
要在预览模式中测试设置,请播放视频以触发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 |
在此示例中,视频组件在框架页面上如下所示:
要查看对Adobe Analytics发出的调用,请使用适当的工具,如DigitalPulse Debugger或Fiddler。
使用提供的示例调用Adobe Analytics时,使用DigitalPulse Debugger查看时,应如下所示:
这是对Adobe Analytics 的第一个调用,其中包含以下值:
这是第三次致Adobe Analytics:
非旧版里程碑方法与里程碑方法类似,不同之处在于里程碑是使用跟踪长度的百分比来定义的。 共性如下:
这些CQ变量的名称使用以下格式:
XX后缀是定义里程碑的跟踪长度的百分比。 例如,指定10、25、50和75的百分比会生成以下CQ变量:
eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75
eventdata.events.milestoneXX
选择非旧版里程碑作为跟踪方法后,在“跟踪偏移”框中,输入以逗号分隔的跟踪长度百分比列表。 例如,以下默认值定义的里程碑长度为跟踪长度的10%、25%、50%和75%:
10,25,50,75
偏移值必须是大于0的整数。
要将CQ变量映射到Adobe Analytics属性,请将Adobe Analytics属性从ContentFinder拖动到组件上CQ变量旁边。
有关优化映射的信息,请参阅在Adobe Analytics中测量视频指南。
将框架 添加到页面。
要在预览模式中测试设置,请播放视频以触发Adobe Analytics调用。
此方法与Milestones方法类似,其差异在于,在跟踪偏移字段中指定的里程碑是百分比,而不是视频中的设置点。
“跟踪偏移”字段仅接受以逗号分隔的列表,其中包含1到100之间的整数。
设置“跟踪偏移”。
此外,发送到Adobe Analytics的信息不太可定制;只有3个变量可用于映射:
eventdata.videoName |
如果在DAM中设置了映射到此变量的变量,则将包含视频的用户友好名称(Title);如果未设置标题,则将发送视频的文件名。 在播放视频开始时只发送一次。 |
eventdata.videoFileName | 映射到此变量的变量将包含文件名。 在播放视频开始时,只发送一次。 |
eventdata.videoFilePath | 映射到此变量的变量将在服务器上包含文件的路径。 在播放视频开始时,只发送一次。 |
您可以设置视频的用户友好名称,方法是在DAM中打开要编辑的视频,并将标题元数据字段设置为所需的名称。 您还需要保存完成后所做的更改。
将这些变量映射到prop 1到3
调用中的其余相关信息将被发送到名为pev3的变量中。
使用 提供的示例向Adobe Analytics发出的示例调用在使用DigitalPulse Debugger查看时应如下所示:
调用中发送的pev3变量包含以下信息:
名称 — 视频文件的名称(film.avi)
长度 — 视频文件的长度,以秒为单位(100)
播放器名称 — 用于播放视频文件的视频播放器(HTML5视频)
播放的总秒数 — 视频播放的总秒数(25)
开始时间戳 — 标识视频播放何时开始的时间戳(133103567)
播放会话 — 播放会话的详细信息。此字段指示用户如何与视频交互。 这可能包括一些数据,例如他们开始播放视频的位置、是否使用视频滑块来推进视频,以及他们停止播放视频的位置(L10E24S58L58 — 视频在秒处停止。 L10节的25秒,然后跳到秒。 48)
使用旧版秒数方法时,每第N秒触发一次Adobe Analytics调用,其中N是在“跟踪偏移”字段中指定的。
将“跟踪偏移”设置为任意秒数,
“跟踪偏移”字段仅接受大于0的整数
发送到Adobe Analytics的信息不太可自定义。 只有3个变量可用于映射:
eventdata.videoName |
如果在DAM中设置了映射到此变量的变量,则将包含视频的用户友好名称(Title);如果未设置标题,则将发送视频的文件名。 在播放视频开始时只发送一次。 |
eventdata.videoFileName | 映射到此变量的变量将包含文件名。 在播放视频开始时,只发送一次。 |
eventdata.videoFilePath | 映射到此变量的变量将在服务器上包含文件的路径。 在播放视频开始时,只发送一次。 |
您可以设置视频的用户友好名称,方法是在DAM中打开要编辑的视频,并将标题元数据字段设置为所需的名称。 您还需要保存完成后所做的更改。
将这些变量映射到prop1、prop2和prop3
调用中的其余相关信息将被合并到名为pev3的变量中。
使用提供的示例调用Adobe Analytics时,使用DigitalPulse Debugger查看时,应如下所示:
该调用与上述旧版里程碑调用类似。请参阅此处提供的pev3 上的信息。
本教程中使用的引用:
[0] https://docs.adobe.com/content/help/zh-Hans/media-analytics/using/media-overview.html