接口参考 · 查询操作
成效预估(专用-权限限制)
taobao.universalbp.new.algo.geteffectprediction.special
核对日期: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.algo.geteffectprediction.special",
"params": {
"top_service_context": {
"biz_code": "universalBP",
"login_type": 1,
"ext": "{}"
},
"algo_query_v_o": {}
}
}这是请求结构模板。空对象和占位内容需按下方字段表填写;修改接口未填入任何真实广告编号或预算。
请求业务参数
以下路径都位于请求体的 params 内。[] 表示数组元素;嵌套字段的必填标记只描述其父对象使用时的要求。
官方 top_service_context.member_id、代理登录和扩展身份不适用于本站。本站固定使用自己的已授权店铺,login_type=1、ext={}。
| 字段路径 | 类型 / 必填 | 字段含义 | 示例值 |
|---|---|---|---|
top_service_context | TopServiceContext必填含下级字段 | 推广业务上下文 | — |
top_service_context.biz_code | String必填 | 推广场景标识 | xxxxx |
top_service_context.login_type | Number可选 | 账户登录方式枚举:1、2=代理直投(叉乘账号) | 1 |
top_service_context.member_id | Number可选 | 广告账户标识代理直投(叉乘)时必填 | 12345 |
top_service_context.ext | String可选 | 扩展参数 | {} |
algo_query_v_o | AlgoQueryVO必填含下级字段 | 查询对象 | — |
algo_query_v_o.campaign | AlgoCampaignQueryVO可选含下级字段 | 计划 | — |
algo_query_v_o.campaign.campaign_id | Number可选 | 推广计划编号 | 68799007001 |
algo_query_v_o.campaign.promotion_model | String可选 | 业务字段 promotion_model | display |
algo_query_v_o.campaign.promotion_scene | String可选 | 业务字段 promotion_scene | promotion_scene_crowd |
algo_query_v_o.campaign.similar_item_strategy | String可选 | 业务字段 similar_item_strategy | new_ad_similar |
algo_query_v_o.campaign.promotion_goals | String可选 | 业务字段 promotion_goals | shop_crowd |
algo_query_v_o.campaign.optimize_target | String可选 | 优化目标 | shop_visit_new |
algo_query_v_o.campaign.dmc_type | String可选 | 预算方式标识 | normal |
algo_query_v_o.campaign.day_budget | Number可选 | 日预算 | 60 |
algo_query_v_o.campaign.reap_all_budget | Number可选 | 业务字段 reap_all_budget | 60 |
algo_query_v_o.campaign.old_budget | Number可选 | 业务字段 old_budget | 500 |
algo_query_v_o.campaign.total_budget | Number可选 | 累计预算 | 350 |
algo_query_v_o.campaign.day_average_budget | Number可选 | 业务字段 day_average_budget | 50 |
algo_query_v_o.campaign.budget_period | Number可选 | 业务字段 budget_period | 1 |
algo_query_v_o.campaign.bid_type | String可选 | 出价类型 | roi_control |
algo_query_v_o.campaign.constraint_type | String可选 | 业务字段 constraint_type | roi |
algo_query_v_o.campaign.constraint_value | String可选 | 业务字段 constraint_value | 3 |
algo_query_v_o.campaign.old_constraint_value | String可选 | 业务字段 old_constraint_value | 2.5 |
algo_query_v_o.campaign.promotion_type | String可选 | 业务字段 promotion_type | item |
algo_query_v_o.campaign.item_selected_mode | String可选 | 业务字段 item_selected_mode | user_define |
algo_query_v_o.campaign.item_rec_strategy | String []可选 | 业务字段 item_rec_strategy | ["effect_gmv","effect_coll"] |
algo_query_v_o.campaign.is_quick_lift | Boolean可选 | 业务字段 is_quick_lift | true |
algo_query_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO可选含下级字段 | 预算操作对象 | — |
algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean可选 | 业务字段 quick_lift_switch枚举:true=打开、false=关闭 | true |
algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget | String可选 | 业务字段 quick_lift_budget | 50 |
algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot | String可选 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_list | String []可选 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget_version | String可选 | 业务字段 quick_lift_budget_version | 1 |
algo_query_v_o.campaign.adzone_list | AdzoneRefCommandVO []可选含下级字段 | 列表集合 | — |
algo_query_v_o.campaign.adzone_list[].adzone_id | Number可选 | 业务对象标识 | 111287850198 |
algo_query_v_o.campaign.adzone_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
algo_query_v_o.campaign.adzone_list[].discount | Number可选 | 出价溢价 | 3 |
algo_query_v_o.campaign.adzone_list[].status | String可选 | 状态标识枚举:start=投放、pause=暂停 | start |
algo_query_v_o.campaign.crowd_list | CrowdRefCommandVO []可选含下级字段 | 人群列表 | — |
algo_query_v_o.campaign.crowd_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68799007001 |
algo_query_v_o.campaign.crowd_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68796878061 |
algo_query_v_o.campaign.crowd_list[].crowd_id | Number可选 | 人群标识人群已经存在场景必填 | 5526396502 |
algo_query_v_o.campaign.crowd_list[].online_status | Number可选 | 投放上下线状态枚举:0、1=上线 | 1 |
algo_query_v_o.campaign.crowd_list[].crowd | CrowdCommandVO可选含下级字段 | 人群 | — |
algo_query_v_o.campaign.crowd_list[].crowd.crowd_id | Number可选 | 人群标识人群已经存在场景必填 | 5526396502 |
algo_query_v_o.campaign.crowd_list[].crowd.crowd_name | String可选 | 人群名称 | 目标人群扩展 |
algo_query_v_o.campaign.crowd_list[].crowd.crowd_value | String可选 | 人群值 | 2191820003 |
algo_query_v_o.campaign.crowd_list[].crowd.target_type | Number可选 | 目标类型 | 130 |
algo_query_v_o.campaign.crowd_list[].crowd.label | LabelCommandVO可选含下级字段 | 定向标签 | — |
algo_query_v_o.campaign.crowd_list[].crowd.label.target_type | Number可选 | 目标类型 | 131 |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_id | Number可选 | 定向标签标识 | 3000494 |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_name | String可选 | 定向标签名称 | 关键词 |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_desc | String可选 | 业务字段 label_desc | 关键词 |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_value | String可选 | 定向标签值 | 2000112 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list | OptionCommandVO []可选含下级字段 | 列表集合 | — |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_name | String可选 | 业务字段 option_name | 人群特征继承 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_value | String可选 | 业务字段 option_value | 2000123 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].tag_id | Number可选 | 业务对象标识 | 100000 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].properties | String可选 | 扩展属性内容 | — |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties可选含下级字段 | 定向标签对象 | — |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String可选 | 业务对象标识 | 1001 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String可选 | 业务字段 cate_name | 714616513841 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String可选 | 业务对象标识 | 714616513841 |
algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String []可选 | 值集合 | [183] |
algo_query_v_o.campaign.crowd_list[].crowd.label.properties | String可选 | 扩展属性内容 | — |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties可选含下级字段 | 定向标签对象 | — |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String可选 | 业务对象标识 | 1001 |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String可选 | 业务字段 cate_name | 714616513841 |
algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String可选 | 业务对象标识 | 714616513841 |
algo_query_v_o.campaign.crowd_list[].crowd.label.target_value | Number可选 | 目标值 | 11111 |
algo_query_v_o.campaign.crowd_list[].crowd.label.is_multi | Boolean可选 | 业务字段 is_multi | true |
algo_query_v_o.campaign.crowd_list[].crowd.lookalike_multiple | String可选 | 业务字段 lookalike_multiple | 1 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO []可选含下级字段 | 人群列表集合 | — |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO可选含下级字段 | 人群 | — |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number可选 | 人群标识 | 5536708993 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String可选 | 人群名称 | 喜欢店铺新品的访客 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO可选含下级字段 | 定向标签 | — |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number可选 | 定向标签标识 | 3000494 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String可选 | 定向标签名称 | 关键词 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO []可选含下级字段 | 列表集合 | — |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String可选 | 业务字段 option_name | 人群特征继承 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String可选 | 业务字段 option_value | 2000123 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number可选 | 业务对象标识 | 100000 |
algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String可选 | 扩展属性内容 | — |
algo_query_v_o.campaign.crowd_list[].price | PriceCommandVO可选含下级字段 | 金额 | — |
algo_query_v_o.campaign.crowd_list[].price.bid_price | String可选 | 出价金额 | 30 |
algo_query_v_o.campaign.crowd_list[].price.discount | String可选 | 出价溢价 | 30 |
algo_query_v_o.campaign.launch_period_list | CampaignLaunchPeriodCommandVO []可选含下级字段 | 列表集合 | — |
algo_query_v_o.campaign.launch_period_list[].day_of_week | Number可选 | 业务字段 day_of_week | 1 |
algo_query_v_o.campaign.launch_period_list[].time_span_list | TimeSpanVO []可选含下级字段 | 时间列表集合 | — |
algo_query_v_o.campaign.launch_period_list[].time_span_list[].discount | Number可选 | 出价溢价 | 100 |
algo_query_v_o.campaign.launch_period_list[].time_span_list[].time | String可选 | 时间 | 00:00-24:00 |
algo_query_v_o.campaign.launch_area_str_list | String []可选 | 地域集合 | ["all"] |
algo_query_v_o.campaign.launch_time | CampaignLaunchTimeCommandVO可选含下级字段 | 时间对象 | — |
algo_query_v_o.campaign.launch_time.start_time | Date可选 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
algo_query_v_o.campaign.launch_time.end_time | Date可选 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
algo_query_v_o.campaign.launch_time.launch_forever | Boolean可选 | 业务字段 launch_forever枚举:true=是、false=否 | true |
algo_query_v_o.campaign.word_list | WordCommandVO []可选含下级字段 | 词列表 | — |
algo_query_v_o.campaign.word_list[].bidword_id | Number可选 | 关键词标识关键词已经存在场景必填 | 1124844766581 |
algo_query_v_o.campaign.word_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
algo_query_v_o.campaign.word_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68793666608 |
algo_query_v_o.campaign.word_list[].word | String可选 | 词 | 鞋原创小众 |
algo_query_v_o.campaign.word_list[].bid_price | String可选 | 出价金额 | 2.23 |
algo_query_v_o.campaign.word_list[].suggest_trace_id | String可选 | 建议标识 | xxxxx |
algo_query_v_o.campaign.word_list[].online_status | Number可选 | 投放上下线状态枚举:1=在线、0=下线 | 1 |
algo_query_v_o.campaign.word_list[].match_scope | Number可选 | 业务字段 match_scope枚举:1=精准匹配、4=广泛匹配 | 4 |
algo_query_v_o.campaign.search_upgrade_pxb | Number可选 | 业务字段 search_upgrade_pxb | 0 |
algo_query_v_o.campaign.need_target_crowd | Number可选 | 业务字段 need_target_crowd | 1 |
algo_query_v_o.campaign.algo_prediction_extra_info | String可选 | 业务字段 algo_prediction_extra_info | {} |
algo_query_v_o.campaign.bid_type_v2 | String可选 | 业务字段 bid_type_v2 | smart_bid |
algo_query_v_o.campaign.bid_target_v2 | String可选 | 业务字段 bid_target_v2 | conv |
algo_query_v_o.campaign.set_single_cost_v2 | Boolean可选 | 业务字段 set_single_cost_v2 | true |
algo_query_v_o.campaign.promotion_strategy | String可选 | 业务字段 promotion_strategy | xxxxx |
algo_query_v_o.campaign.majorization_p_p_c | Boolean可选 | 业务字段 majorization_p_p_c | false |
algo_query_v_o.campaign.user_type | Number可选 | 业务字段 user_type | 10 |
algo_query_v_o.campaign.is_multi_target | Boolean可选 | 业务字段 is_multi_target | true |
algo_query_v_o.campaign.multi_target | CampaignMultiTargetVO可选含下级字段 | 目标对象 | — |
algo_query_v_o.campaign.multi_target.multi_target_switch | Number可选 | 业务字段 multi_target_switch枚举:0=关闭、1=开启 | 1 |
algo_query_v_o.campaign.multi_target.multi_target_source_type | Number可选 | 业务字段 multi_target_source_type | 1 |
algo_query_v_o.campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO []可选含下级字段 | 目标列表集合 | — |
algo_query_v_o.campaign.multi_target.multi_target_config_list[].optimize_target | String可选 | 优化目标 | 1034 |
algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget | String可选 | 业务字段 multi_target_budget | 1000 |
algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number可选 | 业务字段 multi_target_defined_max_rate | 50 |
algo_query_v_o.adgroup_list | AlgoAdgroupQueryVO []可选含下级字段 | 单元列表 | — |
algo_query_v_o.adgroup_list[].material | AdgroupMaterialCommandVO可选含下级字段 | 素材 | — |
algo_query_v_o.adgroup_list[].material.material_id | Number可选 | 素材标识 | 714616513841 |
algo_query_v_o.adgroup_list[].material.material_name | String可选 | 素材名称 | yiliantest测试请不要拍22 |
algo_query_v_o.adgroup_list[].material.promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
algo_query_v_o.adgroup_list[].material.sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
algo_query_v_o.adgroup_list[].material.link_url | String可选 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
algo_query_v_o.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO []可选含下级字段 | 列表集合 | — |
algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String可选 | 业务字段 life_cycle_desc | 新品打爆期 |
algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].color | String可选 | 业务字段 color | #36A2FC |
algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].tips | String可选 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].type | Number可选 | 类型 | 1 |
algo_query_v_o.effect_type_list | String []可选 | 类型集合 | ["gmv"] |
algo_query_v_o.dmc_type_element | String可选 | 业务字段 dmc_type_element | dayBudget |
返回业务字段
响应外层为 universalbp_new_algo_geteffectprediction_special_response。下面的逻辑字段路径从该外层内部开始;样例 JSON 路径额外标注 TOP 集合包装,解析时仍需以实际返回为准。
| 字段路径 | 类型 / 必填 | 字段含义 | 示例值 |
|---|---|---|---|
top_result样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result | TopResult官方未标注必填含下级字段 | 接口业务结果 | — |
top_result.info样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.info | TopInfo官方未标注必填含下级字段 | 执行状态信息 | — |
top_result.info.ok样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.info.ok | Boolean官方未标注必填 | 业务是否成功 | true |
top_result.info.message样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.info.message | String官方未标注必填 | 业务结果提示 | 参数错误 |
top_result.info.error_code样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.info.error_code | String官方未标注必填 | 业务错误标识 | xxxxx |
top_result.effect_predict_v_o样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o | EffectPredictVO官方未标注必填含下级字段 | 业务对象 | — |
top_result.effect_predict_v_o.pv样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.pv | Number官方未标注必填 | 业务字段 pv | 1621 |
top_result.effect_predict_v_o.pv_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.pv_low | Number官方未标注必填 | 业务字段 pv_low | 1297 |
top_result.effect_predict_v_o.pv_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.pv_high | Number官方未标注必填 | 业务字段 pv_high | 1945 |
top_result.effect_predict_v_o.click样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.click | Number官方未标注必填 | 点击次数 | 97 |
top_result.effect_predict_v_o.click_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.click_low | Number官方未标注必填 | 业务字段 click_low | 78 |
top_result.effect_predict_v_o.click_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.click_high | Number官方未标注必填 | 业务字段 click_high | 117 |
top_result.effect_predict_v_o.conv样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.conv | Number官方未标注必填 | 业务字段 conv | 13 |
top_result.effect_predict_v_o.conv_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.conv_low | Number官方未标注必填 | 业务字段 conv_low | 10 |
top_result.effect_predict_v_o.conv_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.conv_high | Number官方未标注必填 | 业务字段 conv_high | 15 |
top_result.effect_predict_v_o.wconv样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.wconv | Number官方未标注必填 | 业务字段 wconv | 27 |
top_result.effect_predict_v_o.wconv_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.wconv_low | Number官方未标注必填 | 业务字段 wconv_low | 22 |
top_result.effect_predict_v_o.wconv_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.wconv_high | Number官方未标注必填 | 业务字段 wconv_high | 33 |
top_result.effect_predict_v_o.mem样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.mem | Number官方未标注必填 | 业务字段 mem | 0 |
top_result.effect_predict_v_o.mem_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.mem_low | Number官方未标注必填 | 业务字段 mem_low | 0 |
top_result.effect_predict_v_o.mem_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.mem_high | Number官方未标注必填 | 业务字段 mem_high | 1 |
top_result.effect_predict_v_o.cost样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cost | String官方未标注必填 | 业务字段 cost计量单位:元 | 823.83 |
top_result.effect_predict_v_o.cost_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cost_low | String官方未标注必填 | 业务字段 cost_low计量单位:元 | 659.06 |
top_result.effect_predict_v_o.cost_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cost_high | String官方未标注必填 | 业务字段 cost_high计量单位:元 | 988.60 |
top_result.effect_predict_v_o.cart样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cart | Number官方未标注必填 | 业务字段 cart | 10 |
top_result.effect_predict_v_o.cart_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cart_low | Number官方未标注必填 | 业务字段 cart_low | 5 |
top_result.effect_predict_v_o.cart_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cart_high | Number官方未标注必填 | 业务字段 cart_high | 15 |
top_result.effect_predict_v_o.uv_aim_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.uv_aim_low | Number官方未标注必填 | 业务字段 uv_aim_low | 5 |
top_result.effect_predict_v_o.uv_aim_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.uv_aim_high | Number官方未标注必填 | 业务字段 uv_aim_high | 15 |
top_result.effect_predict_v_o.gmv样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv | String官方未标注必填 | 业务字段 gmv | 6845.21 |
top_result.effect_predict_v_o.gmv_net样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_net | String官方未标注必填 | 业务字段 gmv_net | 6845.21 |
top_result.effect_predict_v_o.gmv_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_low | String官方未标注必填 | 业务字段 gmv_low | 5476.17 |
top_result.effect_predict_v_o.gmv_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_high | String官方未标注必填 | 业务字段 gmv_high | 8214.26 |
top_result.effect_predict_v_o.gmv_low_net样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_low_net | String官方未标注必填 | 业务字段 gmv_low_net | 5476.17 |
top_result.effect_predict_v_o.gmv_high_net样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_high_net | String官方未标注必填 | 业务字段 gmv_high_net | 8214.26 |
top_result.effect_predict_v_o.min_gmv样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.min_gmv | String官方未标注必填 | 业务字段 min_gmv | 5476.17 |
top_result.effect_predict_v_o.max_gmv样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.max_gmv | String官方未标注必填 | 业务字段 max_gmv | 8214.26 |
top_result.effect_predict_v_o.success_ratio_high样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.success_ratio_high | String官方未标注必填 | 业务字段 success_ratio_high | 0.9 |
top_result.effect_predict_v_o.success_ratio_low样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.success_ratio_low | String官方未标注必填 | 业务字段 success_ratio_low | 0.8 |
top_result.effect_predict_v_o.gmv_diff_percent样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_diff_percent | String官方未标注必填 | 业务字段 gmv_diff_percent | 0.67 |
top_result.effect_predict_v_o.effect_predict_reason样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.effect_predict_reason | String官方未标注必填 | 业务字段 effect_predict_reason | 预计曝光量<span number=\"highlight\">+20%</span>,自然流量助推<span number=\"error\">+10%</span> |
top_result.effect_predict_v_o.reason样例 JSON:universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.reason | String官方未标注必填 | 业务字段 reason | 预计可获得点击量2次 |
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.algo.geteffectprediction.special\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"algo_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,密钥只填在自己的私密配置中。