号码包推送

最后更新时间:2021-08-17 17:04:49

    操作场景

    运营人员从第三方数据平台或者业务后台获取到一批用户的账号,要对这批用户做运营活动时,可使用 账号推送,一次性向单个或多个用户账号推送。

    注意:

    上述账号必须与 TPNS Token 绑定,操作步骤可参考 账号绑定(Android)或 账号绑定(iOS)接口

    操作步骤

    控制台使用

    1. 登录 TPNS 控制台
    2. 找到您需要配置的批量推送的应用,在其操作一栏下,选择【新建推送】,进入新建推送页面。
    3. 在【推送目标】配置项中,选择【账号】,您可以选择上传号码包文件或手动输入账号,如图:
    说明:

    上传号码包要求如下:

    • 账号包文件名:长度限制为 [1, 100]。
    • 账号包格式及大小: 支持 zip\txt\csv 文件;大小保持在 100Mb 以内。
    • zip 压缩包中可包含:单个 .txt.csv 文件;(不能嵌套文件夹)。
    • .txt 文件要求:(1)编码为 UTF-8;(2)每行一个账号,账号长度限制为 [2, 100]。
    • .csv 文件要求:(1)只能有一列;(2)每行一个账号,账号长度限制为 [2, 100]。
    1. 选择账号所对应的【账号类型】,账号类型可咨询业务开发人员获取,如果没有指定,则默认为【默认类型】。

    2. 单击【预览】,确认推送配置无误后,单击【确认推送】即可完成按账号推送。

    Rest API 使用

    单个/多个账号推送

    1.在您调用 推送接口 时,将 audience_type(推送目标)设置为 account(单账号推送)或account_list(账号列表推送)。
    2.设置账号对应的account_type(账号类型),账号类型取值可参考 账号类型取值表
    3.设置 account_push_type 字段来决定推送给「最近」或「所有」绑定该账号的设备。

    推送示例

    {
       "audience_type": "account",
         "account_list": [
          "12345"
        ]
       "account_type":"991",
       "account_push_type":0,
       "message_type": "notify",
       "message": {
           "title": "推送qq号用户",
           "content":"快快上线领取您的奖品吧!"        
       },
    }
    

    上传文件推送

    步骤1:调用号码包上传接口

    参考 号码包上传接口 文档,上传您的号码包文件,调用成功后会返回 upload_id,例如11231。

    步骤2:调用推送接口

    1. 在您调用 推送接口 时,将 audience_type(推送目标)设置为 package_account_push(号码包推送),并补充 步骤1 中获取的upload_id,例如11231。
    2. 设置账号对应的account_type(账号类型),账号类型取值可参考 账号类型取值表
    3. 设置 account_push_type 字段来决定推送给「最近」或「所有」绑定该账号的设备。

    推送示例

    如下示例为推送给在产品活动中获奖的用户:

    {
      "audience_type": "package_account_push",
      "upload_id": 11231,
      "account_push_type":0,
      "message_type": "notify",
      "message": {
          "title": "恭喜您在本次活动中获奖",
          "content":"快快上线领取您的奖品吧!"        
      }
    }
    

    账号类型取值表

    accountType 号码类型 注释 示例
    0 默认类型 不传入 accountType 时默认归为该类型。 -
    1~16 用户自定义 业务将自定义类型账号与 Token 绑定,如 uin 等。 -
    989 TAID 腾讯图灵盾团队建设的唯一设备指纹 ID。 -
    989 QIMEI 腾讯提供的唯一设备 ID。 -
    991 QQ号 5 - 12 位的纯数字串。 12345
    992 QQ号 - MD5 加密后的 QQ 号,加密前为 5 - 12 位的纯数字串,加密后为不计大小写的 32 位数字字母串。 -
    993 IDFA 苹果设备 ID,32 位的数字 + 大写字母串,用“—”杠分隔。 49E2084A-290C-41EF-AD20-E540CD6AE841
    994 IDFA - MD5 加密后的 IDFA,加密前需要格式转化成 32 位的数字 + 大写字母,加密后为不计大小写的 32 位数字字母串。 加密前:FF1999CD-7177-4937-A474-74937A102630
    加密后:2c010ed96aef2fc34983e1e7e9176b7e
    995 MAC 地址 硬件标识符,格式为 6 组 16 进制数,用“:”分隔,字母大写。 08:00:20:0A:8C:6D
    996 MAC 地址 - MD5 加密后的 MAC 地址,加密前需要去除分隔符“:”并转为大写。 加密前:a000002c9060f7
    加密后:f2d5a650733ca8c27d502b1c08da14e5
    997 OAID 移动安全联盟(MSA)制定的匿名设备标识符,保留原始值(不要转换大小写),不需要 MD5 编码,由数字字母和连接线构成,具体格式取决于各收集厂商和系统版本,长度有别。该 ID 详情请前往 MSA 官网查看。 -
    998 OAID - MD5 加密后的 OAID,为不计大小写的 32 位字符串。请使用 OAID 原值直接 MD5,不要转换大小写或去连接符。 -
    999 微信 Union ID 微信开放平台加密的微信号,用户在一个开放平台账户的所有公众号/小程序/移动应用下,拥有唯一的微信 Union ID。 -
    1000 IMEI 安卓设备 ID,14 位或 15 位的纯数字串,或者 14 位或 15 位数字 + 小写字母串。 -
    1001 IMEI - MD5 加密后的 IMEI,加密前需要格式转化成 14 位或 15 位数字 + 小写字母串,加密后为不计大小写的 32 位数字字母串。 加密前:a000002c9060f7
    加密后:f2d5a650733ca8c27d502b1c08da14e5
    1002 手机号 采用 e.164 标准,格式为+[国家或地区码][手机号] +8613711112222, 其中前面有一个+号 ,86为国家码,13711112222为手机号
    1003 微信 Open ID 微信用户在公众号/小程序 AppID 下的唯一用户标识,AppID 不同,则获取到的 OpenID 就不同,可用于永久标记一个用户 -
    1004 QQ OpenID - -
    1005 邮箱 - -
    1006 新浪微博 - -
    1007 支付宝 - -
    1008 淘宝 - -
    1009 豆瓣 - -
    1010 Facebook - -
    1011 Twitter - -
    1012 Google - -
    1013 百度 - -
    1014 京东 - -
    1015 linkedin - -