Web 渠道参数详解

最后更新于:2019-11-15 19:22:05

外部文档导航:

本章导航:

1 统计来源相关问题

1.1 关于首次和最近一次属性取值介绍

1.1.1 首次相关属性

  • $first_referrer: 首次前向地址
  • $first_referrer_host: 首次前向域名
  • $first_traffic_source_type: 首次流量来源类型
  • $first_search_keyword: 首次搜索引擎关键词

$first 相关属性是用户在第一次进入加载了 SDK 的页面时,通过 profile_set_once 这一事件给用户添加的用户属性,标明用户首次来源相关信息。

取值介绍:

A.正常获取的属性值

B.用户直接打开页面,没有从其他地方跳转时:

  • $first_referrer 和 $first_referrer_host: 空
  • $first_traffic_source_type: “直接流量”
  • $first_search_keyword: “未取到值,直接打开”

1.1.2 最近一次相关属性

  • $latest_referrer: 最近一次站外地址(只要前向域名不是当前页面的域名,就会重置)
  • $latest_referrer_host: 最近一次站外域名
  • $latest_traffic_source_type: 最近一次流量来源类型
  • $latest_search_keyword: 最近一次搜索引擎关键词

$latest 相关属性是当用户从站外跳转到加载了 SDK 的页面时,会采集这几个参数保存在 cookie 之中,会给所有事件都添加这几个事件属性,标明用户最近一次的来源相关信息。

取值介绍:

A.正常获取的属性值

B.用户直接打开页面,没有从其他地方跳转时:

  • $latest_referrer和$latest_referrer_host: 空
  • $latest_traffic_source_type: “直接流量”
  • $latest_search_keyword: “未取到值,直接打开”

注意:
未取到值:有站外前向地址,尝试获取了,但是没有取到这个属性。
未取到值_直接打开:没有站外前向地址,想获取也获取不到。

C.取值异常:
因为 cookie 被清空了,或者前面一个页面是同域名的,但是没有嵌入 sdk。

D.url 的 domain解析失败:
  1.url 为空
  2.url 解析失败(例如 www.biz.work 等域名无法解析) 参考地址
  3.初始化参数中配置了 current_domain 属性(此属性的使用方法请咨询神策值班同学):
    (1) current_domain 为函数:返回值为空或路径中不含 “.”
    (2) current_domain 为字符串:current_domain 为空或 current_domain 中不含 “.”

E. referrer 的 domain 解析失败:
  1.document.referrer 前向地址解析失败。

1.1.3 广告系列相关参数 

1.用户属性:

  • $utm_source:首次广告系列来源
  • $utm_medium:首次广告系列媒介
  • $utm_term:首次广告系列字词
  • $utm_content:首次广告系列内容
  • $utm_campaign:首次广告系列名称

用户在第一次进入加载了 SDK 的页面时,如果 url 中有 utm 相关的参数,会通过 profile_set_once 这一事件给用户添加对应的用户属性。

2.事件属性(1.6版本支持):

  • $latest_utm_source:最近一次付费广告系列来源(只要有来源参数,就会重置)
  • $latest_utm_medium:最近一次付费广告系列媒介
  • $latest_utm_term:最近一次付费广告系列字词
  • $latest_utm_content:最近一次付费广告系列内容
  • $latest_utm_campaign:最近一次付费广告系列名称

用户进入加载了 SDK 的页面时,如果 url 中有 utm 相关的参数,会将其写入 cookie 中,如果 cookie 中有相同的参数会进行覆盖,之后采集的所有事件都会添加对应的事件属性。

取值介绍:

A.取到正常的属性值

B.未知( url 中没有相关参数)

1.1.4 preset_properties 相关参数:

神策 SDK 采集的最近一次相关的属性会存储在浏览器的 Cookie 中,如果对 Cookie 存储大小有要求,可有选择的采集下列属性, 可配置是否将 $url 作为公共属性。 ( 1.12.18 版本以上,1.14.10 版本以下的相似功能的 SDK 使用的配置 is_track_latest 已做兼容处理 )

//需要 JSSDK 版本号大于 1.14.10
//true表示采集,false表示不采集,未设置的参数取默认值
preset_properties: {
    //是否采集$latest_utm最近一次广告系列相关参数,默认值true
    latest_utm:true,
    //是否采集$latest_traffic_source_type最近一次流量来源类型,默认值true
    latest_traffic_source_type:true,
    //是否采集$latest_search_keyword最近一次搜索引擎关键字,默认值true
    latest_search_keyword:true,
    //是否采集$latest_referrer最近一次前向地址,默认值true
    latest_referrer:true,
    //是否采集$latest_referrer_host最近一次前向地址,1.14.8以下版本默认是true,1.14.8及以上版本默认是false,需要手动设置为true开启
    latest_referrer_host:false,
    //是否采集$latest_landing_page最近一次落地页地址,默认值false
    latest_landing_page:false,
    //是否采集 $url 页面地址作为公共属性,默认值false
    url: false
}

1.2 流量来源类型说明

关于首次流量来源类型 $first_traffic_source_type 及最近一次流量来源类型 $latest_traffic_source_type 的判断逻辑:
如果落地页面地址中含有 utm 参数,就是付费广告流量
如果不是付费广告流量且前向地址中包含 search 中的参数算自然搜索流量,
如果不是付费广告流量且前向地址中包含 social 中的参数算社交网站流量,
如果前向地址为空是直接流量,
如果以上都不是(前向地址不为空)那么是引荐流量,
其他情况为异常。

注意,其中 search 及 social 为可配参数,参数名为 source_type: 自定义搜索引擎流量,社交流量,搜索关键词。具体用法如下:

神策已有参数:
search_type = ['www.baidu.','m.baidu.','m.sm.cn','so.com','sogou.com','youdao.com','google.','yahoo.com/','bing.com/','ask.com/'];
social_type = ['weibo.com','kaixin001.com','douban.com','qzone.qq.com','zhihu.com','tieba.baidu.com','weixin.qq.com'];

source_type :{
    search: ['.baidu.com','.google.'],
    social: ['.kaixin001.com'],
    keyword: {baidu:['wd','word','keyword'],sogou:'query'}
}

可以先通过 sensors.para.source_type.search 等方式,来查看目前已经定义的部分判定条件。 如果你有新的判断条件想要增加,可以通过上述代码,来扩展。
search 内容是数组,把 url 中包含特征的字符串作为判定条件,比如包含 .baidu.com 就认为是搜索引擎流量。
social 同上,也是包含特征字符串,就认为是社交流量。
keyword 内容是一个对象,key 是取的去掉域名后缀的字符串 , value 可以是关键词的字符串,也可以是一个包含有可能是关键词的数组。