極光推送別名、標簽怎么理解


別名 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為成功,其他返回碼請參考錯誤碼定義。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM