接口说明

请求URI

/audience/tag/v2/batchAdd

功能描述

企业将自有系统中的用户标签导入兔展平台，与兔展平台内的用户进行统一识别与匹配

注意事项

自建应用权限 用户→用户标签

旧地址 ~~/api/integrate/audience/tag/batchAdd~~ 即将废弃

身份类型在工作台中“用户”->“身份类型管理”中配置,需要在运营后台开通

调用方式

HTTPS 调用


POST https://integrate.rabbitpre.com/api/open/audience/tag/v2/batchAdd

请求数据类型

[ "application/json" ]

响应数据类型

[ "application/json" ]

请求头参数

属性	类型	必填	说明
X-Token	string	是	自建应用访问token

请求体参数

属性	类型	必填	说明
属性	类型	必填	说明
publicParams	Object	是	用户标签导入配置
└─matchingType	string	否	精确匹配的应用ID
└─optType	string	是	导入方式(add: 新增, delete: 删除)
data	Array	是	用户标签。导入数据，每次最大500条
└─identities	Array	否	用户身份
└─identityValue	string	是	用户身份值
└─identityType	string	是	用户身份类型，如openid（微信openid）、 unionid（微信openid）、phone（手机号）等
└─platform	string	否	平台类型，如公众号平台（gzh）、企业微信平台（workwechat）等
~~└─appid~~	~~string~~	否	~~应用id，如公众号appid、小程序appid、自建应用id等~~
└─mpid	string	否	应用id，如公众号appid、小程序appid、自建应用id等
└─isWeChatEcosystem	boolean	否	是否微信生态（传了~~appid~~ mpid必须传此参数）
└─operateTags	Array		运营标签
└─tagName	string	否	标签名称
└─tagValues	string[]	否	标签值
└─tagValueType	string	否	标签类型。默认"TEXT" 文本型； TEXT 文本型、NUMBER 数值型、BOOLEAN 布尔型、DATE 日期型

返回参数

属性	类型	说明
code	string	响应状态码。200-请求成功， 100100-appid、secret错误， 100200-token错误，100300-授权code错误
data	long	导入批次ID，用来查询导入结果，查询数据导入结果
errorCode	string	错误码
msg	string	消息提示

调用示例

示例说明: HTTPS调用

请求数据示例

{
    "publicParams":{
        "isMatching":true,
        "matchingType":2,
        "optType":"add"
    },
    "data":[{
        "identities": [{
            "identityValue": "18888888888",
            "identityType": "phone"
        }],
        "operateTags":[{
            "tagName":"性别",
            "tagValues":["男"]
        }]
    }]
}

返回数据示例

{
    "code": "500126",
    "errorCode": "IMPORT_DATA_ERROR",
    "msg": "导入失败",
    "data": 15314513451345123
}

错误码

错误码	错误码取值	解决方案
200	Success
401	Unauthorized
403	Forbidden
404	Not Found

页面树结构

用户标签导入v2