ListFlowControlTaskItemReports - 流量调控曝光排名物品/失效物品查询

更新时间:
复制为 MD 格式

流量调控曝光排名物品/失效物品查询。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /v2/openapi/instances/{instanceId}/flowControlTasks/{taskId}/itemReports HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

instanceId

string

实例 ID。

airec-cn-****

taskId

string

流量调控任务 ID。

1666854493104

selectTimeType

string

查询时间段,如果 selectType=invalidItem,则只支持 yesterDay。

取值:

  • yesterDay:昨天。

  • lastSevenDays:最近 7 天。

  • lastFifteenDays:最近 15 天。

yesterDay

selectType

string

查询数据类型。

取值:

  • topExposeItem:曝光排名物品。

  • invalidItem:失效物品。

invalidItem

count

string

当 selectType="topItem",count 代表查询 TOP 前 xx 个物品,默认 10 当 selectType="invalidItem",count 代表查询失效物品个数,默认 10 个。

5

返回参数

名称

类型

描述

示例值

object

返回参数。

requestId

string

请求 ID。

D486768B-8BF8-4D80-B491-43DC3D0AF8AB

result

object

返回参数。

detail

array<object>

数据列表。

object

数据。

taskId

string

流量调控任务 ID。

1666669577221

itemId

string

物品 ID。

123

itemType

string

物品 Type。

video

taskRank

string

当天曝光量排名。

12

itemPv

string

物品当天曝光量。

100

taskPv

string

任务当天曝光量。

50

pvPercent

string

物品当天曝光占比。

10.12

itemClick

string

物品当天点击量。

100

taskClick

string

任务当天点击量。

100

clickPercent

string

物品当天点击占比。

1.23

itemCtr

string

物品当天点击率。

2.34

taskCtr

string

任务当天点击率。

1.23

accTaskRank

string

累计曝光量排名。

10

accItemPv

string

物品累计曝光量。

500

accTaskPv

string

任务累计曝光量。

200

accPvPercent

string

物品累计曝光占比。

20.12

accItemClick

string

物品累计点击量。

1000

accTaskClick

string

任务累计点击量。

600

accClickPercent

string

物品累计点击占比。

3.24

accItemCtr

string

物品累计点击率。

4.56

accTaskCtr

string

任务累计点击率。

3.22

示例

正常返回示例

JSON格式

{
  "requestId": "D486768B-8BF8-4D80-B491-43DC3D0AF8AB",
  "result": {
    "detail": [
      {
        "taskId": "1666669577221",
        "itemId": "123",
        "itemType": "video",
        "taskRank": "12",
        "itemPv": "100",
        "taskPv": "50",
        "pvPercent": "10.12",
        "itemClick": "100",
        "taskClick": "100",
        "clickPercent": "1.23",
        "itemCtr": "2.34",
        "taskCtr": "1.23",
        "accTaskRank": "10",
        "accItemPv": "500",
        "accTaskPv": "200",
        "accPvPercent": "20.12",
        "accItemClick": "1000",
        "accTaskClick": "600",
        "accClickPercent": "3.24",
        "accItemCtr": "4.56",
        "accTaskCtr": "3.22"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情