← 万相台接口目录

接口参考 · 查询操作

创意报表查询

taobao.universalbp.new.report.query.creative

核对日期:2026-09-19。字段名称、类型与业务层级按淘宝文档整理;请求地址、鉴权和店铺选择按下方本站说明接入。

文档按上述日期核对;最新变更及详细场景规则请查看淘宝官方说明。

通过奇门云调用

  • 签名地址:POST https://api.miandanni.com/api/wanxiang/sign;Content-Type: application/json。
  • 客户购买的奇门云密钥用于申请签名;实际调用淘宝开放平台万相台官方 API。方法、字段、类型、层级、金额单位和场景以官方文档为准。奇门云校验客户服务、店铺归属与授权后签名,客户服务器直接请求淘宝并接收业务数据。
  • 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在业务脚本同目录,使用 Client.call。奇门云密钥不是淘宝 AppSecret;不要求客户自行计算平台签名。
  • 签名申请头 Authorization: Bearer 你的奇门云密钥。JSON 为 {shopKey, method, params};shopKey 必须属于当前客户。客户 Bearer 密钥不能转发到淘宝。
  • 业务参数放入 params,保留淘宝字段名、类型、层级及枚举。对象直接使用 JSON 对象;下表业务根字段不放在请求最外层。
  • app_key、session、sign、timestamp、v、format 等公共字段由服务器生成。签发的本店铺 session 和签名只能用于客户服务器,不进入前端、日志或公共仓库;AppSecret 和 refresh_token 不提供给客户。
  • 本站支持店铺直接登录:top_service_context.login_type 为 1,ext 为 {} 或字符串 "{}";不允许 member_id、其他账户身份或代理登录。官方表内此类字段用于说明差异,不能照抄传入。
  • 业务根对象未填写的必填子项需按官方文档补全。ID 保持精度,金额单位、日期范围和枚举以具体方法官方说明为准。
  • 签发成功为 {ok:true,data:{version:1,ticketId,service,method,issuedAt,request}},不表示业务已执行;客户端按合同执行 data.request。TOP fields 原样作为字符串表单发送,不改值。
  • 淘宝业务响应直接返回客户程序,保留 error_response、top_result、逐项错误和 request_id;HTTP 200 仍检查 top_result.info.ok。签名阶段失败读取奇门云 error.code、message 和 details。
  • 每次签名校验密钥、服务有效期、店铺归属、淘宝应用订购及授权。业务能力仍取决于淘宝资格与推广场景。签发限流不等于平台实际调用次数。
  • 一次签名只生成一份请求,不自动翻页或重试。创建、调价、启停、删除会实际生效;超时或结果未知先查询实际状态。ticketId 不是平台幂等键。
  • 签名不是一次性凭据,平台接受的时间窗口内可能重放;解绑、停用或到期阻止新签发,不能即时撤回已签发请求。老客户原程序继续可用。
  • 每周一北京时间凌晨2:00检查官方更新,经核对验证后同步,不承诺实时同步。官方方法尚未同步时提供完整方法名和官方链接反馈,不误判为平台权限不足。
{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.creative",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_creative_report_query_v_o": {}
  }
}

这是请求结构模板。空对象和占位内容需按下方字段表填写;修改接口未填入任何真实广告编号或预算。

请求业务参数

以下路径都位于请求体的 params 内。[] 表示数组元素;嵌套字段的必填标记只描述其父对象使用时的要求。

官方 top_service_context.member_id、代理登录和扩展身份不适用于本站。本站固定使用自己的已授权店铺,login_type=1、ext={}。

23 / 23 个字段
字段路径类型 / 必填字段含义示例值
top_service_contextTopServiceContext必填含下级字段推广业务上下文—
top_service_context.biz_codeString必填推广场景标识xxxxx
top_service_context.login_typeNumber可选账户登录方式枚举:1、2=代理直投(叉乘账号)1
top_service_context.member_idNumber可选广告账户标识代理直投(叉乘)时必填12345
top_service_context.extString可选扩展参数{}
top_creative_report_query_v_oTopCreativeReportQueryVO必填含下级字段创意报表查询—
top_creative_report_query_v_o.by_pageBoolean必填是否分页true
top_creative_report_query_v_o.split_typeString必填统计拆分方式hour
top_creative_report_query_v_o.unify_typeString必填转化归因口径zhai
top_creative_report_query_v_o.start_timeString必填查询或投放起始时间2023-06-06
top_creative_report_query_v_o.end_timeString必填查询或投放结束时间2023-06-12
top_creative_report_query_v_o.effect_equalNumber必填转化统计窗口15
top_creative_report_query_v_o.query_domainsString []可选统计维度集合[creative]
top_creative_report_query_v_o.query_field_in_listString []必填返回指标集合查询指标必填adPv
top_creative_report_query_v_o.biz_code_in_listString []可选统计场景集合["onebpDisplay"]
top_creative_report_query_v_o.province_id_in_listNumber []可选标识集合[1]
top_creative_report_query_v_o.strategy_creative_id_or_nameString可选业务字段 strategy_creative_id_or_name商品
top_creative_report_query_v_o.strategy_optimize_target_in_listNumber []可选优化目标集合[3003]
top_creative_report_query_v_o.strategy_campaign_id_in_listNumber []可选计划标识集合[68798644117]
top_creative_report_query_v_o.offsetNumber可选结果起始偏移10
top_creative_report_query_v_o.page_sizeNumber可选单页条数10
top_creative_report_query_v_o.sourceString可选请求来源标识baseReport
top_creative_report_query_v_o.original_biz_code_in_listString []可选编码集合[adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd]

