YouTube视频跟踪扩展概述

注意

Adobe Experience Platform Launch正在Experience Platform中被重新命名为一套数据收集技术。 这些更改将在未来几周内在所有产品文档中推广。 有关术语更改的统一参考，请参阅以下文档。

先决条件

每个 Adobe Experience Platform Launch 属性都需要从“扩展”页面安装和配置以下扩展：

  • Adobe Analytics
  • Experience Cloud 访客 ID 服务
  • 核心扩展

根据 https://developers.google.com/youtube/player_parameters，在要呈现视频播放器的每个网页的 HTML 中，使用“Embed a player using an tag”代码片断。

此扩展版本2.0.0支持在单个Web页面上嵌入一个或多个YouTube视频，方法是在iframe脚本标记中插入具有唯一值的id属性，并将enablejsapi=1和rel=0附加到src属性值的末尾（如果尚未包含），例如：

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

请注意，此扩展还设计为动态检查唯一ID属性值，如player1，查询字符串参数是否存在，以及它们的预期值是否正确。 enablejsapi rel因此，可以将YouTube脚本标记添加到具有或不具有id属性的网页，以及是否包含enablejsapi和rel查询字符串参数。

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

该扩展依赖以下逻辑来重写iFrame:

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

因此，页面加载后会出现轻微闪烁。此行为是符合预期的。

数据元素

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

  • 播放头位置：​当在 Launch 规则中调用播放头位置时，会以秒为单位记录播放头在视频时间轴上的位置。
  • 视频 ID：​指定与视频关联的 YouTube ID。
  • 视频名称：​指定视频的描述性或友好名称。
  • 视频 URL：​返回当前已加载/正在播放视频的 YouTube.com URL。
  • 视频持续时间：​记录视频内容的总持续时间（以秒为单位）。
  • 扩展版本： 此数据元素记录YouTube跟踪扩展版本，例如“Video Tracking_YouTube_2.0.0”。

事件

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

  • 视频就绪：​提示并准备播放视频时触发。
  • 视频开始：​视频首次开始播放，并且 player.getCurrentTime() === 0 时触发。
  • 视频重播：​提示并在初始开始后重播视频时触发。此触发器将在每次重播视频时触发。
  • 视频暂停：​视频暂停时触发。
  • 视频恢复：​视频恢复，并且 player.getCurrentTime() !== 0 时触发。
  • 自定义提示跟踪：​视频达到指定的视频阈值百分比时触发。例如，如果视频为 60 秒，而指定的提示点为 50%，则当播放头位置位于 30 秒处时，会触发事件。提示点跟踪适用于初次播放和重播。请注意，如果用户试图越过提示点，则不会触发该事件。只有在播放头穿过时间轴上计算出的提示点位置，并且视频播放器正在播放时，才会触发提示点事件。
  • 视频缓冲：​当播放器在开始播放视频之前下载一定数量的数据时触发。
  • 视频结束：​视频完全结束时触发。

使用情况

每个视频事件都有一个Platform launch规则（如上所示）。 因此，此扩展的用户需要为要跟踪的每个事件创建特定的Platform launch规则。 换言之，如果他们不想跟踪视频暂停，则不会为其创建规则。

规则包含三个操作：

  • 设置变量：​设置 Adobe Analytics 变量（映射到所有或部分包含的数据元素）。
  • 发送信标：​作为自定义链接跟踪调用发送 Adobe Analytics 信标，并提供“链接名称”值。
  • 清除变量：​清除 Adobe Analytics 变量。

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

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

事件：

“视频开始”（此事件将在访客开始播放 YouTube 视频时触发规则。）

条件：无

操作：使用 Analytics 扩展：

“设置变量”操作，以映射：

  • 视频开始事件、
  • 视频持续时间数据元素的 prop/eVar
  • 视频 ID 数据元素的 prop/eVar
  • 视频名称数据元素的 prop/eVar
  • 视频 URL 数据元素的 prop/eVar

然后，包括链接名称为“视频开始”的“发送信标”操作 (s.tl)，最后是“清除变量”操作。

小贴士

对于无法为每个视频元素使用多个eVar或prop的实现，可以在Platform launch中连接数据元素值，使用分类规则生成器工具将其解析为分类报表(如https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?lang=zh-Hans?lang=zh-Hans中所述)，然后作为区段在Analysis Workspace中应用。

要连接视频信息值，请创建一个名为“视频元数据”的新数据元素，然后对其进行编程，以拉入以上列出的所有视频数据元素并将它们组合在一起。例如：

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));

return r.join('|');

在此页面上