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

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

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

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

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

常见步骤 common-steps

  1. 通过拖动 视频组件 添加一个可玩的 视频作为资产 对于组件

  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
映射到此的变量将包含 用户友好 名称(标题);如果未设置,则视频的 文件名 将被改用。 仅在播放视频开始时发送一次。
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
包含有关已查看区段的信息,例如24-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
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

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

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

chlimage_1-128

这是​ 第一次调用 ​向Adobe Analytics发出的请求包含以下值:

  • eventdata.a.media.name的prop1和eVar1,
  • props2-4,以及包含contentType(视频)和区段(1)的eVar2和eVar31-4)
  • 已映射到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以跟踪事件。
  • CQ变量的静态集 定义用于与Adobe Analytics属性进行映射的区段。
  • 对于您定义的每个里程碑,组件会创建一个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.videoFileName
映射到此的变量将包含文件名。 仅在播放视频开始时发送一次。
eventdata.videoFilePath
映射到此的变量将包含文件在服务器上的路径。 仅在播放视频开始时发送一次。
NOTE
您可以设置视频的 用户友好 ,方法是打开视频在DAM中进行编辑,并设置 标题 将元数据字段更改为所需的名称。 您还需要保存完成时所做的更改。
  1. 将这些变量映射到prop 1至3

    其他相关信息 在中,调用将连接发送到 命名的变量 pev3.

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

    lmilestones1

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

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

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

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

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

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

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

旧版秒数 legacy-seconds

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

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

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

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

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

    其他相关信息 在中,调用将被发送到 命名的变量 pev3.

    使用DigitalPulse Debugger查看时,使用提供的示例调用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