Qeasy Cloud
Get Started

领星ERP 查询DSP报告列表 - 订单 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
广告 / 报告 · POST · 请求参数 7 个(必填 2) · 响应参数 152 个 · 限流令牌桶容量 10
Updated At
2026-11-21

查询DSP报告列表 - 订单

POST/basicOpen/dspReport/order/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/dspReport/order/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "offset": 0,
    "length": 20,
    "profile_id": "4796787438420",
    "start_date": "2022-10-05",
    "end_date": "2022-12-01"
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "fab4046bfb224000ad496c1c7d99cdec.1700209671099",
    "response_time": "2023-11-17 16:27:51",
    "next_token": "NzI1",
    "data": [
      {
        "id": 725,
        "date": "2022-10-05",
        "profile_id": "1196801708955240",
        "order_id": "584358905613169595",
        "order_name": "DEMO-order_name",
        "advertiser_id": "1234567890",
        "advertiser_name": "DEMO-adv",
        "order_start_date": "2022-09-13",
        "order_end_date": "2023-01-01",
        "order_budget": "2715.00",
        "total_cost": 26.88,
        "spends": "26.88",
        "sales": "330.59",
        "orders": "10",
        "impressions": "4053",
        "viewable_impressions": "2176",
        "clicks": "3",
        "dpv": "51",
        "total_add_to_cart": "22",
        "order_currency": "USD",
        "ad_units": "11"
      }
    ],
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1offset分页偏移量integer—Optional分页偏移量,默认0
2length分页长度integer—Optional分页长度,默认20
3next_tokenBase64 编码的上一页最后一条记录 IDstring—OptionalBase64 编码的上一页最后一条记录 ID。首次请求可省略。
4profile_idDSP账户 IDstring—OptionalDSP账户 ID,对应查询广告账号列表接口返回字段【profile_id】;与dsp_advertiser_id至少传一个,两者同时传入时以dsp_advertiser_id为查询条件。
5dsp_advertiser_idDSP广告主 IDinteger—OptionalDSP广告主 ID,对应查询DSP广告主列表接口返回字段【advertiserId】;与profile_id至少传一个
6start_date报告开始日期string—Required报告开始日期,双闭区间,格式:Y-m-d,时间间隔最长不超过90天
7end_date报告结束日期string—Required报告结束日期,双闭区间,格式:Y-m-d,时间间隔最长不超过90天

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstringC3D9F541-8083-E376-EB5C-606A872F5C89Required请求链路id
5response_time响应时间string2022-12-08 18:27:13Required响应时间
6total总数integer0Required总数
7next_token当前页最后一条记录 ID 的 Base64 编码stringNzI1Required当前页最后一条记录 ID 的 Base64 编码;无数据时为空字符串。
8data响应数据array<object>—Required响应数据
8.1date报告日期string2022-10-05Required报告日期,格式:yyyy-MM-dd
8.2profile_id亚马逊店铺数字idstring1196801708955240Required亚马逊店铺数字id
8.3order_id订单idstring584358905613169595Required订单id
8.4order_name订单名称stringDEMO-order_nameRequired订单名称
8.5advertiser_id广告主idstring1234567890Required广告主id
8.6advertiser_name广告主名称stringDEMO-advRequired广告主名称
8.7order_start_date开始时间string2022-09-13Required开始时间
8.8order_end_date结束时间string2023-01-01Required结束时间
8.9order_budget预算string2715.00Required预算
8.10spends花费string26.88Required花费
8.11sales销售额string330.59Required销售额
8.12orders订单数string10Required订单数
8.13impressions曝光string4053Required曝光
8.14viewable_impressions可见展示次数string2176Required可见展示次数
8.15clicks点击string3Required点击
8.16dpv商品详情页浏览次数string51Required商品详情页浏览次数
8.17total_add_to_cart加购次数string22Required加购次数
8.18order_currency币种stringUSDRequired币种
8.19ad_units销量string11Required销量
8.20id报表记录 IDinteger—Required报表记录 ID。
8.21add_to_watchlist_views14d浏览归因添加到观察列表integer—Optional浏览归因添加到观察列表。
8.22survey_finish_cpa14dsurvey_finish_cpa14dnumber—Optional旧版 DSP 指标(survey_finish_cpa14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.23application_views14dapplication_views14dinteger—Optional旧版 DSP 指标(application_views14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.24brand_store_engagement5_clicksbrand_store_engagement5_clicksinteger—Optional旧版 DSP 指标(brand_store_engagement5_clicks);说明表未提供业务定义,具体含义及统计口径待确认。
8.25click_on_redirect_clicks14dclick_on_redirect_clicks14dinteger—Optional旧版 DSP 指标(click_on_redirect_clicks14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.26dpv_views14d浏览归因DPVinteger—Optional浏览归因DPV。所推广商品由广告浏览产生的商品详情页浏览量。
8.27sign_up_button_views14dsign_up_button_views14dinteger—Optional旧版 DSP 指标(sign_up_button_views14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.28mashup_subscribe_and_save_click_views14dmashup_subscribe_and_save_click_views14dinteger—Optional旧版 DSP 指标(mashup_subscribe_and_save_click_views14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.29referral_cvr14dreferral_cvr14dnumber—Optional旧版 DSP 指标(referral_cvr14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.30total_purchases14d总订单量integer—Optional总订单量。由广告浏览或点击产生的购买活动中包含任意数量的品牌商品的次数。
8.31amazon_platform_fee亚马逊平台费用number—Optional亚马逊平台费用。
8.32dpvr14ddpvr14dinteger—OptionalDPVR。商品详情页浏览率。所推广商品的商品详情页浏览量与广告曝光量之比。DPVR=DPV/曝光量 *100%。
8.33mobile_app_first_starts_cpa14dmobile_app_first_starts_cpa14dnumber—Optional旧版 DSP 指标(mobile_app_first_starts_cpa14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.34brand_store_engagement2_clicksbrand_store_engagement2_clicksinteger—Optional旧版 DSP 指标(brand_store_engagement2_clicks);说明表未提供业务定义,具体含义及统计口径待确认。
8.35total_add_to_cart14d总ATCinteger—Optional总ATC。由广告浏览或点击产生的、顾客将品牌商品加入其购物车的次数。
8.36application_cvr14dapplication_cvr14dnumber—Optional旧版 DSP 指标(application_cvr14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.37dpv_clicks14d点击归因DPVinteger—Optional点击归因DPV。由广告点击产生的所推广商品商品详情页浏览量。
8.38entity_idDSP 实体 IDstring—OptionalDSP 实体 ID;说明表未提供该实体与账户、广告主之间的对应关系。
8.39widget_interaction_clicks14dwidget_interaction_clicks14dinteger—Optional旧版 DSP 指标(widget_interaction_clicks14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.40brand_store_engagement1_cpabrand_store_engagement1_cpanumber—Optional旧版 DSP 指标(brand_store_engagement1_cpa);说明表未提供业务定义,具体含义及统计口径待确认。
8.41total_roas14d总ROASnumber—Optional总ROAS。广告投资回报率,以每笔广告支出为品牌商品带来的归因于广告的销售额来衡量。总ROAS = 总销售额/广告花费。
8.42total_units_sold14d总销量integer—Optional总销量,由广告浏览或点击产生的品牌商品购买数量。
8.43email_interaction_clicks14demail_interaction_clicks14dinteger—Optional旧版 DSP 指标(email_interaction_clicks14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.44order_external_idDSP 广告活动外部 IDstring—OptionalDSP 广告活动外部 ID。
8.45dpv14ddpv14dinteger—OptionalDPV。所推广商品由广告浏览或点击产生的商品详情页浏览量。
8.46rentals_views14drentals_views14dinteger—Optional旧版 DSP 指标(rentals_views14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.47purchase_button14dpurchase_button14dinteger—Optional旧版 DSP 指标(purchase_button14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.48referral_cpa14dreferral_cpa14dnumber—Optional旧版 DSP 指标(referral_cpa14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.49marketing_landing_page14dmarketing_landing_page14dinteger—Optional旧版 DSP 指标(marketing_landing_page14d);说明表未提供业务定义,具体含义及统计口径待确认。
8.50total_cost广告总花费number—Optional广告总花费;返回值保留两位小数。
8.51total_sales14d总销售额number—Optional总销售额。归因于广告浏览或点击的品牌商品销售额。
8.52total_detail_page_clicks14d点击归因总商品详情页浏览量integer—Optional点击归因总商品详情页浏览量,由广告点击产生的品牌商品详情页浏览次数。
8.53total_detail_page_views14d总DPVinteger—Optional总DPV。所有品牌商品由广告浏览或点击产生的商品详情页浏览量。
8.54total_detail_page_view_views14d浏览归因总商品详情页浏览量integer—Optional浏览归因总商品详情页浏览量,由广告浏览产生的品牌商品详情页浏览次数。
8.55reach触达人数integer—Optional触达人数。自广告活动开始以来接触广告的独立用户数量。
8.56measurable_impressions可衡量展示量integer—Optional可衡量展示量。
8.57frequency_average频率平均值number—Optional频率平均值。
8.58gross_click_throughs总点击量integer—Optional总点击量。
8.59gross_impressions总展示量integer—Optional总展示量。
8.60invalid_click_throughs无效点击量integer—Optional无效点击量。
8.61invalid_impressions无效展示integer—Optional无效展示。
8.62product_review_page_visitsproduct_review_page_visitsinteger—OptionalPRPV。由广告浏览或点击产生的顾客访问所推广商品的商品评论页面的次数。
8.63product_review_page_visits_clicksPRPV 点击量integer—OptionalPRPV 点击量。由广告点击产生的顾客访问所推广商品的商品评论页面的次数。
8.64product_review_page_visits_viewsPRPV 浏览量integer—OptionalPRPV 浏览量。由广告浏览产生的顾客访问所推广商品的商品评论页面的次数。
8.65total_product_review_page_visits总PRPVinteger—Optional总PRPV。由广告浏览或点击产生的顾客访问品牌商品的商品评论页面的次数。
8.66total_product_review_page_visits_clicks总PRPV 点击量integer—Optional总PRPV 点击量。由广告点击产生的顾客访问品牌商品的商品评论页面的次数。
8.67total_product_review_page_visits_views总PRPV 浏览量integer—Optional总PRPV 浏览量。由广告浏览产生的顾客访问品牌商品的商品评论页面的次数。
8.68add_to_list添加到列表integer—Optional添加到列表。
8.69add_to_list_clicks点击归因添加到列表integer—Optional点击归因添加到列表。
8.70add_to_list_views浏览归因添加到列表integer—Optional浏览归因添加到列表。
8.71total_add_to_list总ATLinteger—Optional总ATL。由广告浏览或点击产生的,顾客将品牌商品添加到心愿单、礼品清单或注册计划的次数。
8.72total_add_to_list_clicks总ATL 点击量integer—Optional总ATL 点击量。由广告点击产生的,顾客将品牌商品添加到心愿单、礼品清单或注册计划的次数。
8.73total_add_to_list_views总ATL 浏览量integer—Optional总ATL 浏览量。由广告浏览产生的,顾客将品牌商品添加到心愿单、礼品清单或注册计划的次数。
8.74add_to_cartadd_to_cartinteger—OptionalATC。顾客在浏览或点击广告后将所推广商品加入购物车的次数。
8.75add_to_cart_clicksATC 点击量integer—OptionalATC 点击量。顾客在点击广告后将所推广商品加入购物车的次数。
8.76add_to_cart_viewsATC 浏览量integer—OptionalATC 浏览量。顾客在浏览广告后将所推广商品加入购物车的次数。
8.77total_add_to_cart_clicks总ATC 点击量integer—Optional总ATC 点击量。由广告点击产生的、顾客将品牌商品加入其购物车的次数。
8.78total_add_to_cart_views总ATC 浏览量integer—Optional总ATC 浏览量。由广告浏览产生的、顾客将品牌商品加入其购物车的次数。
8.79add_to_shopping_cart添加到商城购物车integer—Optional添加到商城购物车。
8.80add_to_shopping_cart_clicks点击归因添加到商城购物车integer—Optional点击归因添加到商城购物车。
8.81add_to_shopping_cart_views浏览归因添加到商城购物车integer—Optional浏览归因添加到商城购物车。
8.82add_to_watchlist添加到观察列表integer—Optional添加到观察列表。
8.83add_to_watchlist_clicks点击归因添加到观察列表integer—Optional点击归因添加到观察列表。
8.84total_purchases_views浏览归因总订单量integer—Optional浏览归因总订单量。
8.85total_purchases_clicks点击归因总订单量integer—Optional点击归因总订单量。
8.86purchases直接订单量integer—Optional直接订单量。由广告浏览或点击产生的购买活动中包含任意数量的推广的商品的次数。
8.87purchases_clicks点击归因直接订单量integer—Optional点击归因直接订单量。由广告点击产生的购买活动中包含任意数量的推广的商品的次数。
8.88purchases_views浏览归因直接订单量integer—Optional浏览归因直接订单量。由广告浏览产生的购买活动中包含任意数量的推广的商品的次数。
8.89units_sold直接销量integer—Optional直接销量。由广告浏览或点击产生的推广的商品购买量。
8.90roasroasnumber—OptionalROAS。所推广商品的广告投资回报率,ROAS=直接销售额/广告花费。
8.91combined_purchases站内外综合订单量integer—Optional站内外综合订单量。由广告浏览或点击产生的亚马逊站内及站外购买活动数量。
8.92combined_units_sold站内外综合销量integer—Optional站内外综合销量。由广告浏览或点击产生的从亚马逊站内及站外购买的商品数量。
8.93combined_product_sales站内外综合销售额number—Optional站内外综合销售额。归因于浏览或点击的亚马逊站内及站外购买量所对应的销售额。
8.94combined_purchases_views站内外综合浏览归因购买次数integer—Optional站内外综合浏览归因购买次数。由广告浏览产生的亚马逊站内及站外购买活动数量。
8.95combined_purchases_clicks站内外综合点击归因购买次数integer—Optional站内外综合点击归因购买次数。由广告点击产生的亚马逊站内及站外购买活动数量。
8.96long_term_sales长期销售额number—Optional长期销售额。
8.97brand_searches品牌搜索量integer—Optional品牌搜索量。根据与广告活动中的精选 ASIN 相关的品牌,在亚马逊上搜索品牌关键词的次数。
8.98brand_searches_clicks点击归因的品牌搜索量integer—Optional点击归因的品牌搜索量。
8.99brand_searches_views浏览归因的品牌搜索量integer—Optional浏览归因的品牌搜索量。
8.100brand_search_rate品牌搜索率number—Optional品牌搜索率。品牌搜索量与广告曝光量之比。品牌搜索率=品牌搜索量/曝光量*100%。
8.101new_to_brand_purchases品牌新客直接订单量integer—Optional品牌新客直接订单量。所推广商品由广告浏览或点击产生的品牌新客购买量。
8.102new_to_brand_purchases_views浏览归因品牌新客直接订单量integer—Optional浏览归因品牌新客直接订单量。
8.103new_to_brand_purchases_clicks点击归因品牌新客直接订单量integer—Optional点击归因品牌新客直接订单量。
8.104new_to_brand_units_sold品牌新客直接销量integer—Optional品牌新客直接销量。由广告浏览或点击产生的、曾经是品牌新客的顾客购买所推广商品的数量。
8.105new_to_brand_product_sales品牌新客直接销售额number—Optional品牌新客直接销售额。归因于广告浏览或点击产生的品牌新客购买所推广商品产生的销售额。
8.106new_to_brand_detail_page_views品牌新客DPVinteger—Optional品牌新客DPV。所推广商品由广告浏览或点击产生的品牌新客商品详情页浏览量。
8.107new_to_brand_detail_page_view_rate品牌新客DPVRnumber—Optional品牌新客DPVR。所推广商品的品牌新客商品详情页浏览量与广告曝光量之比。品牌新客DPVR=品牌新客DPV/曝光量 *100%。
8.108total_new_to_brand_purchases品牌新客总订单量integer—Optional品牌新客总订单量。由广告浏览或点击产生的品牌商品的品牌新客购买量。
8.109total_new_to_brand_purchases_clicks点击归因品牌新客总订单量integer—Optional点击归因品牌新客总订单量。
8.110total_new_to_brand_purchases_views浏览归因品牌新客总订单量integer—Optional浏览归因品牌新客总订单量。
8.111total_new_to_brand_units_sold品牌新客总销量integer—Optional品牌新客总销量,由广告浏览或点击产生的品牌新客购买品牌商品的数量。
8.112total_new_to_brand_sales品牌新客总销售额number—Optional品牌新客总销售额。品牌商品归因于广告浏览或点击的品牌新客购买量销售额。
8.113total_new_to_brand_purchases_percentage品牌新客总订单量占比number—Optional品牌新客总订单量占比。品牌商品的品牌新客购买转化量所占的百分比。品牌新客总订单量占比=品牌新客总订单量/总订单量 *100%。
8.114total_new_to_brand_dpvs品牌新客总DPVinteger—Optional品牌新客总DPV。归因于广告浏览或点击的所有品牌商品的品牌新客商品详情页浏览量。
8.115agency_fee代理费用number—Optional代理费用。
8.116total_fee总费用number—Optional总费用。
8.117video_ad_start视频开始播放次数integer—Optional视频开始播放次数。
8.118video_ad_first_quartile视频播放到1/4进度的次数integer—Optional视频播放到1/4进度的次数。
8.119video_ad_midpoint视频播放到一半进度的次数integer—Optional视频播放到一半进度的次数。
8.120video_ad_third_quartile视频播放到3/4进度的次数integer—Optional视频播放到3/4进度的次数。
8.121video_ad_complete视频完播次数integer—Optional视频完播次数。
8.122measurable_rate可衡量比率number—Required可衡量比率。可衡量比率=可衡量展示量/曝光量 *100%。measurable_impressions / impressions × 100,保留两位小数。
8.123viewable_rate可见率number—Required可见率。当前接口口径为可见展示量 / 曝光量:viewable_impressions / impressions × 100,保留两位小数。
8.124indirect_purchases间接订单量integer—Required间接订单量。系统计算,间接订单量=总订单量-直接订单量。total_purchases14d - purchases。
8.125indirect_units_sold间接销量integer—Required间接销量。系统计算,间接销量=总销量-直接销量。total_units_sold14d - units_sold。
8.126indirect_sales间接销售额number—Required间接销售额。系统计算,间接销售额=总销售额-直接销售额。total_sales14d - sales,保留两位小数。
8.127total_new_to_brand_purchase_rate品牌新客总购买率number—Required品牌新客总购买率。品牌商品的品牌新客购买转化量与广告曝光量之比。品牌新客总购买率 = 品牌新客总订单量/曝光量 * 100%。total_new_to_brand_purchases / impressions × 100,保留两位小数。
8.128new_to_brand_purchases_percentage品牌新客订单量占比number—Required品牌新客订单量占比,品牌新客直接订单量占直接订单量的百分比。new_to_brand_purchases / purchases × 100,保留两位小数。
8.129ctr点击率(CTR)number—Optional点击率(CTR),广告点击量与曝光量之比。返回数据库存储值,保留两位小数。
8.130ecpm千次曝光成本(eCPM)number—Optional千次曝光成本(eCPM),每千次广告展示的花费。返回数据库存储值,保留两位小数。
8.131eCPC每次点击成本(eCPC)number—Required每次点击成本(eCPC),每次广告点击所需支付的金额。实时计算:total_cost / clicks,保留两位小数并采用 HALF_UP;total_cost 或 clicks 缺失、clicks=0 时返回 0.00。
8.132eCPBrandSearch品牌搜索成本number—Optional品牌搜索成本。
8.133combinedROAS站内外综合ROASnumber—Optional站内外综合ROAS。在亚马逊站内及站外销售的商品的广告投资回报率,计算方式为归因于广告的销售额除以广告支出。站内外综合ROAS=站内外综合商品销售额/广告花费。
8.134longTermROAS长期广告投资回报率(长期 ROAS)number—Optional长期广告投资回报率(长期 ROAS)。
8.135newToBrandROAS品牌新客ROASnumber—Optional品牌新客ROAS。所推广商品的品牌新客购买对应的广告投资回报率,计算方式为所推广商品由广告产生的品牌新客销售额除以广告支出。品牌新客ROAS = 品牌新客直接销售额/广告花费。
8.136totalNewToBrandROAS品牌新客总ROASnumber—Optional品牌新客总ROAS。品牌新客购买量对应的广告投资回报率,计算方式为归因于广告的品牌商品的品牌新客销售额除以广告支出。品牌新客总ROAS = 品牌新客总销售额/广告花费。
8.137totalNewToBrandDPVRate品牌新客总DPVRnumber—Optional品牌新客总DPVR。品牌商品的品牌新客 (NTB) 商品详情页浏览率,相对于广告的曝光量。品牌新客总DPVR=品牌新客总DPV/曝光量 * 100%。
8.1383PFees第三方费用(3P 费用)number—Optional第三方费用(3P 费用)。
8.139totalDPVR总DPVRnumber—Required总DPVR。品牌商品的商品详情页浏览率,相对于广告的展示次数。总DPVR=总DPV /曝光量*100%。total_detail_page_views14d / impressions × 100,保留两位小数。
8.140PRPVRPRPVRnumber—RequiredPRPVR。所推广商品的商品评论页面访问量与广告展示量之比。PRPVR = PRPV/展示量*100%。product_review_page_visits / impressions × 100,保留两位小数。
8.141totalPRPVR品牌商品评论页面访问率(总 PRPVR)number—Required品牌商品评论页面访问率(总 PRPVR),品牌商品评论页面访问量与广告曝光量之比。total_product_review_page_visits / impressions × 100,保留两位小数。
8.142ATCRATCRnumber—RequiredATCR。“加入购物车”转化量与展示量之比。ATCR = ATC/曝光量 *100%。add_to_cart / impressions × 100,保留两位小数。
8.143totalATCR总ATCRnumber—Required总ATCR。品牌商品的“加入购物车”转化量与广告展示量之比。总 ATCR = 总 ATC/曝光量 *100%。total_add_to_cart14d / impressions × 100,保留两位小数。
8.144ACOSACOSnumber—RequiredACOS。系统计算,ACOS=广告花费/总销售额 * 100%。total_cost / total_sales14d × 100,保留两位小数。

The 查询DSP报告列表 - 订单 API (/basicOpen/dspReport/order/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.