查询广告子任务统计报表

POST

https://connect-api.cloud.huawei.com/api/marketing-api/v1/report/ad/subtask

获取广告子任务的报表数据

请求参数

Header 参数

Authorization

string

必需

认证信息，格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。

默认值:

Bearer {{access_token}}

client_id

string

必需

客户端ID，获取方法参考创建API客户端。

默认值:

Body 参数application/json

startDate

string

查询开始时间。

必需

格式：YYYY-MM-DD

endDate

string

查询结束时间。

必需

格式：YYYY-MM-DD 不能超过开始时间31天。

page

integer

分页查询时指定返回数据的页码。

可选

取值范围大于等于1。默认值：1，表示第1页。

>= 1

默认值:

pageSize

integer

分页查询时指定返回数据每页的条数。

可选

取值范围：[1,1000] 默认值：20

>= 1<= 1000

默认值:

pricingType

string

计费类型。

可选

取值范围： CPD：按下载次数计费 OCPD：系统智能调价，按下载次数计费 CPC：按点击计费 CPT：按时长计费

orderField

string

返回数据的排序方式

可选

取值范围： DATE：按统计日期排序 COST：按消耗金额排序 EXPOSURE：按展示量排序 CLICK：按点击量排序 DOWNLOAD：按下载量排序默认值：DATE

默认值:

DATE

orderType

string

返回数据升序还是降序排序

可选

取值范围： DESC：降序排序 ASC：升序排序默认值：ASC

默认值:

ASC

groupby

string

返回数据的分组方式

可选

取值范围： statDate：按统计日期分组 taskId：按任务ID分组 region：按任务投放区域分组 channel：按渠道号分组。此处渠道号仅指智能分包渠道号。默认值：statDate 可同时支持多种分组方式。

默认值:

statDate

customerId

string

直客团队协作者的内部ID

可选

直客团队协作者查询时必须携带，该字段请使用协作者账户登录华为应用市场付费推广平台后在“我的账号信息”中查看到的“华为账号”。说明：协作者查询时，会使用此字段与直客管理者账户ID校验从属关系，再根据此字段查询报表。代理模式不支持携带此字段。

filtering

object (AdTaskReportFiltering)

本次查询的过滤条件

可选

appIds

array[string]

需要查询推广数据的应用ID

可选

需要查询推广数据的应用ID，一次最多支持查询10个应用。您的应用ID需要使用直客账号参考查看应用基本信息获取。合作伙伴投放时需联系直客代为获取。

taskIds

array[string]

需要查询推广数据的推广任务ID

可选

需要查询推广数据的推广任务ID，一次最多支持查询10个推广任务，待查询的推广任务必须是appIds中指定应用的推广任务。推广任务ID可登录华为应用市场付费推广平台后在“管理推广任务”列表中查看。

channels

array[string]

渠道号，由开发者自定义，非渠道ID

可选

渠道号，由开发者自定义，非渠道ID，可登录华为应用市场付费推广平台后在“管理推广任务”列表中查看。一次最多支持查询10个渠道的数据。

regions

array[string]

任务投放区域，取值为ISO国家码

可选

任务投放区域，取值为ISO国家码，一次最多支持查询10个区域，具体国家码列表参考国家码。默认为CN。

示例

{
  "startDate": "string",
  "endDate": "string",
  "page": 1,
  "pageSize": 20,
  "pricingType": "string",
  "orderField": "DATE",
  "orderType": "ASC",
  "groupby": "statDate",
  "customerId": "string",
  "filtering": {
    "appIds": [
      "string"
    ],
    "taskIds": [
      "string"
    ],
    "channels": [
      "string"
    ],
    "regions": [
      "string"
    ]
  }
}

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2024-04-24 04:17:12

查询广告任务统计报表

回传用户行为数据