1.1.5 • Published 11 months ago

sensor-demo v1.1.5

Weekly downloads
-
License
ISC
Repository
-
Last release
11 months ago

sensor 上报

介绍

探针,以下文档对照钉钉中探针上报表格得出,因为文档很少维护,可能在使用过程中会出现问题,希望在使用测试时完善此文档

使用

yarn add sensor-demo #OR <script src='资源地址'></script>

yarn build # 打包

yarn dev # 热更新

在原生中使用,引入js文件

  1. 如果系统中新引入的神策,先统一执行注册 demo
   $tracker.init({
      initSensorParams: {
        userId: 'gy003',
        model_type: '',
        mac: '',
        registerPageParams: {
          current_url: location.href,
          referrer: document.referrer
        }
      }
    })

!!!我们也可以在init中预设一些参数

   $tracker.init({
      defaultFetchDomain: 'xxxx', // 默认上报地址domain    !!!! 必填
      STBFetchDomain: 'xxxx', // STB 上报Domain   !!! 必填
      enUrl: 'http://10.5.2.17:82/lt/en/', // 热力图地址 !!! 必填
      getReferPageName: () => '哈哈哈', // 如果这里不需要定义,那在上报时需要手动填写ReferPageName参数
      getReferPageUrl: () => 'http://',// 如果这里不需要定义,那在上报时需要手动填写ReferPageUrl参数
      trace_id: 'sssss',  // 需要保存到上下文的参数
      // 注册,登录,如果项目中已经有神策,不需要传此参数
      initSensorParams: {
        userId: 'gy003',
        model_type: '',
        mac: '',
        registerPageParams: {
          current_url: location.href,
          referrer: document.referrer
        }
      }
    })
  1. 再上报
// 先引入文件
<script src=''></script>
// 直接使用Tracker
<script type="javascript/text">
  $tracker.reportTrackerLogger(type, xxxxxx)
</script>

在esmodule中使用

  import tracker from 'xxx'
  tracker.reportTrackerLogger(type, xxxxxx)

参与贡献

  1. Fork 本仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

API

  • reportTrackerLogger 上报
  • registerHandle() 注册探针
  • setParams({}) 保存参数
函数名描述参数
reportTrackerLogger上报(事件类型, 上报参数)

上报事件

ViewColumn 浏览栏目页

属性名描述类型默认值是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
PageType页面类型string-
ReferPageType前向页面类型string-
ReferRecommendID前向推荐位idCSSProperties-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
PageName页面名称stringdocument.title

API reportTrackerLogger

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ViewColumn',{
        ReferPageName: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ClickRecommend: 'http: //localhost: 30001',
        ReferPageType: '推荐',
        ReferPosition: '首页 第3屏 左2',
        ColumnPosition: 30,
        $item_join: ['recommend#2121212']
      })

ViewDetail 浏览详情页

属性名描述类型默认值是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
PageType页面类型string-
ReferPageType前向页面类型string-
ReferRecommendID前向推荐位idstring-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
ContentID内容IDstring-
ContentType页面名称string-
PageName内容名称stringdocument.title
ValueAddedTypeID增值产品包分类编号string-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ViewDetail',{
        ReferPageName: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ClickRecommend: 'http: //localhost: 30001',
        ReferPageType: '推荐',
        ReferPosition: '首页 第3屏 左2',
        ColumnPosition: 30,
        $item_join: ['recommend#2121212'],
        ...
      })

ViewSubject 浏览专题页

属性名描述类型默认值是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
PageType页面类型string-
ReferPageType前向页面类型string-
ReferRecommendID前向推荐位idstring-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
SubjectType专题类型string-
PageName内容名称stringdocument.title

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ViewSubject',{
        ReferPageName: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ClickRecommend: 'http: //localhost: 30001',
        ReferPageType: '推荐',
        ReferPosition: '首页 第3屏 左2',
        ColumnPosition: 30,
        $item_join: ['recommend#2121212'],
        ...
      })

ViewFunction 浏览功能页

属性名描述类型默认值是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
PageType页面类型string-
ReferPageType前向页面类型string-
ReferRecommendID前向推荐位idstring-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
ColumnName栏目名称string-
PageName内容名称stringdocument.title

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ViewFunction',{
        ReferPageName: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ClickRecommend: 'http: //localhost: 30001',
        ReferPageType: '推荐',
        ReferPosition: '首页 第3屏 左2',
        ColumnPosition: 30,
        $item_join: ['recommend#2121212'],
        ...
      })

