华为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/advertiser/query
广告主通过本接口获取广告主基本数据,包括花费、点击量、点击均价等。

请求参数

Header 参数
Authorization
string 
必需
默认值:
Bearer {{authorization}}
Body 参数application/json
advertiser_id
string 
广告主ID,经理账户登录时,则此字段必填
可选
time_granularity
string 
可选
start_date
string 
起始时间
必需
end_date
string 
结束时间
必需
page
integer 
搜索页码 默认值1,取值范围1~10000
可选
page_size
integer 
一页展示数量,默认值20 取值范围 1~10000
可选
topn
integer 
汇总数据指标
可选
flow_resource
integer 
资源类型
可选
campaign_type
integer 
计划类型
可选
index_screen_list
array [object {4}] 
指标筛选
可选
index_screen
string 
筛选指标
可选
字符串形式:effective_cost:花费 effective_impression_count:展示量 effective_click_count:点击量 effective_per_click:点击均价 effective_download_count:下载量 effective_click_ratio:点击率 effective_click_download_ratio:点击下载率
type
integer 
筛选指标类型
可选
大于等于,只需要赋值low_value、 小于等于,只需要赋值up_value 介于,需要赋值low_value up_value
low_value
number <float>
下限值
可选
up_value
number <float>
上限值
可选
dimension_type
object 
维度细分
可选
dimension_type
object 
维度细分
可选
dimension
string 
维度细分指标
可选
data
array[string]
筛选指标
可选
time_line
string 
可选(非必填):时间口径,默认请求时间口径
可选
group_by
array[string]
分组
可选
枚举值 包括 DATE、HOUR、ADGROUP_ID、COUNTRY、SEARCH_KEY_WORD、DEAL_ID、CAMPAIGN_ID、ADVERTISER_ID、CREATIVE_ID、POSITION_ID 按天月,必传对应维度+时间,按summary,必传对应维度
示例
{
    "advertiser_id": "string",
    "time_granularity": "string",
    "start_date": "string",
    "end_date": "string",
    "page": 0,
    "page_size": 0,
    "topn": 0,
    "flow_resource": 0,
    "campaign_type": 0,
    "index_screen_list": [
        {
            "index_screen": "string",
            "type": 0,
            "low_value": 0,
            "up_value": 0
        }
    ],
    "dimension_type": {
        "dimension_type": {},
        "dimension": "string",
        "data": [
            "string"
        ]
    },
    "time_line": "string",
    "group_by": [
        "string"
    ]
}

返回响应

🟢200成功
application/json
Body
code
string 
返回码
可选
message
string 
返回描述
可选
data
object 
操作日志响应结果
可选
示例
{
    "code": "string",
    "message": "string",
    "data": {}
}
上一页
查询维纳斯落地页列表
下一页
任务数据
Built with