Lingxing
切换旧版

分页查询广告活动报告列表

POST/basicOpen/multiplatform/ads/shopee/campaign/report/list

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/ads/shopee/campaign/report/listHTTPSPOST1

请求参数

pageobject必填
分页参数对象
隐藏子属性
pagenumber必填
当前页码，从 1 开始
lengthnumber必填
每页大小
orderFieldstring必填
排序字段，按返回字段名称排序
orderTypestring必填
排序类型：
asc 升序
desc 降序
periodobject必填
时间范围对象
隐藏子属性
startDatestring必填
开始日期，格式：yyyy-MM-dd
endDatestring必填
结束日期，格式：yyyy-MM-dd
filterobject
筛选条件对象
隐藏子属性
shopIdsarray<any>
店铺ID列表（复选，为空则代表全部）
campaignIdsarray<any>
广告活动ID列表（复选，为空则代表全部）
campaignNamestring
广告活动名称（模糊搜索）
statusCodesarray<any>
广告活动状态列表（复选，为空时为全部）：
ongoing 进行中
scheduled 已计划
ended 已结束
paused 已暂停
deleted 已删除
closed 已关闭
placementCategoriesarray<any>
广告位类别列表（复选，为空时为全部）：
search 搜索
discovery 展示
all 全部
itemIdsarray<any>
商品ID列表（复选，为空则代表全部）

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/shopee/campaign/report/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "page": {
        "page": 1,
        "length": 20,
        "orderField": "cost",
        "orderType": "desc"
    },
    "period": {
        "startDate": "2026-03-01",
        "endDate": "2026-03-17"
    },
    "filter": {
        "shopIds": [10001,10002],
        "campaignIds": [20001,20002],
        "campaignName": "春季大促",
        "statusCodes": ["ongoing","paused"],
        "placementCategories": ["search","discovery"],
        "itemIds": [30001,30002]
    }
}'

返回结果

JSON Object

codenumber必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035
response_timestring必填
响应时间
示例 2025-10-23 00:47:29
dataobject必填
响应数据
隐藏子属性
totalnumber必填
总记录数
示例 128
pagenumber必填
当前页码
示例 1
lengthnumber必填
每页大小
示例 20
listarray<object>必填
数据列表
隐藏子属性
dimensionstring
唯一标识
示例 campaign-20001
itemIdsarray<any>必填
商品ID列表
示例 ["30001","30002"]
currencyCodestring
币种代码
示例 USD
campaignIdnumber
广告活动ID
示例 20001
campaignNamestring
广告活动名称
示例 Shopee 春季大促
storeIdnumber
店铺ID
示例 10001
shopIdnumber
Shopee 店铺ID
示例 900001
lxNamestring
店铺展示名称
示例 Shopee-SG-001
statusCodestring
广告活动状态编码：
ongoing 进行中
scheduled 已计划
ended 已结束
paused 已暂停
deleted 已删除
closed 已关闭
示例 ongoing
statusDisplayNamestring
状态显示名称（国际化）
示例 进行中
startTimestring
广告活动开始时间
示例 2026-03-01 00:00:00
endTimestring
广告活动结束时间
示例 2026-03-31 23:59:59
targetTypestring
预算类型：
auto 自动
manual 手动
示例 manual
targetTypeDisplayNamestring
预算类型显示名称（国际化）
示例 手动
biddingTypestring
竞价类型：
auto 自动
manual 手动
示例 auto
biddingTypeDisplayNamestring
竞价类型显示名称（国际化）
示例 自动
placementCategorystring
广告位类别：
search 搜索
discovery 展示
all 全部
示例 search
placementCategoryDisplayNamestring
广告位类别显示名称（国际化）
示例 搜索
campaignBudgetnumber
广告活动预算
示例 1000.5
roasTargetnumber
目标ROAS
示例 2.5
dailyDiscoverStatusstring
每日发现广告位状态：
active 启用
inactive 停用
示例 active
dailyDiscoverBidnumber
每日发现广告位竞价
示例 0.3
youMayAlsoLikeStatusstring
猜你喜欢广告位状态：
active 启用
inactive 停用
示例 inactive
youMayAlsoLikeBidnumber
猜你喜欢广告位竞价
示例 0.25
impressionnumber
曝光量
示例 15000
clicksnumber
点击量
示例 850
costnumber
广告花费
示例 320.5
directOrdernumber
广告订单（直接订单）
示例 35
broadOrdernumber
间接订单
示例 12
directItemSoldnumber
广告销量（直接售出商品数）
示例 42
broadItemSoldnumber
间接销量（间接售出商品数）
示例 16
directGmvnumber
广告GMV（直接GMV）
示例 980.6
broadGmvnumber
间接GMV
示例 210.4
clickPercentnumber
点击百分比（点击量占查询结果总点击量的百分比）
示例 12.36
ctrnumber
CTR - 点击率（点击量/曝光量 * 100%）
示例 5.67
cpcnumber
CPC - 每次点击成本（广告花费/点击量）
示例 0.38
directCvrnumber
CVR - 转化率（广告订单/点击量 * 100%）
示例 4.12
broadCvrnumber
间接CVR - 间接转化率（间接订单/点击量 * 100%）
示例 1.41
directCpanumber
CPA - 每笔订单花费（广告花费/广告订单）
示例 9.16
broadCpanumber
间接CPA - 每笔间接订单花费（广告花费/间接订单）
示例 26.71
directRoasnumber
广告ROAS - 广告支出回报率（广告GMV/广告花费）
示例 3.06
broadRoasnumber
间接ROAS - 间接广告支出回报率（间接GMV/广告花费）
示例 0.66
directAcosnumber
广告ACoS - 广告销售成本（广告花费/广告GMV * 100%）
示例 32.68
broadAcosnumber
间接ACoS - 间接广告销售成本（广告花费/间接GMV * 100%）
示例 152.33

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
        "total": 128,
        "page": 1,
        "length": 20,
        "list": [
            {
                "dimension": "campaign-20001",
                "itemIds": ["30001","30002"],
                "currencyCode": "USD",
                "campaignId": 20001,
                "campaignName": "Shopee 春季大促",
                "storeId": 10001,
                "shopId": 900001,
                "lxName": "Shopee-SG-001",
                "statusCode": "ongoing",
                "statusDisplayName": "进行中",
                "startTime": "2026-03-01 00:00:00",
                "endTime": "2026-03-31 23:59:59",
                "targetType": "manual",
                "targetTypeDisplayName": "手动",
                "biddingType": "auto",
                "biddingTypeDisplayName": "自动",
                "placementCategory": "search",
                "placementCategoryDisplayName": "搜索",
                "campaignBudget": 1000.5,
                "roasTarget": 2.5,
                "dailyDiscoverStatus": "active",
                "dailyDiscoverBid": 0.3,
                "youMayAlsoLikeStatus": "inactive",
                "youMayAlsoLikeBid": 0.25,
                "impression": 15000,
                "clicks": 850,
                "cost": 320.5,
                "directOrder": 35,
                "broadOrder": 12,
                "directItemSold": 42,
                "broadItemSold": 16,
                "directGmv": 980.6,
                "broadGmv": 210.4,
                "clickPercent": 12.36,
                "ctr": 5.67,
                "cpc": 0.38,
                "directCvr": 4.12,
                "broadCvr": 1.41,
                "directCpa": 9.16,
                "broadCpa": 26.71,
                "directRoas": 3.06,
                "broadRoas": 0.66,
                "directAcos": 32.68,
                "broadAcos": 152.33
            }
        ]
    }
}