tencent cloud

操作场景

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

注意：

上述账号必须与 移动推送 Token 绑定，操作步骤可参考 账号绑定（Android）或 账号绑定（iOS）接口。

操作步骤

控制台使用

1. 登录 移动推送控制台。
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":"快快上线领取您的奖品吧！"
  }
}