文档AnalyticsMedia Analytics 指南

自定义链接实施指南 custom-link-implementation-guide

Last update: Tue Jan 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • User
  • Admin
  • Developer

自定义视频跟踪可利用 Analytics appMeasurement 中的使用自定义链接代码的手动链接跟踪。大多数情况下，自定义视频链接视频跟踪会用在需要少量视频测量的平台和设备上。

要求

  • 访问视频播放器 API 事件和数据
  • 在使用 Analytics SDK 时能够添加脚本
  • 如果使用 Data Insertion API，则能够添加跟踪信标（自定义脚本或硬编码）

元数据

  • 可以将元数据作为链接数据的一部分添加到任何跟踪调用中
  • 请记住要更新 linkTrackVars 和 linkTrackEvents
/* Call on video complete */

if (e.type == "ended") {
    s.linkTrackVars = 'events, prop10, eVar10, eVar12, eVar13, eVar15';
    s.linkTrackEvents = 'event3';
    s.prop10 = mediaName;
    s.eVar10 = mediaName;
    s.eVar12 = "video";
    s.eVar13 = document.title;
    s.eVar15 = mediaPlayerName;
    s.events = 'event3';
    s.tl(this,'o','Video Complete');
};

使用自定义链接的理由

  • 需要满足最低的先决条件
  • 适用于任何平台，包括无脚本
  • 任何计算（如逗留时间或四分位点）都必须在自定义脚本中计算
  • 无隐藏库或脚本，非常简单直观
  • 全面控制视频数据的各个方面

适用于 HTML5 播放器的 JavaScript 示例

<script type="text/javascript">
  myvideo = document.getElementById('movie');
  myvideo.addEventListener('play',myHandler,false);
  myvideo.addEventListener('seeked',myHandler,false);
  myvideo.addEventListener('seeking',myHandler,false);
  myvideo.addEventListener('pause',myHandler,false);
  myvideo.addEventListener('ended',myHandler,false);

  function myHandler(e) {
      var video = document.getElementsByTagName('video')[0];
      var mediaName="13502979:Sailing";
      var mediaLength = video.duration;
      var mediaPlayerName = "HTML5 Player";
      /*Define video offset*/
      if (video.currentTime > 0) {
          mediaOffset = Math.floor(video.currentTime);
      } else {
          mediaOffset = 0;
      };
      /*Call on video start*/
      if (e.type == "play") {
          if (mediaOffset == 0) {
              console.log(mediaPlayerName +
                ' -> start -> playhead: ' +
                Math.floor(video.currentTime));
              s.linkTrackVars='events,prop10,eVar10,eVar12,eVar13,eVar15';
              s.linkTrackEvents='event2';
              s.prop10=mediaName;
              s.eVar10=mediaName;
              s.eVar12="video";
              s.eVar13=document.title;
              s.eVar15=mediaPlayerName;
              s.events='event2';
              s.tl(this,'o','Video Start');
          }
      };

      /*Call on video pause*/
      if (e.type == "pause") {
          console.log(mediaPlayerName +' -> pause -> playhead: ' + Math.floor(video.currentTime));
          if (video.currentTime != video.duration) {
              s.linkTrackVars='events,prop10,eVar10,eVar12,eVar13,eVar15';
              s.linkTrackEvents='event7';
              s.prop10=mediaName;
              s.eVar10=mediaName;
              s.eVar12="video";
              s.eVar13=document.title;
              s.eVar15=mediaPlayerName;
              s.events='event7';
              s.tl(this,'o','Video Pause');
          }
      };

      /*Call on video complete*/
      if (e.type == "ended") {
          console.log(mediaPlayerName +
            ' -> ended -> playhead: ' +
            Math.floor(video.currentTime));
          s.linkTrackVars = 'events, prop10, eVar10, eVar12, eVar13, eVar15';
          s.linkTrackEvents = 'event3';
          s.prop10= m ediaName;
          s.eVar10=mediaName;
          s.eVar12="video";
          s.eVar13=document.title;
          s.eVar15=mediaPlayerName;
          s.events='event3';
          s.tl(this,'o','Video Complete');
      };
  };
</script>
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb