跳到內容

用戶屬性對象

一個API請求中的任何字段屬性對象創建或更新一個屬性的名稱與給定的值指定的用戶配置文件。

使用釺用戶配置文件字段名稱(列出如下或任何部分中列出釺用戶配置文件字段)來更新這些特殊值在儀表板用戶配置文件或添加您自己的自定義屬性數據給用戶。

對象的身體


          
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
{/ /一個“external_id”“user_alias”“braze_id”要求“external_id”:(可選,字符串)看到外部用戶ID,“user_alias”:(可選,用戶別名對象),“braze_id”:(可選,字符串)用戶標識符,/ /設置國旗真正的API“隻更新”模式。/ /使用一個“user_alias”,“隻更新”違約真正的“_update_existing_only”:(可選,布爾型),/ /看到請注意關於匿名令牌進口“push_token_import”:(可選,布爾型),/ /用戶配置文件字段“first_name”:“喬”,“電子郵件”:(電子郵件保護),/ /自定義屬性“my_custom_attribute”:價值,“my_custom_attribute_2”:{“公司”:int_value},“my_array_custom_attribute”:【“Value1”,“Value2”),/ /添加一個價值一個數組自定義屬性“my_array_custom_attribute”:{“添加”:(“Value3”]},/ /刪除一個價值一個數組自定義屬性“my_array_custom_attribute”:{“刪除”:(“Value1”)},}

刪除配置文件屬性,設置它。一些字段,如external_iduser_alias添加到用戶配置文件不能刪除一次。

更新現有的配置文件隻

如果你想在釺隻更新現有的用戶配置文件,你應該通過_update_existing_only關鍵的價值真正的你的請求。如果省略該值,釺會創建一個新的用戶配置文件external_id不存在。

把令牌進口

進口推動令牌釺之前,如果你需要仔細檢查。當釺sdk,他們自動處理把令牌不需要上傳通過API。

如果你發現你需要上傳通過API,他們可以識別用戶或匿名用戶上傳。這意味著一個external_id需要,或匿名用戶必須有push_token_import標誌設置為真正的

當指定push_token_import作為真正的:

  • external_idbraze_id應該被指定
  • 屬性對象必須包含一個令牌推
  • 如果令牌已經存在在釺,請求被忽略;否則,釺將創建一個臨時的,匿名用戶配置文件為每個令牌來讓你繼續這些個人信息

導入後,每個用戶啟動Braze-enabled版本的應用程序,釺會自動移動他們的進口推牌釺用戶配置文件和清理臨時配置文件。

銅焊將檢查每月一次找到任何匿名的概要文件push_token_import國旗沒有把令牌。如果匿名概要文件不再把令牌,我們將刪除這個概要文件。然而,如果匿名資料仍然有令牌,這表明實際的用戶尚未登錄到設備說推牌,我們將什麼都不做。

有關更多信息,請參考遷移把令牌

自定義屬性的數據類型

以下數據類型可以存儲為一個自定義屬性:

數據類型 筆記
數組 自定義屬性數組是一維集;不支持多維數組。將一個元素添加到一個自定義屬性數組元素附加到數組的末尾,除非它已經存在,在這種情況下,它被從其當前位置移動到數組的末尾。

例如,如果一個數組[“熱狗”,“熱狗”,“熱狗”,'披薩']進口,它會顯示在數組屬性(“熱狗”,“比薩”)因為隻有惟一的值都受支持。

除了設置說類似數組的值“my_array_custom_attribute”:【“Value1”、“Value2”】你可以添加到現有的數組通過類似“my_array_custom_attribute”:{“添加”:[“Value3”)},或刪除值通過類似數組“my_array_custom_attribute”:{“刪除”:[“Value1”]}

元素在自定義屬性數組的最大數量默認為25,但可以增加多達100為一個單獨的數組。有關更多信息,請參見數組
布爾值
日期 必須存儲在嗎yyyy-MM-ddTHH: mm: ss: SSSZ
- - - - - -yyyy-MM-ddTHH: mm: ss
- - - - - -yyyy-MM-dd HH: mm: ss
- - - - - -yyyy-MM-dd
- - - - - -MM / dd / yyyy
- - - - - -ddd MM dd HH: MM: ss。TZD YYYY

注意,“T”是一個指示器,不是一個占位符,不應該改變或刪除。

時屬性沒有時區會默認到午夜UTC(並將格式化的儀表盤上的相當於午夜UTC公司的時區)。

事件與時間戳在未來將默認為當前時間。

定期定製屬性,如果大於或小於0 3000年,釺存儲這些值作為字符串的用戶。
浮點數
整數 整數自定義屬性可能增加了積極或消極的整數通過分配一個對象的字段“公司”,你想增加他們的價值。

例子:“my_custom_attribute_2”:{“公司”:int_value},
字符串

的信息當你應該使用一個定製的事件和一個自定義屬性,看到我們的各自的文檔自定義事件自定義屬性

釺用戶配置文件字段

用戶配置文件字段 數據類型規範
alias_name (字符串)
alias_label (字符串)
braze_id (可選的字符串),當一個用戶配置文件是通過SDK認可,匿名用戶配置文件創建一個關聯braze_id。的braze_id由釺自動分配,不能被編輯,是特定於設備的。
國家 (字符串)我們要求國家代碼傳遞給釺yyyy-MM-ddTHH: mm: ss: SSSZ
- - - - - -yyyy-MM-ddTHH: mm: ss
- - - - - -yyyy-MM-dd HH: mm: ss
- - - - - -yyyy-MM-dd
- - - - - -MM / dd / yyyy
- - - - - -ddd MM dd HH: MM: ss。TZD YYYY
date_of_last_session (日期用戶最後一次使用app) ISO 8601格式的字符串或有下列格式:
- - - - - -yyyy-MM-ddTHH: mm: ss: SSSZ
- - - - - -yyyy-MM-ddTHH: mm: ss
- - - - - -yyyy-MM-dd HH: mm: ss
- - - - - -yyyy-MM-dd
- - - - - -MM / dd / yyyy
- - - - - -ddd MM dd HH: MM: ss。TZD YYYY
強加於人 (出生日期)字符串格式“YYYY-MM-DD”,例如,1980-12-21。
電子郵件 (字符串)
email_subscribe (字符串)可用值“opted_in”(明確注冊接收電子郵件消息),“unsubscribed(顯式地選擇的郵件),和“訂閱”(既不選擇在也不出去)。
email_open_tracking_disabled (布爾)真或假。設置為true來禁用打開跟蹤像素被添加到所有未來的電子郵件發送到該用戶。
email_click_tracking_disabled (布爾)真或假。設置為true來禁用所有鏈接的點擊跟蹤在一個未來的電子郵件,發送給該用戶。
external_id (字符串)用戶配置文件的唯一標識符。一旦分配一個external_id,用戶配置文件是確定在用戶的設備。的第一個實例分配一個external_id未知的用戶配置文件,所有現有的用戶配置文件數據將被遷移到新的用戶配置文件。
臉譜網 散列包含任何id(字符串)喜歡(字符串數組),num_friends(整數)。
first_name (字符串)
性別 (字符串)“M”、“F”、“O”(其他),“N”(不適用),“P”(不喜歡說)或零(未知)。
home_city (字符串)
語言 (字符串)我們要求語言傳遞給釺接受語言列表
last_name (字符串)
marked_email_as_spam_at (字符串)日期,用戶的電子郵件被標記為垃圾郵件。出現在ISO 8601格式或有下列格式:
- - - - - -yyyy-MM-ddTHH: mm: ss: SSSZ
- - - - - -yyyy-MM-ddTHH: mm: ss
- - - - - -yyyy-MM-dd HH: mm: ss
- - - - - -yyyy-MM-dd
- - - - - -MM / dd / yyyy
- - - - - -ddd MM dd HH: MM: ss。TZD YYYY
電話 (字符串)
push_subscribe (字符串)可用值“opted_in”(明確注冊接收推送消息),“unsubscribed(顯式地選擇推消息),和“訂閱”(既不選擇在也不出去)。
push_tokens 對象的數組app_id令牌字符串。您可以選擇提供一個device_id設備這個令牌與,例如,[{“app_id”:應用標識符,“令牌”:“abcd”、“device_id”:“optional_field_value”}]。如果一個device_id不提供,是隨機生成的。
subscription_groups 對象的數組subscription_group_idsubscription_state字符串,如。[{“subscription_group_id”:“subscription_group_identifier”、“subscription_state”:“訂閱”}]。可用值subscription_state是“訂閱”和“沒訂閱”。
time_zone (字符串)時區名稱IANA時區數據庫(例如,“美國/ New_York”或“東部時間(美國和加拿大)”)。隻有有效的時區值將被設置。
推特 散列包含任何id(整數),screen_name(字符串,Twitter),followers_count(整數),friends_count(整數),statuses_count(整數)。

語言值顯式地設置通過這個API將優先於語言環境信息釺自動從設備接收。

用戶屬性示例請求

這個例子包含兩個屬性的對象允許用戶75個請求/ API調用。


          
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30
帖子https://YOUR_REST_API_URL/users/track內容類型:application / json授權:持票人YOUR-REST-API-KEY{“屬性”:({“external_id”:“user1”,“first_name”:“喬”,“has_profile_picture”:真正的,“強加於人”:“1988-02-14”,“music_videos_favorited”:{“添加”:(“calvinharris-summer”),“刪除”:(“nickiminaj-anaconda”]}},{“external_id”:“user2”,“first_name”:“吉爾”,“has_profile_picture”:,“push_tokens”:[{“app_id”:“你的應用程序標識符”,“令牌”:“abcd”,“device_id”:“optional_field_value”})},{“user_alias”:{“alias_name”:“device123”,“alias_label”:“my_device_identifier”},“first_name”:“愛麗絲”,“has_profile_picture”:},{“external_id”:“user3”,“subscription_groups”:[{“subscription_group_id”:“subscription_group_identifier”,“subscription_state”:“訂閱”})}]}
這個頁麵是有用嗎?
新東西!
Baidu
map