华为ADS(鲸鸿动能)
  1. 数据报表
华为ADS(鲸鸿动能)
  • 自归因
  • FAQ
  • Marketing API
    • 接入流程(初始获取token)
      • 登录并获取access_token-1
      • 登录并获取access_token-2
    • 快速入门(刷新token)
      • 刷新access_token
    • 广告投放(旧)
      • 计划
      • 任务
      • 创意
      • 推广产品
      • 账户日预算
    • 广告投放(新)
      • 计划
        • 查询计划
        • 编辑计划
      • 任务
      • 创意
      • 推广产品
        • 查询应用详情
    • 工具箱(旧)
      • 版位
      • 维纳斯落地页
      • 渠道包
      • 素材管理
      • 转化跟踪目标
      • 定向模板
      • 定向包
      • DPA商品库
      • RTA策略管理
    • 工具箱(新)
      • 版位
      • 渠道包
      • 素材管理
      • 转化跟踪目标
      • 维纳斯
        • 查询维纳斯落地页列表
      • 定向包
      • DPA商品库
      • 归因回传
    • 数据报表
      • 广告主数据
        POST
      • 任务数据
        POST
    • 财务管理
      • 账户日预算
      • 账户余额
      • 资金账户日结算明细
      • 账户充值
      • 账户转账
      • 财务消耗
    • 账号管理
      • 经理账户
        • 查询经理账户下属广告主账户列表
    • 操作日志(旧)
    • 操作日志(新)
      • 查询操作日志列表
  • 其他
    • 鲸鸿动能转化跟踪API-数据回传
      POST
  1. 数据报表

任务数据

POST
https://ads.cloud.huawei.com/openapi/v2/reports/adgroup/query
【简介】广告主通过本接口获取广告主基本数据,包括花费、点击量、点击均价等。

请求参数

Header 参数
Authorization
string 
必需
默认值:
Bearer {{authorization}}
Body 参数application/json
advertiser_id
string 
广告主ID
必需
经理账户登录时,则此字段必填
time_granularity
string 
必需
可选(非必填):"STAT_TIME_GRANULARITY_DAILY"天粒度。
filtering
object 
过滤字段
可选
campaign_ids
array[string]
推广计划ID
可选
campaign_name
string 
计划名称
可选
adgroup_ids
array[string]
任务ID
可选
adgroup_name
string 
任务名称
可选
product_types
array[string]
推广产品
可选
app_ids
array[string]
AppID
可选
只在推广产品为应用时有效(AppID)
page
integer 
搜索页码
必需
默认值1,取值范围1~10000
page_size
integer 
一页展示数量
必需
默认值20 取值范围 1~10000
start_date
string 
起始时间
必需
end_date
string 
结束时间
必需
order_field
string 
排序字段
可选
所有的统计指标均可参与排序 默认按消耗金额 筛选指标,字符串形式样例: cost:花费 click_count:点击量 download_count:下载量 install_count:安装量 active_count_normalized:激活量 register_count:注册 retain_count:次留
order_type
string 
排序方式
可选
默认值: DESC;允许值: "ASC", "DESC"
示例
{
    "advertiser_id": "string",
    "time_granularity": "string",
    "filtering": {
        "campaign_ids": [
            "string"
        ],
        "campaign_name": "string",
        "adgroup_ids": [
            "string"
        ],
        "adgroup_name": "string",
        "product_types": [
            "string"
        ],
        "app_ids": [
            "string"
        ]
    },
    "page": 0,
    "page_size": 0,
    "start_date": "string",
    "end_date": "string",
    "order_field": "string",
    "order_type": "string"
}

返回响应

🟢200成功
application/json
Body
code
string 
返回码
可选
message
string 
返回描述
可选
data
object 
操作日志响应结果
可选
示例
{
    "code": "string",
    "message": "string",
    "data": {}
}
上一页
广告主数据
下一页
查询经理账户下属广告主账户列表
Built with