账号推送

最近更新时间:2024-09-04 14:46:41

我的收藏

操作场景

运营人员从第三方数据平台或者业务后台获取到一批用户的账号,要对这批用户做运营活动时,可使用账号推送,一次性向单个或多个用户账号推送。
注意
上述账号必须与移动推送Token 绑定,操作步骤可参见 账号绑定(Android) 或 账号绑定(iOS)接口。

操作步骤

控制台使用

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


说明
上传号码包要求如下:
账号包文件名:长度限制为 [1, 100]。
账号包格式及大小: 支持 zip\\txt\\csv 文件;大小保持在 100Mb 以内。
zip 压缩包中可包含:单个 .txt.csv 文件;(不能嵌套文件夹)。
.txt 文件要求:
编码为 UTF-8
每行一个账号,账号长度限制为 [2, 100]
.csv 文件要求:
只能有一列
每行一个账号,账号长度限制为 [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":"快快上线领取您的奖品吧!"
}
}