YouTube Video Tracking扩展概述

上次更新: 2023-06-06
  • 主题:
  • Tags
    查看有关此主题的更多信息
  • 创建对象:
  • Developer
    User
    Admin
    Leader
注意

Adobe Experience Platform Launch已更名为Adobe Experience Platform中的一套数据收集技术。 因此,产品文档中的术语有一些改动。有关术语更改的综合参考,请参阅以下文档

先决条件

Adobe Experience Platform中的每个标记属性都要求从“扩展”屏幕安装和配置以下扩展:

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

使用 "使用\嵌入播放器<iframe> 标记” 每个要渲染视频播放器的网页HTML中的Google开发人员文档中的代码片段。

YouTube此扩展版本2.0.1支持在单个Web页面上通过插入 id 属性的iframe脚本标记中具有唯一值,并在 enablejsapi=1rel=0src 属性值(如果尚未包含)。 例如:

<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,而不管 enablejsapirel 查询字符串参数存在,并且其预期值是否正确。 因此,可以将YouTube脚本标记添加到包含或不包含 id 属性以及是否 enablejsapirel 是否包含查询字符串参数。

注意

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

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

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

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

数据元素

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

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

事件

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

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

使用情况

可以为每个视频事件(上面列出的七个事件)设置一个标记规则。 为要跟踪的每个事件创建特定的标记规则。 如果您不想跟踪事件,只需忽略以为其创建规则即可。

规则包含三个操作:

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

“视频开始”的标记规则示例

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

  • 事件:“视频开始”(此事件将在访客开始播放YouTube视频时触发规则。)

  • 条件:无

  • 操作: 使用 Analytics扩展 至“设置变量”操作,以映射:

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

    然后,包含“发送信标”操作(s.tl),其链接名称为“视频开始”,随后是“清除变量”操作。

小贴士

对于无法对每个视频元素使用多个eVar或prop的实施,可在Platform中连接数据元素值,使用分类规则生成器工具将其解析为分类报表,如中所述 https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?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('|');

在此页面上