轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
广告 / 报告 · POST · 请求参数 7 个(必填 2) · 响应参数 152 个 · 限流令牌桶容量 10
更新日期
2026-11-21

查询DSP报告列表 - 订单

POST/basicOpen/dspReport/order/list
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:查询DSP报告列表 - 订单(/basicOpen/dspReport/order/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。