Lingxing
切换旧版

出单时段分析（产品）

POST/basicOpen/adReport/productOrderAnalysis/list

说明：msku的店铺订单等数据指标只是提供广告授权日期之后的统计结果，广告授权日期之前的暂未提供。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/productOrderAnalysis/listHTTPSPOST1

请求参数

sidstring必填
sid
profile_idinteger必填
VC广告店铺profile_id，对应查询广告账号列表接口对应字段【profile_id】，sid跟profile_id其中一个必填
skuarray<any>必填
msku最多10个
start_datestring必填
开始日期，格式：Y-m-d
end_datestring必填
结束日期，格式：Y-m-d
group_typestring必填
时间维度
hourly 按小时
weekly 按周
sponsored_typearray<any>
广告类型
sp
sd

返回结果

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 f8411a4fc19148348c7499b3f619c811.1727251040129
response_timestring必填
响应时间
示例 2024-09-25 15:57:20
dataobject必填
响应数据
隐藏子属性
listarray<object>必填
隐藏子属性
keystring必填
sub_total 汇总行 group_type= hourly 时对应小时 group_type =weekly 对应周
示例 sub_total
store_ordersstring必填
店铺订单
示例 4934
store_orders_percentstring必填
店铺订单百分比
示例 100
store_unitsstring必填
店铺销量
示例 4934
store_units_percentstring必填
店铺销量百分比
示例 100
store_salesstring必填
店铺销售额
示例 14500.57
store_sales_percentstring必填
店铺销售额百分比
示例 100
ad_ordersstring必填
广告订单
示例 4218
ad_orders_percentstring必填
广告订单百分比
示例 100%
ad_salesstring必填
广告销售额
示例 12175.52
ad_unitsstring必填
广告销量
示例 4218
ad_units_percentstring必填
广告销量百分比
示例 100%
spendstring必填
花费
示例 4404.64
impressionsstring必填
曝光
示例 51991
clicksstring必填
点击
示例 4684
ad_sales_percentstring必填
广告销售额百分比
示例 100
spend_percentstring必填
花费百分比
示例 100
acosstring必填
acos
示例 36.18%
ad_spend_store_percentstring必填
广告花费占比
示例 30.38
ad_order_store_percentstring必填
广告订单占比
示例 85.49
as_sales_store_percentstring必填
广告销售额占比
示例 83.97
ad_units_store_percentstring必填
广告销量占比
示例 85.49
impression_percentstring必填
曝光百分比
示例 100
clicks_percentstring必填
点击百分比
示例 100
roasstring必填
roas
示例 2.76
ctrstring必填
ctr
示例 9.01%
cpcstring必填
cpc
示例 0.94
cvrstring必填
cvr
示例 90.05%
cpastring必填
cpa
示例 1.04
key_chartstring必填
group_type= hourly 对应小时的描述
group_type =weekly 周的描述
key_tablestring必填
group_type= hourly 对应小时的描述
group_type =weekly 周的描述
totalinteger必填
示例 0

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/productOrderAnalysis/list?access_token=value&app_key=value&sign=value&timestamp=value' \
--header 'Content-Type: application/json' \
--data '{
    "sid": "1",
    "sku": ["DEE-1020","PEE-7"],
    "start_date": "2024-09-20",
    "end_date": "2024-09-26",
    "group_type": "hourly",
    "sponsored_type": ["sp"]
}'

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "c2d091a6ed6a4c78b558bda2816a4346.1727338836028",
    "response_time": "2024-09-26 16:20:36",
    "data": {
        "list": [
            {
                "key": "sub_total",
                "store_orders": "0",
                "store_orders_percent": "--",
                "store_units": "0",
                "store_units_percent": "--",
                "store_sales": "0",
                "store_sales_percent": "--",
                "ad_orders": "0",
                "ad_orders_percent": "--",
                "ad_sales": "0",
                "ad_units": "0",
                "ad_units_percent": "--",
                "spend": "0",
                "impressions": "0",
                "clicks": "0",
                "ad_sales_percent": "--",
                "spend_percent": "--",
                "acos": "--",
                "ad_spend_store_percent": "--",
                "ad_order_store_percent": "--",
                "as_sales_store_percent": "--",
                "ad_units_store_percent": "--",
                "impression_percent": "--",
                "clicks_percent": "--",
                "roas": "--",
                "ctr": "--",
                "cpc": "--",
                "cvr": "--",
                "cpa": "--",
                "key_chart": "汇总",
                "key_table": "汇总"
            }
        ]
    },
    "total": 0
}