返回业务字段

响应外层为 universalbp_new_report_query_creative_response。下面的逻辑字段路径从该外层内部开始;样例 JSON 路径额外标注 TOP 集合包装,解析时仍需以实际返回为准。

111 / 111 个字段
字段路径类型 / 必填字段含义示例值
top_result样例 JSON:universalbp_new_report_query_creative_response.top_resultTopResult官方未标注必填含下级字段接口业务结果—
top_result.info样例 JSON:universalbp_new_report_query_creative_response.top_result.infoTopInfo官方未标注必填含下级字段执行状态信息—
top_result.info.ok样例 JSON:universalbp_new_report_query_creative_response.top_result.info.okBoolean官方未标注必填业务是否成功true
top_result.info.message样例 JSON:universalbp_new_report_query_creative_response.top_result.info.messageString官方未标注必填业务结果提示参数错误
top_result.info.error_code样例 JSON:universalbp_new_report_query_creative_response.top_result.info.error_codeString官方未标注必填业务错误标识xxxxx
top_result.top_report_v_o_top_bulk_data样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_dataTopBulkData官方未标注必填含下级字段报表对象—
top_result.top_report_v_o_top_bulk_data.count样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.countNumber官方未标注必填结果计数10
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_listTopReportVO []官方未标注必填含下级字段报表列表—
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_codeString官方未标注必填推广场景标识onebpDisplay
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_idString官方未标注必填数据所属小时15
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_nameString官方未标注必填业务字段 scene1_name人群推广
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedateString官方未标注必填数据所属日期2023-06-12 16:00
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_idString官方未标注必填推广计划编号11111111
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_nameString官方未标注必填推广计划名称促进成交_最大化拿量
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_idString官方未标注必填推广单元编号11111111
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_nameString官方未标注必填推广单元名称测试商品
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_idString官方未标注必填关键词标识1111111
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_wordString官方未标注必填业务字段 original_word瘦肩
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_idString官方未标注必填关键词标识1111111
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_typeString官方未标注必填出价词类型词 word, 词包 wordPkg
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_idString官方未标注必填推广主体编号670425387744
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_nameString官方未标注必填业务字段 promotion_name测试商品
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_urlString官方未标注必填业务字段 img_urlhttp://****.com
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_urlString官方未标注必填业务字段 link_urlhttp://****.com
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_idString官方未标注必填人群标识676456456456
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_nameString官方未标注必填人群名称店铺长期价值人群
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_idString官方未标注必填广告创意编号710660000650001
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_nameString官方未标注必填广告创意名称方图1:1资源位_20230511_111045
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_pathString官方未标注必填业务字段 creative_image_pathhttp://****.com
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_pathString官方未标注必填业务字段 creative_vedio_pathhttp://****.com
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_sizeString官方未标注必填业务字段 creative_size800*800
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_idString官方未标注必填创意标识702675398571
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_typeString官方未标注必填业务字段 black_creative_promotion_type11
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_idString官方未标注必填业务对象标识599
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_nameString官方未标注必填业务字段 province_name中国香港
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_idString官方未标注必填城市标识599
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_nameString官方未标注必填城市名称中国香港
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_indexTopReportIndexVO官方未标注必填含下级字段统计指标内容—
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_chargeString官方未标注必填业务字段 total_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_chargeString官方未标注必填业务字段 crowd_scene_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_chargeString官方未标注必填业务字段 item_scene_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_chargeString官方未标注必填业务字段 activity_scene_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_chargeString官方未标注必填业务字段 display_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_chargeString官方未标注必填业务字段 search_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_chargeString官方未标注必填业务字段 content_scene_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_chargeString官方未标注必填业务字段 shop_scene_chargexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pvString官方未标注必填广告展现次数xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.clickString官方未标注必填点击次数xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.chargeString官方未标注必填推广花费xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctrString官方未标注必填点击比例xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpcString官方未标注必填业务字段 ecpcxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpmString官方未标注必填业务字段 ecpmxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amtString官方未标注必填业务字段 prepay_inshop_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_numString官方未标注必填业务字段 prepay_inshop_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amtString官方未标注必填业务字段 prepay_dir_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_numString官方未标注必填业务字段 prepay_dir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amtString官方未标注必填业务字段 prepay_indir_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_numString官方未标注必填业务字段 prepay_indir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amtString官方未标注必填业务字段 alipay_dir_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amtString官方未标注必填业务字段 alipay_indir_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amtString官方未标注必填归因成交金额xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_numString官方未标注必填归因成交数量xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_numString官方未标注必填业务字段 alipay_dir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_numString官方未标注必填业务字段 alipay_indir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvrString官方未标注必填转化比例xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roiString官方未标注必填投入产出比xxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_costString官方未标注必填业务字段 alipay_inshop_costxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_numString官方未标注必填业务字段 cart_inshop_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_numString官方未标注必填业务字段 cart_dir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_numString官方未标注必填业务字段 cart_indir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rateString官方未标注必填业务字段 cart_ratexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_numString官方未标注必填业务字段 item_col_inshop_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_numString官方未标注必填业务字段 shop_col_dir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_costString官方未标注必填业务字段 shop_col_inshop_costxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_numString官方未标注必填业务字段 col_cart_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_costString官方未标注必填业务字段 col_cart_costxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cartString官方未标注必填业务字段 item_col_cartxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_costString官方未标注必填业务字段 item_col_cart_costxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_numString官方未标注必填业务字段 col_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_costString官方未标注必填业务字段 item_col_inshop_costxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rateString官方未标注必填业务字段 item_col_inshop_ratexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_costString官方未标注必填业务字段 cart_costxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_numString官方未标注必填业务字段 gmv_inshop_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amtString官方未标注必填业务字段 gmv_inshop_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_numString官方未标注必填业务字段 item_col_dir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_numString官方未标注必填业务字段 item_col_indir_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_numString官方未标注必填业务字段 coupon_shop_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_numString官方未标注必填业务字段 shopping_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amtString官方未标注必填业务字段 shopping_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_numString官方未标注必填业务字段 ww_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pvString官方未标注必填业务字段 inshop_pvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uvString官方未标注必填业务字段 inshop_uvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uvString官方未标注必填业务字段 inshop_potential_uvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rateString官方未标注必填业务字段 inshop_potential_uv_ratexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rateString官方未标注必填业务字段 rh_ratexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_numString官方未标注必填业务字段 rh_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rateString官方未标注必填业务字段 inshop_pv_ratexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pvString官方未标注必填业务字段 deep_inshop_pvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_numString官方未标注必填业务字段 avg_access_page_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uvString官方未标注必填业务字段 new_alipay_inshop_uvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rateString官方未标注必填业务字段 new_alipay_inshop_uv_ratexxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uvString官方未标注必填业务字段 hy_sg_uvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amtString官方未标注必填业务字段 hy_pay_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_numString官方未标注必填业务字段 hy_pay_numxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amtString官方未标注必填业务字段 natural_pay_amtxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pvString官方未标注必填业务字段 org_natural_pvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uvString官方未标注必填业务字段 alipay_inshop_uvxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avgString官方未标注必填业务字段 alipay_inshop_num_avgxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avgString官方未标注必填业务字段 alipay_inshop_amt_avgxxxxx
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_nameString官方未标注必填业务字段 original_scene_name人群推广
top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code样例 JSON:universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_codeString官方未标注必填业务字段 original_biz_codeonebpDisplay

Python 签名直连示例

下载 qimenyun_direct.py 与业务脚本放在同一目录,保留淘宝业务参数,使用奇门云密钥和 shopKey 申请签名,由客户服务器直接请求淘宝。运行前补全业务参数,无需自行计算平台签名。

# Python 3.9+,无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名,再由本程序直接请求淘宝;业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥:").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.report.query.creative\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_creative_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey:").strip()

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时,先查询实际状态。

判断成功与失败

签名阶段先检查 HTTP 状态;本站鉴权、套餐或授权失败返回 {ok:false,error:{code,message}}。签名 HTTP 200 仅说明已签发;客户端执行官方请求后,还要检查淘宝响应的 error_response、逐项错误和 top_result.info.ok;失败不能当成空列表。

执行阶段的淘宝原始 error_response、业务 info 和 request_id 直接返回客户服务器,不由奇门云统一包装。签名和授权由本站管理,业务参数、日期、分页及平台资格按淘宝原始错误排查。

  • error_response:TOP 网关错误;应读取错误码及细分错误码,不能按空结果处理。
  • top_result.info:HTTP 成功仍须核对业务 ok;false 表示业务未完成。

下载本页 MD 可交给开发人员或 AI,密钥只填在自己的私密配置中。