视频自定义提示跟踪器：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 属性具有不同的值，例如：player1、player2 等。

在具有多个视频的页面上，请注意，每个视频使用在该页面上执行的 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“清除变量”操作

var r = [];

r.push( \_satellite.getVar( 'Video ID' ) );

r.push( \_satellite.getVar( 'Video Name' ) );

r.push( \_satellite.getVar( 'Video Duraction' ) );


return r.join('|');