视频自定义提示跟踪器:BrightCove 扩展文档

先决条件

每个 Adobe Experience Platform Launch 属性都需要在“扩展”屏幕中安装和配置以下扩展:

  • Adobe Analytics
  • Experience Cloud 访客 ID 服务
  • 已安装的核心扩展

按照 https://studio.support.brightcove.com/publish/choosing-correct-embed-code.html,在要渲染视频播放器的每个网页的 HTML 中使用“页面内嵌入代码(高级)”代码片段。另请参阅:https://studio.support.brightcove.com/players/generating-player-embed-code.html

虽然此扩展版本 1.1.0 支持在单个网页上嵌入多个 BrightCove 视频,但请确保高级嵌入标签(如果存在)中的 id 属性具有不同的值,例如:player1player2 等。

在具有多个视频的页面上,请注意,每个视频使用在该页面上执行的 Platform Launch 规则中设置的相同配置。例如,如果创建的规则规定在视频播放完 50% 时触发某个事件,则页面上的每个视频都将在 50% 提示点触发该规则。

如果您计划与此扩展一起使用的网页在 Platform Launch 标记有机会完全加载之前可能与视频交互,请考虑同步加载 Platform Launch 库,并将 <script type="text/javascript">\_satellite.pageBottom();\</script\> 标记放在嵌入到页面上的视频之前,以缓解潜在的计时问题。有关参考,请访问 https://docs.brightcove.com/brightcove-player/1.x/Player.html#vjsplayer,其中提供了与此扩展一起使用的 BrightCove API 相关信息。

数据元素

该扩展中有七个可用的数据元素,这些数据元素都不需要进行配置。

  • 播放头位置:​当在 Platform Launch 规则中调用播放头位置时,此数据元素会以秒为单位记录播放头在视频时间轴上的位置。
  • 视频帐户 ID:​此数据元素记录发布视频的 BrightCove 帐户 ID。
  • 视频持续时间:​此数据元素记录视频内容的总持续时间(以秒为单位)。此外,可在 Analytics 内创建一个计算量度,将以秒为单位的数字转换为以分钟或小时为单位。
  • 视频广告支持:​此数据元素指定视频中是否支持广告。
  • 视频 ID:​此数据元素指定与视频关联的 BrightCove ID。
  • 视频名称:​此数据元素指定视频的描述性或友好名称。
  • 视频标签:​此数据元素指定与视频关联的标签。

事件

扩展中有七个可用事件,只有“自定义提示点跟踪”需要配置。

  • 自定义提示点跟踪:​当视频达到指定的视频阈值百分比时,将触发此事件。例如,如果视频时长为 60 秒,而指定的提示点为 50%,则事件将在 30 秒标记处触发。请注意,每次达到此提示点时,都会触发此事件。例如,如果用户达到 50% 标记,在 50% 标记之前搜索视频,然后再次达到 50% 标记,则触发器将再次触发。
  • 视频完成:​当视频播放完时,将触发此事件。
  • 视频加载的元数据:​当播放器收到初始持续时间和维度信息时,将触发此事件。
  • 视频暂停:​当视频暂停时,将触发此事件。
  • 视频恢复:​在暂停事件后恢复视频内容时,将触发此事件。
  • 视频屏幕更改:​当视频切换到全屏模式或从全屏模式切换到其他模式时,将触发此事件。
  • 视频开始:​当视频内容首次启动时,将触发此事件。

使用情况

每个视频事件(上面列出的七个事件)都有一个 Platform Launch 规则。为要跟踪的每个事件创建特定的 Platform Launch 规则。换言之,如果您不想跟踪视频暂停,则无需为其创建规则。

规则包含三个操作:

  1. 设置 Adobe Analytics 变量。(为以上列出的所有或部分数据元素创建数据元素。)
  2. 发送 Adobe Analytics 信标。
  3. 清除 Adobe Analytics 变量。

“视频开始”的 Platform Launch 规则示例

将包括以下视频扩展对象:

事件

  1. “视频开始”:此事件将在访客开始播放 BrightCove 视频时触发规则。

条件

None

操作

  1. 在 Analytics“设置变量”操作中,设置:

    • 视频开始​事件(示例:event17)
    • 视频名称​数据元素的 prop/eVar(示例:eVar10)
    • 视频持续时间​数据元素的 prop/eVar(示例:eVar11)
    • 当前视频位置​数据元素的 prop/eVar(示例:eVar12)
  2. Analytics“发送信标”操作 (s.tl)

  3. Analytics“清除变量”操作

小贴士

对于那些可能不希望为每个视频元素配置多个 eVar 或 prop 的用户,可以在 Platform Launch 中连接数据元素值,接着使用分类规则生成器工具 (https://docs.adobe.com/content/help/zh-Hans/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html) 将其解析到分类报表中,然后作为区段在 Analysis Workspace 中应用。

为此,请创建一个名称类似于“Video MetaData”的新数据元素,然后对其进行编程以提取所有视频数据元素(上面所列),并将它们连接在一起。

var r = [];

r.push( \_satellite.getVar( &#39;Video ID&#39; ) );

r.push( \_satellite.getVar( &#39;Video Name&#39; ) );

r.push( \_satellite.getVar( &#39;Video Duraction&#39; ) );


return r.join(&#39;|&#39;);

在此页面上