Show Menu
主题×

Video Analytics

此信息可帮助您使用视频分析。
Video measurement is described in detail in the Measuring audio and video in Adobe Analytics guide. 在所有 AppMeasurement 平台中,测量视频的大概过程都非常相似。此快速入门部分提供开发人员任务的基本概述以及代码示例。
下表列出了发送到 Analytics 的媒体数据。使用处理规则将上下文数据映射到Analytics变量。
  • a.media.name
    (必需)当访客以某种方式查看视频时,收集在实施中指定的视频名称。您可以为此变量添加分类。
    可选 )自定义分析变量提供视频路径信息。
    • 变量类型:eVar
    • 默认过期:访问
    • 自定义分析(s.prop,用于视频路径)
  • a.media.name
    (可选)提供视频路径信息。必须由 ClientCare 为此变量启用路径。
    事件类型:自定义分析 (s.prop)
    • 变量类型:自定义分析(s.prop)
  • a.media.segment
    (必需)收集视频区段数据,包括区段名称以及区段在视频中出现的顺序。此变量在自动跟踪播放器事件时通过启用 segmentByMilestones 变量来填充,或在手动跟踪播放器事件时通过设置自定义区段名称来填充。For example, when a visitor views the first segment in a video, SiteCatalyst might collect the following in the 1:M:0-25 segment eVar.
    默认视频数据收集方法在以下时间点收集数据:
    • 视频开始(播放)
    • 区段开始
    • 视频结束(停止) 当访客开始观看时,Analytics 会在第一个区段开始时计数第一个区段查看次数。后续区段查看次数会在相应区段开始时进行计数。
    • 变量类型:eVar
    • 默认过期:页面查看
  • a.contentType
    收集由访客查看的内容类型相关数据。由视频测量发送的点击量将被分配内容类型“视频”。此变量不需要专门为视频跟踪而进行保留。通过使用此相同变量让其他内容报告内容类型,您可以分析访客在不同内容类型之间的分布。例如,您可以使用此变量通过“article”或“product page”之类的值标记其他内容类型。从视频测量角度,内容类型可让您识别视频访客并计算视频转化率。
    • 变量类型:eVar
    • 默认过期:页面查看
  • a.media.timePlayed
    以秒为单位,计算自上次数据收集流程(图像请求)以来,观看视频所花费的时间。
    • 变量类型:活动
    • 类型:计数器
  • a.media.view
    表明访客已查看了视频的某些部分。但是它并不提供有关访客查看了视频中的多少内容或哪一部分的信息。
    • 变量:活动
    • 类型:计数器
  • a.media.segmentView
    表明访客已查看了视频区段的某些部分。但是它并不提供有关访客查看了视频中的多少内容或哪一部分的信息。
    • 变量类型:活动
    • 类型:计数器
  • a .media.complete
    表明用户已查看了完整的视频。默认情况下,完整的事件会在视频结束前 1 秒进行测量。在实施过程中,您可以指定希望在距离视频结束有多少秒时被视为查看结束。对于实时视频和其他未定义结尾的流,您可以指定一个自定义时间点来测量结束。例如,在查看了特定时间之后。
    • 变量类型:活动
    • 类型:计数器

Configure media settings

使用您要用于跟踪视频的设置配置 MediaSettings 对象:
var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId");

Track player events

To measure video playback, The Play , Stop , and Close methods need to be called at the appropriate times. 例如,暂停播放器时,调用 Stop 。开始或继续播放时,调用 Play

类:MediaSettings

property Platform::String ^name; 
property Platform::String ^playerName; 
property Platform::String ^playerID; 
property double length; 
property Platform::String ^channel; 
property Platform::String ^milestones; 
property Platform::String ^offsetMilestones; 
property bool segmentByMilestones; 
property bool segmentByOffsetMilestones; 
property int trackSeconds; 
property int completeCloseOffsetThreshold; 
 
// MediaAnalytics Ad settings 
property Platform::String ^parentName; 
property Platform::String ^parentPod; 
property Platform::String ^CPM; 
property double parentPodPosition; 
property bool isMediaAd;

Media measurement class and method reference

  • 设置使用(winJS:设置(使用)
    通过指定的参数返回 MediaSetting 对象。
    • 下面是这种方法对应的语法:
      static MediaSettings ^SettingsWith(Platform::String ^name, double length, Platform::String ^playerName, Platform::String ^playerID); 
      
      
    • 以下是这种方法的代码示例:
      var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId"); 
      
      
  • AdSettingsWith(winJS:adSettingsWith
    返回用于跟踪广告视频的 MediaSettings 对象。
    • 下面是这种方法对应的语法:
      static MediaSettings ^AdSettingsWith(Platform::String ^name, double length, Platform::String ^playerName, Platform::String ^parentName, Platform::String ^parentPod, double parentPosition, Platform::String ^CPM); 
      
      
    • 以下是这种方法的代码示例:
      var myAdSettings = ADB.Media.adSettingsWith("name", 10, "playerName", "parentName", "parentPod", 5, "myCPM"); 
      
      
  • 打开(winJS:打开)
    Tracks a media open using the settings defined in settings .
    • 下面是这种方法对应的语法:
      static void Open(MediaSettings ^settings);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.open(mySettings); 
      
      
  • 关闭(winJS:关闭)
    跟踪名为“name”**​的媒体项目的媒体关闭。
    • 下面是这种方法对应的语法:
      static void Close(Platform::String ^name);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.close("mediaName");
      
      
  • 播放(winJS:播放)
    在给定的“offset” name 时间(以秒为单位)跟踪名为“” **​的媒体项目的媒体播放。
    • 下面是这种方法对应的语法:
      static void Play(Platform::String ^name, double offset);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.play("mediaName", 0);
      
      
  • 完整计划(winJS:完成)
    在提供的“offset”**​时间(以秒为单位)将媒体项目手动标记为完成。
    • 下面是这种方法对应的语法:
      static void Complete(Platform::String ^name, double offset);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.complete("mediaName", 8); 
      
      
  • 停止(winJS:停止)
    通知媒体模块已在给定的“offset”**​时间停止或暂停视频。
    • 下面是这种方法对应的语法:
      static void Stop(Platform::String ^name, double offset);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.stop("mediaName", 4);
      
      
  • 单击(winJS:单击)
    通知媒体模块已单击媒体项目。
    • 下面是这种方法对应的语法:
      static void Click(Platform::String ^name, double offset);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.click("mediaName", 3);
      
      
  • 跟踪(winJS:跟踪)
    发送用于获取当前媒体状态的跟踪操作调用(无页面查看)。
    • 下面是这种方法对应的语法:
      static void Track(Platform::String ^name, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData);
      
      
    • 以下是这种方法的代码示例:
      ADB.Media.track("mediaName", null);