为Adobe Analytics配置视频跟踪 configuring-video-tracking-for-adobe-analytics

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

NOTE
在继续之前,请确保已在AEM中上传​ 可播放视频
若要确保您的视频在页面上播放,请参阅​**本教程**,以了解有关如何在AEM中转码视频文件的信息。

使用以下过程可使用每种方法设置视频跟踪的框架。

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

常见步骤 common-steps

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

  2. 创建Adobe Analytics配置和框架

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

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

  5. 选择跟踪方法:

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

里程碑 milestones

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

下表描述了为Milestones方法提供的默认CQ变量:

CQ变量
Adobe Analytics资产
eventdata.videoName
如果在DAM中设置,则映射到此的变量将包含视频的 用户友好的 名称(标题);如果未设置,则将发送视频的 文件名。 仅在播放视频开始时发送一次。
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,通常作为“视频”发送
eventdata.a.media.name
与eventdata.videoName完全匹配
eventdata.a.media.segment
包含有关已查看区段的信息,例如2:O:4-8
NOTE
您可以通过以下方式设置视频的​ 用户友好 ​名称:打开视频以在DAM中进行编辑,并将​ 标题 ​元数据字段设置为所需名称。
  1. 选择里程碑作为跟踪方法后,在跟踪偏移框中,输入以逗号分隔的跟踪偏移列表(以秒为单位)。 例如,以下值定义在视频开始后的4、8、16、20和28秒处的里程碑:

    code language-xml
    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
事件4
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

对于此示例,“框架”页面上将显示如下视频组件:

视频1

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

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

chlimage_1-128

这是对Adobe Analytics进行的包含以下值的​ 第一次调用

  • eventdata.a.media.name的​ prop1和eVar1,
  • props2-4,以及包含contentType (视频)和区段(11-4) ​的eVar2和eVar3
  • 已映射到eventdata.events.a.media.view的​ event3。

chlimage_1-129

这是对Adobe Analytics的​ 第三次调用

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

非传统里程碑 non-legacy-milestones

除了使用轨道长度的百分比定义里程碑以外,非传统里程碑方法与Milestones方法类似。 共同之处如下:

  • 当视频播放超过里程碑时,页面调用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%:

    code language-xml
    10,25,50,75
    

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

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

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

  3. 将框架添加到页面。

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

旧版里程碑 legacy-milestones

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

NOTE
跟踪偏移量字段仅接受包含1到100之间整数的逗号分隔列表。
  1. 设置跟踪偏移。

    • 例如,10,50,75,100

    此外,发送到Adobe Analytics的信息的可自定义性较低;只有3个变量可用于映射:

eventdata.videoName
如果在DAM中设置了,则映射到此的变量将包含视频的 用户友好的 名称(标题);如果未设置标题,则将发送视频的 文件名。 仅在播放视频开始时发送一次。
eventdata.videoFileName
映射到此的变量将包含文件名。 仅在播放视频开始时发送一次。
eventdata.videoFilePath
映射到此的变量将包含文件在服务器上的路径。 仅在播放视频开始时发送一次。
NOTE
您可以通过以下方式设置视频的​ 用户友好 ​名称:打开视频以在DAM中进行编辑,并将​ 标题 ​元数据字段设置为所需名称。 您还需要保存完成时所做的更改。
  1. 将这些变量映射到prop 1至3

    调用中的​ 其余相关信息 ​将串联发送到名为​ pev3 ​的​ one ​变量。

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

    里程碑1

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

    • 名称 — 视频文件的名称(film.avi)

    • Length — 视频文件的长度,以秒为单位(100)

    • 播放器名称 — 用于播放视频文件的视频播放器(HTML5视频)

    • 播放的总秒数 — 播放视频的总秒数(25)

    • 开始时间戳 — 标识视频播放开始时间的时间戳(1331035567)

    • 播放会话 — 播放会话的详细信息。 此字段指示用户如何与视频交互。 这可能包括诸如他们开始播放视频的位置、他们是否使用视频滑块来前进视频以及他们停止播放视频的位置(L10E24S58L58 — 视频在秒内停止。 第10节的25节,然后跳到秒。 48)

旧版秒数 legacy-seconds

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

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

    • 例如, 6
    note note
    NOTE
    跟踪偏移量字段仅接受大于0的整数

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

eventdata.videoName
如果在DAM中设置了,则映射到此的变量将包含视频的 用户友好的 名称(标题);如果未设置标题,则将发送视频的 文件名。 仅在播放视频开始时发送一次。
eventdata.videoFileName
映射到此的变量将包含文件名。 仅在播放视频开始时发送一次。
eventdata.videoFilePath
映射到此的变量将包含文件在服务器上的路径。 仅在播放视频开始时发送一次。
NOTE
您可以通过以下方式设置视频的​ 用户友好 ​名称:打开视频以在DAM中进行编辑,并将​ 标题 ​元数据字段设置为所需名称。 您还需要保存完成时所做的更改。
  1. 将这些变量映射到prop1、prop2和prop3

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

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

    lseconds

    该调用类似于上面的“旧版里程碑”调用。 查看与Adobe Analytics集成下提供的有关pev3的信息。

本教程中使用的​ 引用:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=zh-Hans

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2