行业基准指标
查询指定日期的行业基准指标分位值。接口支持按一级行业或二级行业查询,并返回点击率(CTR)、转化率(CVR)和目标转化成本(Target Conversion Price)等指标的 P25、P50、P75、P90 分位值及加权均值。
行业范围未传入时,默认使用当前认证账户所属行业;仅传入一级行业时按一级行业统计;同时传入一级、二级行业时按二级行业统计,并校验一级、二级行业的父子关系。接口按查询日期向前连续 7 天(包含查询日期)统计数据。
HTTP请求方式
POST
请求地址
Headers 请求参数
| 字段 | 类型 | 必须 | 描述 |
|---|---|---|---|
| Content-Type | string | yes | application/x-www-form-urlencoded |
| apiKey | string | yes | 注册时分配到的 api key,该参数作为 HTTP Header 字段传递。 |
| accessToken | string | yes | 身份认证通过后平台分配的临时 token,作为操作对应广告账户的凭证,10 小时有效。参数获取方式见接口 clientLogin。 |
Body 请求参数
| 字段 | 类型 | 必须 | 描述 |
|---|---|---|---|
| date | string | no | 查询日期,格式为 yyyy-MM-dd。未传时默认为昨天;只能查询昨天及近 60 天数据,即可查询范围为 [今天-60天, 昨天]。 |
| industry1_name | string | no | 一级行业名称。未传时默认使用认证账户所属行业;传入 industry2_name 时必须同时传入。 |
| industry2_name | string | no | 二级行业名称。仅传入 industry1_name 时按一级行业统计;同时传入一级、二级行业时会校验父子关系。 |
| conversion_target | string | no | 转化目标名称。多个目标使用英文逗号分隔,例如 咨询留线索,表单提交;单个目标长度不得超过 2048 个字符;最多传入五个目标;未传时返回底表中存在的转化目标。 |
| metrics | string | no | 指标列表,多个指标使用英文逗号分隔。支持 ctr、cvr、target_conversion_price;未传时返回全部指标。 |
userId不需要在请求中传入,接口使用accessToken对应的认证账户身份进行查询。conversion_target和metrics以英文逗号分隔的字符串提交,gopenapi 会将其转换为下游接口所需的数组格式。
请求示例
curl -X POST \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'date=2026-10-18&industry1_name=教育培训&industry2_name=语言培训&conversion_target=表单提交&metrics=ctr,cvr,target_conversion_price' \
'https://api.e.360.cn/dianjing/industry/getindustrybenchmark'
返回结果
{
"data": [
{
"industry1Name": "IT产品",
"industry2Name": "软件",
"industryLevel": 2,
"metrics": {
"ctr": {
"p25": 0.02,
"p50": 0.03,
"p75": 0.04,
"p90": 0.06,
"pooledMean": 0.03
}
}
},
{
"conversionTarget": "注册",
"industry1Name": "IT产品",
"industry2Name": "软件",
"industryLevel": 2,
"metrics": {
"cvr": {
"p25": 0.05,
"p50": 0.12,
"p75": 0.18,
"p90": 0.27,
"pooledMean": 0.18
},
"target_conversion_price": {
"p25": 38.21,
"p50": 79.91,
"p75": 150.15,
"p90": 420.05,
"pooledMean": 7216.13
}
}
},
{
"conversionTarget": "表单提交",
"industry1Name": "IT产品",
"industry2Name": "软件",
"industryLevel": 2,
"metrics": {
"cvr": {
"p25": 0.02,
"p50": 0.03,
"p75": 0.06,
"p90": 0.07,
"pooledMean": 0.04
},
"target_conversion_price": {
"p25": 32.19,
"p50": 63.53,
"p75": 224.17,
"p90": 556.59,
"pooledMean": 343.65
}
}
}
],
"date": "2026-10-18"
}
返回示例中的数值仅用于说明字段结构,实际数值以查询结果为准。
返回结果说明
| 字段 | 类型 | 描述 |
|---|---|---|
| date | string | 实际查询日期,格式为 yyyy-MM-dd。 |
| data | array | 行业基准指标结果列表。无满足条件的数据时返回空数组。 |
| data[].industryLevel | int | 行业层级:1 表示一级行业,2 表示二级行业。不同指标可能因样本量不同而分别落在一级或二级行业。 |
| data[].industry1Name | string | 一级行业名称。 |
| data[].industry2Name | string | 二级行业名称。一级行业结果不返回该字段。 |
| data[].conversionTarget | string | 转化目标名称。CTR 结果不依赖转化目标时通常不返回该字段。 |
| data[].metrics | object | 指标结果对象,键为实际命中的 ctr、cvr 或 target_conversion_price;样本不足的指标不会返回。 |
| data[].metrics[].p25 | double | P25 分位值。 |
| data[].metrics[].p50 | double | P50 分位值(中位数)。 |
| data[].metrics[].p75 | double | P75 分位值。 |
| data[].metrics[].p90 | double | P90 分位值。 |
| data[].metrics[].pooledMean | double | 按样本汇总计算的加权均值。 |
各指标分位值和加权均值统一保留小数点后两位。每项指标至少需要 20 个有效账户样本;样本不足或当天没有符合条件的数据时,
data返回空数组。某项指标在二级行业样本不足时会降级使用一级行业统计口径,因此不同指标的industryLevel可能不同。
参数校验规则
| 参数 | 规则 | 错误说明 |
|---|---|---|
| date | 必须为 yyyy-MM-dd;只能为昨天或昨天往前 59 天内的日期 | 日期格式错误或超出可查询范围 |
| industry1_name / industry2_name | 仅传入二级行业时必须同时传入一级行业;同时传入时必须存在有效的父子行业关系 | 行业参数错误 |
| metrics | 仅支持 ctr、cvr、target_conversion_price;传入后不能为空 |
指标参数错误 |
| conversion_target | 传入后不能为空;单个目标长度不得超过 2048 个字符 | 转化目标参数错误 |
响应头
resultCode为结果码,成功为10000,失败为对应错误码。失败返回结果示例
{
"failures": [
{
"code": 90201,
"description": "_param.date",
"message": "日期格式必须为yyyy-MM-dd"
}
]
}