別名 alias
為安裝了應用程序的用戶,取個別名來標識。以后給該用戶 Push 消息時,就可以用此別名來指定。
每個用戶只能指定一個別名。
同一個應用程序內,對不同的用戶,建議取不同的別名。這樣,盡可能根據別名來唯一確定用戶。
系統不限定一個別名只能指定一個用戶。如果一個別名被指定到了多個用戶,當給指定這個別名發消息時,服務器端API會同時給這多個用戶發送消息。
舉例:在一個用戶要登錄的游戲中,可能設置別名為 userid。游戲運營時,發現該用戶 3 天沒有玩游戲了,則根據 userid 調用服務器端API發通知到客戶端提醒用戶。
標簽 tag
為安裝了應用程序的用戶,打上標簽。其目的主要是方便開發者根據標簽,來批量下發 Push 消息。
可為每個用戶打多個標簽。
舉例: game, old_page, women
Method - setAliasAndTags (with Callback)
調用此 API 來同時設置別名與標簽。
需要理解的是,這個接口是覆蓋邏輯,而不是增量邏輯。即新的調用會覆蓋之前的設置。
在之前調用過后,如果需要再次改變別名與標簽,只需要重新調用此 API 即可。
支持的版本
開始支持的版本:1.5.0.
接口定義
public static void setAliasAndTags(Context context,
String alias,
Set<String> tags,
TagAliasCallback callback)
參數定義
-
alias
- null 此次調用不設置此值。(注:不是指的字符串"null")
- "" (空字符串)表示取消之前的設置。
- 每次調用設置有效的別名,覆蓋之前的設置。
- 有效的別名組成:字母(區分大小寫)、數字、下划線、漢字、特殊字符(v2.1.6支持)@!#$&*+=.|¥。
- 限制:alias 命名長度限制為 40 字節。(判斷長度需采用UTF-8編碼)
-
tags
- null 此次調用不設置此值。(注:不是指的字符串"null")
- 空數組或列表表示取消之前的設置。
- 每次調用至少設置一個 tag,覆蓋之前的設置,不是新增。
- 有效的標簽組成:字母(區分大小寫)、數字、下划線、漢字、特殊字符(v2.1.6支持)@!#$&*+=.|¥。
- 限制:每個 tag 命名長度限制為 40 字節,最多支持設置 1000 個 tag,但總長度不得超過7K字節。(判斷長度需采用UTF-8編碼)
-
callback
- 在 TagAliasCallback 的 gotResult 方法,返回對應的參數 alias, tags。並返回對應的狀態碼:0為成功,其他返回碼請參考錯誤碼定義。