行业基准指标


查询指定日期的行业基准指标分位值。接口支持按一级行业或二级行业查询,并返回点击率(CTR)、转化率(CVR)和目标转化成本(Target Conversion Price)等指标的 P25、P50、P75、P90 分位值及加权均值。

行业范围未传入时,默认使用当前认证账户所属行业;仅传入一级行业时按一级行业统计;同时传入一级、二级行业时按二级行业统计,并校验一级、二级行业的父子关系。接口按查询日期向前连续 7 天(包含查询日期)统计数据。

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/industry/getindustrybenchmark

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"
    }
  ]
}

results matching ""

    No results matching ""