本文导读：5.标签管理5.1新增标签接口接口说明为应用方增加标签，用于后续标签推送。访问方式URL编码方式协议methodCont...
vivo广告推广平台：服务端API接口文档《NO.7》
5.标签管理
5.1 新增标签接口
接口说明
为应用方增加标签，用于后续标签推送。
访问方式
URL
编码方式
协议
method
Content-Type
/tag/add
Utf-8
https
POST
application/json
Curl e.g.：
curl -X POST -H 'authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://host:port/tag/add
Request body e.g.:
{
"name": "shenzhen",
"desc":"深圳用户标签",
"group":"city"
}
Response body e.g.:
http status 200:
{
"result": 0,
"desc": "成功",
}
业务异常：
{
"result": xxx,
"desc": "xxx"
}
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
name
string
Y
标签名称
desc
string
N
标签描述
group
string
N
标签分类名
输出参数：
属性名字
类型
描述
result
int
接口调用是否成功的状态码 0成功，非0失败
desc
string
文字描述接口调用情况
5.2 更新单个标签接口
接口说明
更新一个标签的信息,更新标签名字、描述、所属分类。
访问方式
URL
编码方式
协议
method
Content-Type
/tag/update
Utf-8
https
POST
application/json
Curl e.g.：
curl -X POST -H 'authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://host:port/tag/update
Request body e.g.:
{
"oldName":"shenzhen",
"newName":"shenzhenbaoan"
}
Response body e.g.:
http status 200:
{
"result": 0,
"desc": "成功"
}
业务异常：
{
"result": xxx,
"desc": "xxx"
}
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
oldName
string
Y
旧标签名称
newName
string
Y
新标签名称
desc
string
N
更新标签描述
group
string
N
更新标签所属分类
输出参数：
属性名字
类型
描述
result
int
接口调用是否成功的状态码 0成功，非0失败
desc
string
文字描述接口调用情况
5.3 给标签添加用户设备接口
接口说明
给标签添加用户设备信息，单次不超过1000个设备。
访问方式
URL
编码方式
协议
method
Content-Type
/tag/addMembers
Utf-8
https
POST
application/json
Curl e.g.：
curl -X POST -H 'authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://host:port/tag/addMembers
Request body e.g.:
{
"name":"shenzhen",
"type":1,
"ids":["15549635570031000000216","15549635980031000001086"]
}
Response body e.g.:
http status 200:
{
"result": 0,
"desc": "success",
"data": [
{
"status": 1,
"userid": "00000000000000000000004"
},
{
"status": 1,
"userid": "00000000000000000000005"
}
]
}
业务异常：
{
"result": xxx,
"desc": "xxx"
}
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
name
string
Y
标签名字
type
int
Y
用户类型：1是regId ,2是别名
ids
JSON Array
Y
用户id
输出参数：
属性名字
类型
描述
result
int
接口调用是否成功的状态码 0成功，非0失败
desc
string
文字描述接口调用情况
data
JSON Array
userid是非法用户id，status有3种状态：1是用户不存在，2是用户push开关关闭，3是用户14天未联网。
5.4 移除标签中的用户设备接口
接口说明
移除标签中的用户设备信息，单次不超过1000个设备。
访问方式
URL
编码方式
协议
method
Content-Type
/tag/removeMembers
Utf-8
https
POST
application/json
Curl e.g.：
curl -X POST -H 'authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://host:port/tag/removeMembers
Request body e.g.:
{
"name":"shenzhen",
"type":1,
"ids":["15554239157791000000009","15554239157791000000008"]
}
Response body e.g.:
http status 200:
{
"result": 0,
"desc": "success",
"data": [
{
"status": 1,
"userid": "15554239157791000000008"
},
{
"status": 1,
"userid": "15554239157791000000009"
}
]
}
业务异常：
{
"result": xxx,
"desc": "xxx"
}
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
name
string
Y
标签名字
type
int
Y
用户类型：1是regId ,2是别名
ids
JSON Array
Y
用户id
输出参数：
属性名字
类型
描述
result
int
接口调用是否成功的状态码 0成功，非0失败
desc
string
文字描述接口调用情况
data
JSON Array
userid是非法用户id，status有3种状态：1是用户不存在，2是用户push开关关闭，3是用户14天未联网。
vivo手机的使用人群偏年轻，在vivo广告平台投放产品广告也是比较有优势的，vivo的使用者在3亿左右，用户流量还是比较活跃的且在日益增长，广告主选择vivo平台还是比较有优势的，vivo广告渠道服务商网络主做vivo信息流广告，欢迎各位有意向的广告主前来咨询！
本文标题：vivo广告推广平台：服务端API接口文档《NO.7》
本文链接：https://www.jianzhaner.com/guanggao/1993.html
关键字：
相关问答：
-
答： 作为一种数字营销手段，广告推广在现代企业的营销中越来越受到重视。伴随着互联网普及和移动设备的普及，vivo广告推广也成为了众多企业进行数字营销的重要手段。但是，在广告推广过程中，如何正确使用定向广告？本文将从基础定向和行为兴趣定向这两个方面进行详细介绍。 一、基础定向 ...
-
答：vivo广告在账号管理过程中是否会遇到这样的问题？1.无法批量复制，只能当个复制，且需逐级复制。2.复制内容只能在当前层级下，无法跨层级。3.广告和创意均不支持复制，创建耗费大量时间。vivo广告复制2.0上线，帮助优化师提升账户管理效率计划层级A类型：仅复制广告计划；B类型：同...
-
答：vivo广告第三方监测链接说明1.1 内容说明vivo 广告平台支持向第三方上报广告监测，本文档说明了 vivo 支持的第三方监测的具体功能，以及广告主对接第三方监测的具体规范，请广告主进行开发对接时参考本说明；vivo 第三方监测规范参照并符合《MMA 中国无线营销联盟移动互...
