1. 用戶相關屬性

屬性名	名稱	更新機制
$first_referrer	首次參照位址	僅在新裝置首次打開嵌入了 Web JS SDK 的頁面並且開啟了 sa.quick('autoTrack') 或者 sa.quick("autoTrackSinglePage")，才會自動觸發 profile_set_once 寫入神策用戶表（以後不會再自動採集更新）。
$first_referrer_host	首次參照位址網域
$first_traffic_source_type	首次流量來源類型
$first_search_keyword	首次搜尋引擎關鍵字
$utm_source	首次廣告系列來源
$utm_medium	首次廣告系列媒介
$utm_term	首次廣告系列字詞
$utm_content	首次廣告系列内容
$utm_campaign	首次廣告系列名稱
xxx	source_channel 自定義管道來源屬性: ['xxx', 'yyy']
yyy	source_channel 自定義管道來源屬性: ['xxx', 'yyy']

2. 事件相關屬性

屬性名	名稱	備註	更新機制
$referrer	參照位址	$pageview 才有該屬性	不區分站內站外，頁面網址變化即更新。
$referrer_host	參照網域名		不區分站內站外，頁面網址變化即更新。
$utm_xxx	廣告系列來源屬性(包括：$utm_source、$utm_medium、$utm_term、$utm_content、$utm_campaign)		不區分站內站外，頁面網址變化且帶有 utm 或自定義管道屬性 xxx，即局部 utm 或 xxx 更新(對應的 latest_xxx 或 _latest_xxx 也會更新)。
xxx (source_channel 自定義管道來源屬性)	自定義管道屬性(比如：source_channel:['xxx'])
_latest_xxx	最近一次自定義管道屬性(比如：source_channel:['xxx'])
$latest_utm_xxx	最近一次廣告系列來源屬性(包括：$latest_utm_source、$latest_utm_medium、$latest_utm_term、$latest_utm_content、$latest_utm_campaign)	預設採集可透過設定 preset_properties 控制是否採集所有事件都有該屬性
$latest_referrer	最近一次站外參照位址		latest 最近一次，根據網域名判斷是否從站外跳轉進來，如果是，則更新(同網域名站內跳轉不更新)。
$latest_traffic_source_type	最近一次站外流量來源類型
$latest_search_keyword	最近一次站外搜尋引擎關鍵詞
$latest_landing_page	最近一次到達頁面網址	預設不採集可透過設定 preset_properties 控制是否採集所有事件都有該屬性
$latest_referrer_host	最近一次站外參照網域	預設不採集可透過設定 preset_properties 控制是否採集所有事件都有該屬性

3. 一般場景取值

3.1. 流量來源類型 traffic_source_type

關於首次流量來源類型 $first_traffic_source_type 及最近一次流量來源類型 $latest_traffic_source_type 的取值邏輯：

屬性名	取值	場景
$first_traffic_source_type $latest_traffic_source_type	付費廣告流量	到達頁面網址含有 utm_xxx 參數。
	自然搜尋流量	到達頁面網址無 utm_xxx 參數且參照位址中包含search 中的參數：神策已有參數['www.baidu.','m.baidu.','m.sm.cn','so.com','sogou.com','youdao.com','google.','yahoo.com/','bing.com/','ask.com/'];
	社群網站流量	到達頁面網址無 utm_xxx 參數且參照位址中包含 social 中的參數: 神策已有參數：['weibo.com','kaixin001.com','douban.com','qzone.qq.com','zhihu.com','tieba.baidu.com','weixin.qq.com'];
	直接流量	如果參照位址為空：直接複製網址或者點擊書籤打開頁面。
	推薦流量	如果以上情況都不是，比如參照位址為某個私人網站。

可以先透過 sensors.para.source_type.search 等方式，來查看目前已經定義的部分判定條件。如果你有新的判斷條件想要增加，可以透過以下程式碼，來擴展。

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

3.2. 搜尋引擎關鍵詞 search_keyword

關於首次搜尋引擎關鍵詞 $first_search_keyword 及最近一次搜尋引擎關鍵詞 $latest_search_keyword 的取值邏輯，從 $referrer 中解析獲取（由於現在搜尋引擎大多不提供關鍵詞，所以大概率會未取到值）：

屬性名

取值

場景

$first_search_keyword

$latest_search_keyword

xxx關鍵詞

比如：source_type :{
search: ['.baidu.com','.google.'],
keyword: {
baidu:['wd','word','keyword'],
sogou:'query'}
}參照位址為：www.baidu.com?...&keyword=xxx&...;
則此時可以解析到，取值為：xxx

未取到值

有參照位址，但不符合上面的情況，則取值為：未取到值。

未取到值_直接打開

參照位址為空：直接複製網址或者點擊書籤打開頁面。

3.3. 場景範例

屬性名	百度（搜尋：神策，點擊無 utm 的連接） => A頁面	A 頁面 => B 頁面	C 頁面(直接打開)	C 頁面 => D 頁面	搜狗（搜尋：神策，點擊带 utm 的連接） => A頁面
$referrer	百度url	A 頁面url	空字串	C 頁面url	搜狗url
$referrer_host	www.baidu.com	A 頁面網域名	空字串	C 頁面網域名	www.sogou.com
$latest_referrer	百度url	百度url	空字串	空字串	搜狗url
$latest_referrer_host	www.baidu.com	www.baidu.com	空字串	空字串	搜狗網域名
$latest_traffic_source_type	自然搜尋流量	自然搜尋流量	直接流量	直接流量	付費廣告流量
$latest_search_keyword	神策	神策	未取到值_直接打開	未取到值_直接打開	未取到值
$latest_landing_page	A 頁面url	A 頁面url	空字串	空字串	A 頁面url

4. 常見問題

4.1. 參照位址 referrer 與參照域名 referrer_host 特殊場景

屬性名	屬性值	原因
$first_referrer	空字串	直接打開頁面（比如：輸入網址或書籤打開）。
$first_referrer_host	未知
$referrer	空字串
$referrer_host	空字串
$latest_referrer	空字串
$latest_referrer_host	空字串

4.2. 最近一次( $latest_xxx )相關屬性的特殊場景

屬性名	原因：cookie被清空或前一個頁面同網域但未整合 SDK	原因：當前頁面網域 domain 無法解析（比如：www.biz.work、localhost、192.168.11.23 等）
$latest_utm_xxx	正常解析 $utm_xxx 並更新 $latest_utm_xxx 屬性	正常解析 $utm_xxx 並更新 $latest_utm_xxx 屬性
$latest_traffic_source_type	取值異常	url的domain解析失敗
$latest_search_keyword	取值異常	url的domain解析失敗
$latest_referrer	取值異常	url的domain解析失敗
$latest_referrer_host	取值異常	取值異常
$latest_landing_page	取值異常	url的domain解析失败