什麼是“維度字典”

針對已經存在的事件屬性和用戶屬性，可以上傳屬性值的自定義映射關聯。 在過濾，分組中可以使用帶有維度字典的屬性。如下圖所示，維度字典的屬性右側會有字典標示，螢幕寬度，操作系統版本，性別都是有維度字典的屬性。

使用範例

界面上傳維度字典

點擊頁面左下角的元數據，可以在用戶屬性頁面和事件屬性頁面上傳屬性的維度字典。

  • 首先建立維度字典，字典命名加上 .txt 後綴。
  • 支援上圖所示的分隔方式，選擇的分隔符樣式必須和維度字典中分隔符一致。分隔符左邊是原始值，右邊是替換的值。注意：字典中的分隔符樣式都要使用英文的分隔符。同時字典每一行分隔符左邊不要出現和分隔符相同的字符。這裡因為維度字典每一行用","分隔，所以分隔符樣式選擇","。
640,a
1080,b
1920,c
2048,d

1.瀏覽屬性頁面

如下圖所示，只有文本型別和數值型別的屬性可以上傳維度字典，點擊按鈕可上傳。

2.上傳維度字典

  • 上傳可以選擇新增上傳，現有的字典會保留。覆蓋會清空之前的字典再上傳。點擊確認開始上傳。
    注意：維度字典
    （神策分析 1.12 版本之前）是一對一映射，即逗號的左邊列和右邊列的取值都必須是唯一的。
    （神策分析 1.12 及版本之後）維度字典支援多對一，針對已經存在的事件屬性和用戶屬性，可以上傳屬性值的自定義多對一映射關係。

3.清空維度字典

所有有維度字典的屬性右側會出現刪除按鈕，表示可以清除維度字典。

上傳維度字典api

通過發送 http post 請求［/property/dict/upload］，可以上傳字串型別或數值型別屬性的維度字典。

  • Parameters
    • propertyName: 上傳的屬性名，必須是已有屬性的屬性名，比如 $os_version, Gender
    • type: 上傳的屬性型別，property 或者 profile，表示是事件屬性還是用戶屬性。
    • isIncrement: bool 型別，表示是否增量上傳。false表示全量上傳，會清空之前對應屬性的字典再上傳。true表示增量上傳。
    • file: 上傳一個屬性的維度字典，最大不超過 100M。維度字典每行用逗號分隔，逗號左邊是屬性值，逗號右邊是用戶定義的屬性值對應的映射後的值。文件必須是 UTF-8 編碼。
    • split: 可選參數，預設是逗號分隔。比如自定義字典使用“|“分割，則 split 值為“|“。
  • Response 200

比如用戶要上傳事件屬性 $os_version 的維度字典，發送如下指令：

curl 'http://$WEB_URL/api/property/dict/upload?project=$PROJECT_NAME&propertyName=$os_version&type=property&isIncrement=true&token=$API_SECRET' -X POST -F "file=@$PATH"

  • 替換 $WEB_URL, $PROJECT_NAME, $API_SECRET, $PATH 四個參數。$WEB_URL 是網站的 URL；$PROJECT_NAME 是 project名； $API_SECRET 可以使用 admin 帳號登入系統後，在帳戶管理界面獲取；$PATH 是屬性維度字典在本地的路徑。

  • file:

8.1,第一版
8.2,第二版
8.0,第三版

注意：維度字典

（神策分析 1.12 版本之前）是一對一映射，即逗號的左邊列和右邊列的取值都必須是唯一的。
（神策分析 1.12 及版本之後）維度字典支援多對一，針對已經存在的事件屬性和用戶屬性，可以上傳屬性值的自定義多對一映射關係。 

2.3 下載維度字典

對於有維度字典的屬性，可以下載已有的數據字典，預設保存為 txt 文件。   

2.4 篩選表達式

對於有維度字典的屬性，不管是字串型別還是數值型別，篩選條件都只有四類：

  • equal to/ does not equal to，表示等於/不等於
  • has value / has not value，表示有值/沒值

2.5 結果展示

以事件分析為例，獲取2015-10-18至2015-10-20買入黃金的總次數，其中操作系統是第一版。因為操作系統版本是有維度字典的屬性，過濾條件和結果分組列表中，都是顯示的用戶定義後的值。對於字典中沒有覆蓋的值，會顯示原來的值。在漏斗分析，留存分析等功能中，有維度字典的屬性使用情況類似。

2.6 清空維度字典

參數含義和上傳維度字典類似，比如要清空剛才上傳的$os_version的維度字典，則執行下面的指令。

curl 'http://$WEB_URL/api/property/dict/empty?propertyName=$os_version&type=property&token=$AP