Lingxing
切换旧版

SP投放小时数据

POST/pb/openapi/newad/spTargetHourData

接口信息

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

请求参数

report_datestring必填
报告日期，格式：Y-m-d 只能查询最近61天（最早为当天往前第61天，最晚为当天，含两端）
campaign_idnumber
广告活动id，必须为正整数；与campaign_ids至少传入一个，两者会合并去重
campaign_idsarray<any>
广告活动id列表，与campaign_id合并去重后最多50个，元素必须为正整数
agg_dimensionstring必填
聚合维度（区分大小写）:
target 投放维度
both_ad_target 广告+投放维度
both_target_placement 投放+广告位placement维度
all_ad_target_placement 广告+投放+广告位placement维度

返回结果

Json Object

codenumber必填
状态码，0 成功
示例 0
messagestring必填
提示消息
示例 操作成功
totalnumber必填
总数（等于data数组的条数）
示例 1167
next_tokenstring必填
游标分页token，本接口无分页，恒为null
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 f884f0a6-f1e9-49d1-b144-a85ee4b57ed9
response_timestring必填
响应时间
示例 2024-05-28 17:38:00
dataarray<object>必填
响应数据
隐藏子属性
profile_idnumber必填
店铺id
示例 2537307927915183
report_datestring必填
报告日期
示例 2024-05-25
hournumber必填
小时:
0 表示0-1点之间
1 表示 1-2点之间
以此类推
示例 23
campaign_idnumber必填
广告活动id
示例 532580134831120
ad_idnumber必填
广告id【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回】
示例 347244425807704
asinstring必填
广告对应asin【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回；匹配不到广告信息时为null】
示例 B085M7XMJF
mskustring必填
广告对应msku【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回；匹配不到广告信息时为null】
match_typestring必填
匹配方式【本接口所有合法聚合维度（target/both_ad_target/both_target_placement/all_ad_target_placement）均返回；数据仅存在于转化表时可能为null】
示例 EXACT
targeting_idnumber必填
投放id【本接口所有合法聚合维度（target/both_ad_target/both_target_placement/all_ad_target_placement）均返回】
示例 339153487021379
targetingstring必填
投放表达式【本接口所有合法聚合维度（target/both_ad_target/both_target_placement/all_ad_target_placement）均返回；数据仅存在于转化表时可能为null】
示例 spotting scope with rangefinder
placementstring必填
广告位【agg_dimension 为 both_target_placement 或 all_ad_target_placement 时返回】
impressionsnumber必填
曝光量（无流量数据时为0）
示例 34
clicksnumber必填
点击量（无流量数据时为0）
示例 7
costnumber必填
花费（无流量数据时为0）
示例 3.52
same_ordersnumber必填
直接成交订单（无转化数据时为0）
示例 2
ordersnumber必填
订单数（无转化数据时为0）
示例 1
same_salesnumber必填
直接销售额（无转化数据时为0）
示例 28.89
salesnumber必填
销售额（无转化数据时为0）
示例 54.03
same_unitsnumber必填
直接成交销量（无转化数据时为0）
示例 3
unitsnumber必填
销量（无转化数据时为0）
示例 11
ctrnumber必填
点击/曝光【保留4位小数；曝光量为0时为null】
示例 0.2059
cpcnumber必填
花费/点击【保留2位小数；点击量为0时为null】
示例 0.5
cvrnumber必填
订单数/点击【保留4位小数；点击量为0时为null】
示例 0.1429
cpanumber必填
花费/订单数【保留2位小数；订单数为0时为null】
示例 3.52
acosnumber必填
花费/销售额【保留4位小数；销售额为0时为null】
示例 0.0651
roasnumber必填
销售额/花费【保留2位小数；花费为0时为null】
示例 15.35
group_idnumber必填
广告组id
示例 287918863539910

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "data": [
        {
            "profile_id": 2537307927915183,
            "report_date": "2024-05-25",
            "hour": 23,
            "campaign_id": 532580134831120,
            "ad_id": 347244425807704,
            "asin": "B085M7XMJF",
            "match_type": "EXACT",
            "impressions": 34,
            "clicks": 7,
            "cost": 3.52,
            "same_orders": 2,
            "orders": 1,
            "same_sales": 28.89,
            "sales": 54.03,
            "same_units": 3,
            "units": 11,
            "ctr": 0.2059,
            "cpc": 0.50,
            "cvr": 0.1429,
            "cpa": 3.52,
            "acos": 0.0651,
            "roas": 15.35,
            "group_id": 287918863539910,
            "msku": null,
            "targeting_id": 339153487021379,
            "targeting": "spotting scope with rangefinder"
        }
    ],
    "total": 1167,
    "next_token": null,
    "error_details": [],
    "request_id": "f884f0a6-f1e9-49d1-b144-a85ee4b57ed9",
    "response_time": "2024-05-28 17:38:00"
}