Lingxing
切换旧版

SP广告小时数据

POST/pb/openapi/newad/spAdvertiseHourData

接口信息

API Path请求协议请求方式令牌桶容量
/pb/openapi/newad/spAdvertiseHourDataHTTPSPOST1

请求参数

report_datestring必填
报告日期,格式:Y-m-d 只能查询最近60天
campaign_idnumber必填
广告活动id
campaign_idsarray<any>必填
广告活动id列表,最多传50个
agg_dimensionstring必填
聚合维度:
ad 广告维度
both_ad_target 广告+投放维度

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
提示消息
示例 操作成功
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 DHJ9190-7404-9BDF-3F41-01F0401D1315
response_timestring必填
响应时间
示例 2023-02-17 09:59:19
totalinteger必填
总数
示例 1
dataarray<object>必填
响应数据
隐藏子属性
profile_idnumber必填
店铺id
示例 2537307927915183
report_datestring必填
报告日期
示例 2024-05-25
hournumber必填
小时:
0 表示0-1点之间
1 表示 1-2点之间
以此类推
示例 9
campaign_idnumber必填
广告活动id
示例 93889904442110
ad_idnumber必填
广告id
示例 559437347444970
mskustring必填
msku
asinobject必填
asin
示例 B07VC7ZN6P
impressionsobject必填
曝光量
示例 4
clicksnumber必填
点击量
示例 7
costobject必填
花费
示例 5.18
same_ordersnumber必填
直接成交订单
示例 1
ordersnumber必填
订单数
示例 6
same_salesnumber必填
直接销售额
示例 36.93
salesnumber必填
销售额
示例 71.82
same_unitsnumber必填
直接成交销量
示例 3
unitsnumber必填
销量
示例 5
match_typestring必填
匹配方式(当聚合维度为:both_ad_target 该字段有值)
示例 TARGETING_EXPRESSION_PREDEFINED
targeting_idnumber必填
投放id(当聚合维度为:both_ad_target 该字段有值)
示例 371645786382332
targetingstring必填
投放表达式(当聚合维度为:both_ad_target 该字段有值)
示例 complements
ctrnumber必填
点击/曝光
示例 1.75
cpcnumber必填
花费/点击
示例 0.74
cvrnumber必填
订单数/点击
示例 0.8571
cpanumber必填
花费/订单数
示例 0.86
acosnumber必填
花费/销售额
示例 0.0721
roasnumber必填
销售额/花费
示例 13.86
group_idnumber必填
广告组id
示例 332914711385626

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "data": [
        {
            "profile_id": 2537307927915183,
            "report_date": "2024-05-25",
            "hour": 9,
            "campaign_id": 93889904442110,
            "ad_id": 559437347444970,
            "asin": "B07VC7ZN6P",
            "impressions": 4,
            "clicks": 7,
            "cost": 5.18,
            "same_orders": 1,
            "orders": 6,
            "same_sales": 36.93,
            "sales": 71.82,
            "same_units": 3,
            "units": 5,
            "match_type": "TARGETING_EXPRESSION_PREDEFINED",
            "ctr": 1.7500,
            "cpc": 0.74,
            "cvr": 0.8571,
            "cpa": 0.86,
            "acos": 0.0721,
            "roas": 13.86,
            "group_id": 332914711385626,
            "msku": null,
            "targeting_id": 371645786382332,
            "targeting": "complements"
        }
    ],
    "total": 1,
    "error_details": [],
    "request_id": "42d2ba31-e50e-44e4-8870-5b4d945a52ae",
    "response_time": "2024-05-28 17:31:17"
}