ViewProductList 浏览订购列表

属性名描述类型默认值是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
ReferPageType前向页面类型string-
ReferRecommendID前向推荐位idstring-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ViewProductList',{
        ReferPageName: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ClickRecommend: 'http: //localhost: 30001',
        ReferPageType: '推荐',
        ReferPosition: '首页 第3屏 左2',
        ColumnPosition: 30,
        $item_join: ['recommend#2121212'],
        ...
      })

ViewProductPay 浏览订购支付

属性名描述类型默认值是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
PageType页面类型string-
ReferPageType前向页面类型string-
ReferRecommendID前向推荐位idstring-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
ContentName内容名称string-
PageName内容名称stringdocument.title
ContentID内容idstring-
Product_code产品包编号string-
product_price产品包价格string-
product_name产品包价string-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ViewProductPay',{
        ReferPageName: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ClickRecommend: 'http: //localhost: 30001',
        ReferPageType: '推荐',
        ReferPosition: '首页 第3屏 左2',
        ColumnPosition: 30,
        $item_join: ['recommend#2121212'],
        ...
      })

ErrorShow 报错提示

属性名描述类型默认值是否必填
ErrorCode错误码string-
ErrorType错误类型string-
ErrorReason错误原因string-
ErrorWord报错文案string-
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ErrorShow',{
        ErrorCode: 'Hi I am a demo',
        ErrorWord: 'http: //localhost: 30001',
        ErrorReason: '推荐',
        ReferPosition: '首页 第3屏 左2',
      })

ClickCollection 点击收藏

属性名描述类型默认值是否必填
ContentID内容IDstring-
ContentType内容名称string-
ChannelCodestringstring-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title

demo

import $tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickCollection',{
        ContentID: 'xxxxxx',
        PageUrl: 'http://localhost:8080',
        ContentType: 'http: //localhost: 30001',
        ReferPosition: '首页 第3屏 左2',
        ChannelCode: '30',
        $item_join: ['recommend#2121212'],
      })

SearchResultNull 搜索结果为空

属性名描述类型默认值是否必填
KeyWord关键词string-
SearchType搜索类型string-
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('SearchResultNull',{
        KeyWord: 'Hi I am a demo',
        PageUrl: 'http://localhost:8080',
        ...
      })

ClickSearchResult 点击搜索结果

属性名描述类型默认值是否必填
ContentID内容IDstring-
ContentType内容类型string-
KeyWord关键词string-
SearchType搜索类型string-
SectionID栏位IDstring-
scene_id场景idstring-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
strategy_id策略idstring-
PageName内容名称stringdocument.title
api_id推荐接口idstring-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickSearchResult',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

ClickFilterWord 点击筛选词

属性名描述类型默认值是否必填
SectionID栏位IDstring-
SectionName栏位名称string-
ContentID内容IDstring-
FilterWord筛选词string-
ContentType内容类型string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title
scene_id场景idstring-
strategy_id策略idstring-
trace_id推荐关联IDstring-
api_id推荐接口idstring-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickFilterWord',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

ClickFilterResult 点击筛选结果

属性名描述类型默认值是否必填
SectionID栏位IDstring-
SectionName栏位名称string-
ContentID内容IDstring-
ContentType内容类型string-
FilterWord筛选词string-
ReferPosition前向位置string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title
scene_id场景idstring-
strategy_id策略idstring-
trace_id推荐关联IDstring-
api_id推荐接口idstring-

demo

import $tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickFilterResult',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

ClickRecommend 推荐位点击

属性名描述类型默认值是否必填
PageContentID页面内容IDstring-
PageType页面类型string-
PageContentName页面内容名称string-
PageContentType页面内容类型string-
SectionID栏位IDstring-
SectionName栏位名称string-
$item_join关联关系string[]-
PageUrl页面地址stringlocation.href
RecommendPosition推荐位位置编号string-
PageName内容名称stringdocument.title
scene_id场景idstring-
strategy_id策略idstring-
trace_id推荐关联IDstring-
api_id推荐接口idstring-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickRecommend',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

TryPlay 试看

属性名描述类型默认值 是否必填
ReferPageName前向页面名称string
ReferPageUrl前向页面地址string
ReferPageType前向页面类型string
ReferPosition前向位置string
ReferRecommendID前向推荐位idstring
ProgramID单片IDstring
$item_join关联关系string[]
PageUrl页面地址stringlocation.href 否
ValueAddedTypeID增值产品包分类编号string
PageName内容名称stringdocument.title
scene_id场景idstring
strategy_id策略idstring
trace_id推荐关联IDstring
EndTime结束时间number
play_duration播放时长number

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('TryPlay',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

PlayBackType 回看(包含老探针)

属性名描述类型默认值 是否必填
ReferPageName前向页面名称string
ReferPageUrl前向页面地址string
ReferPageType前向页面类型string
ReferPosition前向位置string
ReferRecommendID前向推荐位idstring
ChannelCode频道编号string
$item_join关联关系string[]
PageUrl页面地址stringlocation.href 否
ChannelID频道号string
PageName内容名称stringdocument.title
initialPlayTIme节目初始播出时刻string
EndTime结束时间string
play_duration播放时长string
EndTime结束时间number
play_duration播放时长number
channelName频道名string
programName节目string
startTime播放开始时间string
tempDate回看节目单日期string
t事件名event/timing/pageview/exception
tsstring
bs老探针相关参数,参考文档Object

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickRecommend',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        bs: {
          ...
        }
        ...
      })

VodPlay 点播观看 (包含老探针)

属性名描述类型默认值 是否必填
ExternalSource外部来源string
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
ReferPageType前向页面类型string-
ReferPosition前向位置string
ReferRecommendID前向推荐位idstring
$item_join关联关系string[]
PageUrl页面地址stringlocation.href
ValueAddedTypeID增值产品包分类编号string
PageName内容名称stringdocument.title
scene_id场景idstring
strategy_id策略idstring
trace_id推荐关联IDstring
api_id推荐接口idstring
ProgramID单片IDstring
EndTime结束时间number
play_duration播放时长,单位snumber
categoryCodecodestring
programName节目名string
durationOnLive播放时长number
subName老探针相关参数,参考文档number
subCode老探针相关参数,参考文档number
t老探针相关参数,参考文档string
ts时间戳string
subNum老探针相关参数,参考文档string
isfs时间戳string
isd老探针相关参数,参考文档string
ceil老探针相关参数,参考文档string
Ip老探针相关参数,参考文档string
seCaName老探针相关参数,参考文档string
dhCaName老探针相关参数,参考文档string
seWords老探针相关参数,参考文档string
contentName老探针相关参数,参考文档string
startTime老探针相关参数,参考文档string
programCode老探针相关参数,参考文档string
programTime老探针相关参数,参考文档string
uid用户idstring
bs老探针相关参数,参考文档Object

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('VodPlay',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        bs: {
          ...
        }
        ...
      })

TimeShiftPlay 时移

