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

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

调试

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

授权信息

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

请求语法

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

请求参数

名称	类型	必填	描述	示例值
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	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"
      }
    ]
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史