账号推送

最后更新时间:2021-11-12 10:33:23

    操作场景

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

    注意:

    上述账号必须与 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]。
    4. 选择账号所对应的账号类型,账号类型可咨询业务开发人员获取,如果没有指定,则默认为默认类型
    5. 单击预览,确认推送配置无误后,单击确认推送即可完成按账号推送。

    Rest API 使用

    单个/多个账号推送

    在您调用 推送接口 时,将 audience_type(推送目标)设置为 account(单账号推送)或account_list(账号列表推送),并参考 账号类型取值表,填写账号类型所对应的值。

    推送示例

    {
      "audience_type": "account",
    "account_list": [
         "123456"
    ],
    "account_type":1,
      "account_push_type":0,
      "message_type": "notify",
      "message": {
          "title": "恭喜您在本次活动中获奖",
          "content":"快快上线领取您的奖品吧!"
      }
    }
    

    上传号码包文件推送

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

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

    步骤2:调用推送接口

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

    推送示例

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

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