属性名描述类型默认值 是否必填
ReferPageName前向页面名称string
ReferPageUrl前向页面地址string
ReferPageType前向页面类型string-
ReferPosition前向位置string
ReferRecommendID前向推荐位idstring
ChannelCode频道编号string
ChannelID频道号string
$item_join关联关系string[]
PageUrl页面地址stringlocation.href
initialPlayTIme节目初始播出时刻string
PageName内容名称stringdocument.title
EndTime结束时间number-
play_duration播放时长string-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('TimeShiftPlay',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

ClickSubscribe 点击订购

属性名描述类型默认值 是否必填
order_id订单号string
sys_id运营商string
nkcode能开平台结果string
nkdesc能开平台结果描述string
yzm验证码string
sourcePage来源页面string
is_success是否成功string
order_status订单状态string
pakage内容包名称string
ValueAddedTypeID增值产品包分类编号string
ContentID内容IDstring
ContentName内容名称string
product_code产品包编号string
product_price产品包价格string
product_name产品包名称string
pakage_name内容包名string
price支付金额string
Rec_PageName推荐来源页面名称string
Rec_SectionID推荐来源栏位IDstring
$item_join关联关系string[]
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title
scene_id场景idstring
strategy_id策略idstring
trace_id推荐关联IDstring
api_id推荐接口idstring

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('ClickRecommend',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

VideoPause 暂停播放

属性名描述类型默认值 是否必填
ReferPageName前向页面名称string-
ReferPageUrl前向页面地址string-
ReferPageType前向页面类型string
ReferPosition前向位置string
ReferRecommendID前向推荐位idstring
ViewType观看类型string
ChannelCode频道编号string
ChanelID频道号string
ProgramID单片idstring
initialPlayTIme节目初始播出时刻string
play_duration_single单次播放时长string
play_duration累计播放number
$item_join关联关系string[]
PageUrl页面地址stringlocation.href
PageName内容名称stringdocument.title

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('VideoPause',{
        strategy_id: '30001',
        scene_id: '21212',
        SectionID: '2121',
        api_id: '30',
        $item_join: ['xxxx#2121212'],
        ...
      })

bootStrapUser 开机上报(老版)

属性名描述类型默认值是否必填
uid用户idstring-
sidIPTV机顶盒串号string-
t事件类型'event'、'timing'、'exception'-
bs----Object-

bs 参数,以下只是部分参数参考,具体还请根据钉钉中文档来做增减

属性名描述类型默认值是否必填
en用户模板名称string-
sidIPTV机顶盒串号string-
uip用户所属分组string-
epf用户所属能力平台string-
operators用户所属运营商string-
ver探针版本号(移动)string-
usEPG标准模式string-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('bootStrapUser',{
       uid: 'ddd',
       sid: 'xxx',
       bs: {
        ....
       }
      })

uo 心跳(老版)

属性名描述类型默认值是否必填
uid用户idstring-
sidIPTV机顶盒串号string-
t事件类型'event'、'timing'、'exception'-
step间隔时长string-
ti页面名称stringdocument.title
pid---string-
bs----Object-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('uo',{
       uid: 'ddd',
       sid: 'xxx',
       bs: {
        ....
       }
      })

bd pv/uv(老版)

属性名描述类型默认值是否必填
uid用户idstring-
sidIPTV机顶盒型号string-
t事件类型'event'、'timing'、'exception'-
dm用户ip地址string-
ti页面名称stringdocument.title
url访问urlstring-
sh页面heightstring-
swweightstring-
cd颜色质量string-
durationOnBaseDate停留时长string-
bs----Object-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('bd',{
       uid: 'ddd',
       sid: 'xxx',
       ...
       bs: {
        ....
       }
      })

live 直播(老版)

属性名描述类型默认值是否必填
uid用户idstring-
sidIPTV机顶盒型号string-
t事件类型'event'、'timing'、'exception'-
channelName频道名称string-
durationOnLive直播时长number
startTime开始时间number-
isfsstring-
codestring-
bs----Object-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('live',{
       uid: 'ddd',
       sid: 'xxx',
       ...
       bs: {
        ....
       }
      })

vodScore 评分(老版)

属性名描述类型默认值是否必填
uid用户idstring-
sidIPTV机顶盒型号string-
t事件类型'event'、'timing'、'exception'-
score评分string-
programNamestring
scoreTimestring-
contentName内容名称string-
programCodecodestring-
programTypestring-
bs----Object-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('vodScore',{
       uid: 'ddd',
       sid: 'xxx',
       ...
       bs: {
        ....
       }
    })

Activation 活跃(老版)

属性名描述类型默认值是否必填
uid用户idstring-
sidIPTV机顶盒型号string-
t事件类型'event'、'timing'、'exception'-
bs----Object-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('Activation',{
       uid: 'ddd',
       sid: 'xxx',
       ...
       bs: {
        ....
       }
    })

autoTrack 预置热力图

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
// 无须参数
 $tracker.reportTrackerLogger('autoTrack')

trackAllHeatMap 热力图采集

属性名描述类型默认值是否必填
element元素Element-

demo

import tracker from 'xxx'
// 或者
<script src="./xxxx.js"></script>
 $tracker.reportTrackerLogger('trackAllHeatMap', element)
1.1.5

11 months ago

1.1.4

11 months ago

1.1.3

11 months ago

1.1.2

11 months ago

1.1.1

11 months ago

1.0.9

11 months ago

1.0.8

11 months ago

1.0.7

11 months ago

1.0.6

11 months ago

1.0.5

11 months ago

1.0.4

11 months ago

1.0.3

11 months ago

1.0.2

11 months ago

1.0.1

11 months ago

1.0.0

11 months ago