1.1.5 • Published 2 years ago

sensor-demo v1.1.5

Weekly downloads
-
License
ISC
Repository
-
Last release
2 years 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

2 years ago

1.1.4

2 years ago

1.1.3

2 years ago

1.1.2

2 years ago

1.1.1

2 years ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago