vivo广告推广平台：服务端API接口文档《NO.9》

URL

编码方式

协议

method

Content-Type

/tagSegment/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/tagSegment/add

Request   body e.g.:

{

    "name":   "segment1",

          "expression":{

                   "notTags":["shenzhen"],

                  "andTags":[],

                  "orTags":[]

          }

}

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

标签组合名称

expression

JSON Object

Y

标签组合表达式：包含三种JSON数组：notTags表示非操作、andTags表示与操作，orTags表示或操作，例如："tagExpression":{

                 "notTags":["琴","棋","书","画"],

                  "andTags":["深圳","广东"],

                  "orTags":["本科生","研究生"]

          }

可以表示为，不会琴、棋、书、画的广东省深圳市的本科生或研究生的所有用户。

当然这些标签需要先在平台或者接口创建后再使用。

属性名字

类型

描述

result

int

接口调用是否成功的状态码 0成功，非0失败

desc

string

文字描述接口调用情况

URL

编码方式

协议

method

Content-Type

/tagSegment/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/tagSegment/update

Request   body e.g.:

{

           "oldName":"segment1",

           "newName":"segment2",

"expression":   {

                    "orTags": ["shenzhen"],

                    "andTags":     [],

                    "notTags": []

    }

}

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

新标签组合名称

expression

JSON Object

N

新标签组合表达式：包含三种JSON数组：notTags表示非操作、andTags表示与操作，orTags表示或操作，例如："tagExpression":{

                 "notTags":["琴","棋","书","画"],

                  "andTags":["深圳","广东"],

                  "orTags":["本科生","研究生"]

          }

可以表示为，不会琴、棋、书、画的广东省深圳市的本科生或研究生的所有用户。

当然这些标签需要先在平台或者接口创建后再使用。

属性名字

类型

描述

result

int

接口调用是否成功的状态码 0成功，非0失败

desc

string

文字描述接口调用情况