淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	描述
top_service_context	TopServiceContext	必须	topServiceContext
└ biz_code String 必须 xxxxx api业务线编码 └ login_type Number 可选 1 1: 直客(正常)登录 2: 代理直投(叉乘账号) └ member_id Number 可选 12345 代理直投时被代理商家账号, 代理直投（叉乘）时必填。直客时也可以填入 memberId └ ext String 可选 {} 扩展内容, 暂时无用
algo_query_list_v_o	AlgoQueryListVO	必须	algoQueryListVO
algo_query_list AlgoQueryVO [] 可选出价建议查询对象 campaign AlgoCampaignQueryVO 可选计划维度算法请求参数 └ campaign_id Number 可选 68799007001 计划id └ promotion_model String 可选 display 推广类型 └ promotion_scene String 可选 promotion_scene_crowd 推广场景 └ promotion_goals String 可选 shop_crowd 推广目标 └ optimize_target String 可选 shop_visit_new 优化目标 └ dmc_type String 可选 normal 预算类型 └ day_budget Number 可选 60 日预算 └ total_budget Number 可选 350 周预算 └ budget_period Number 可选 1 周期 └ bid_type String 可选 roi_control 出价方式 └ constraint_type String 可选 roi 出价约束 └ constraint_value String 可选 3 出价约束值 └ promotion_type String 可选 item 主体类型 └ item_selected_mode String 可选 user_define 选品方式 adzone_list AdzoneRefCommandVO [] 可选资源位 └ adzone_id Number 可选 111287850198 资源包id └ campaign_id Number 可选 68796878069 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景 └ discount Number 可选 3 资源位/包溢价 └ status String 可选 start 状态,start:投放,pause:暂停 launch_period_list CampaignLaunchPeriodCommandVO [] 可选投放折扣时段设置 └ day_of_week Number 可选 1 本周的第x天 time_span_list TimeSpanVO [] 可选第x天各时段的折扣情况 └ discount Number 可选 100 折扣 └ time String 可选 00:00-24:00 折扣时间段 └ launch_area_str_list String [] 可选 ["all"] 投放地域 launch_time CampaignLaunchTimeCommandVO 可选计划投放时间 └ start_time Date 可选 2023-06-09 00:00:00 计划开始时间 └ end_time Date 可选 2199-02-01 00:00:00 计划结束时间 └ launch_forever Boolean 可选 true 是否长期投放,true:是,false:否 word_list WordCommandVO [] 可选词 └ bidword_id Number 可选 1124844766581 关键词id,关键词已经存在场景必填 └ campaign_id Number 可选 68796878069 计划id,计划已经存在场景必填 └ adgroup_id Number 可选 68793666608 单元id,单元已经存在场景必填 └ word String 可选鞋原创小众词 └ bid_price String 可选 2.23 关键词基础出价 └ suggest_trace_id String 可选 xxxxx 关键词出价建议traceId └ online_status Number 可选 1 词包状态,1:在线,0:下线 └ match_scope Number 可选 4 匹配类型,1:精准匹配,4:广泛匹配 └ search_upgrade_pxb Number 可选 0 搜索升级 └ need_target_crowd Number 可选 1 有无目标人群 └ algo_prediction_extra_info String 可选 {} 指标扩展信息 └ bid_type_v2 String 可选 smart_bid 智能出价升级，出价类型 └ bid_target_v2 String 可选 conv 出价目标 └ set_single_cost_v2 Boolean 可选 true 是否设置单次成本 └ item_rec_strategy String [] 可选 ["effect_gmv","effect_coll"] 选品方向 adgroup_list AlgoAdgroupQueryVO [] 可选单元维度算法请求参数 material AdgroupMaterialCommandVO 可选主体类型对应的物料信息 └ material_id Number 可选 714616513841 物料id └ material_name String 可选 yiliantest测试请不要拍22 物料名称 └ promotion_type String 可选 item 推广主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,content:内容,short_video:短视频,user_define:自定义; └ sub_promotion_type String 可选 item 推广子主体类型,item:商品，item_private_mini:独享橱窗，shop:店铺，you_hao_huo:有好货，picture:图文，short_video:短视频，live_room:直播间，live_spot:看点，tao_blocks:淘积木，user_define_url:自定义url └ link_url String 可选 http://shop191070507.taobao.com/index.htm 物料地址 goal_life_cycle_list ItemLifeCycleViewVO [] 可选 [{color: "#FFA53D", bizCode: null, lifeCycleDesc: "冷启期", type: 1, tips: "近30日GMV排名在叶子类目55%以下的新品"}] 货品序列化越迁目标 └ life_cycle_desc String 可选新品打爆期周期文案 └ color String 可选 #36A2FC 文案颜色 └ tips String 可选近30日GMV排名在叶子类目5%以内的新品周期提示文案 └ type Number 可选 1 生命周期类型 └ dmc_type_element String 可选 dayBudget 组件类型

名称	类型	示例值	描述
top_result	TopResult		topResult
info TopInfo 通用前端结果的Info信息请求系统信息 └ ok Boolean true 是否成功 └ message String 参数错误错误信息 └ error_code String xxxxx 错误编码 bid_suggest_v_o_top_part_data TopPartData 结果集 └ count Number 10 成功数量 bid_suggest_v_o_list BidSuggestVO [] 批量成功结果集 └ campaign_id Number 68796878069 计划id └ bid_min String 4.17 建议出价最小值(元) └ bid_max String 16.66 建议出价最大值(元) └ bid_left String 6.66 建议出价下界(元) └ bid_middle String 8.33 建议出价（默认值）元 └ bid_right String 9.66 建议出价上界(元) └ validate_bid_min String 0.10 输入框校验下限 └ validate_bid_max String 10.00 输入框校验上限 adzone_suggest_discount_list AdzoneSuggestDiscountVO [] 建议溢价比例 └ adzone_id Number 111287850197 资源位id └ suggest_discount Number 35 建议溢价比例 adzone_list AdzoneRefVO [] 资源包关联关系 └ adzone_id Number 111287850198 资源包id └ adzone_name String 全屏微详情资源包名字 └ campaign_id Number 68796878069 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景 └ campaign_name String 管家计划_宝贝候选集计划名称 └ bid_type String max_amount 出价方式,custom_bid:手动出价,max_amount:最大化拿量,cost_control:控成本,roi_control:控投产比 └ discount Number 0 资源位/包溢价 └ fit_discount Number 0 建议溢价 └ status String start 状态,start:投放,pause:暂停 operation_list OperationVO [] 操作按钮列表 └ code String 12 操作项code └ name String 操作操作项名称 └ tips String xxxx 悬浮提示 └ disabled Boolean false 是否可操作 crowd_suggest_price_list CrowdSuggestPriceVO [] 定向人群出价建议 └ target_type Number 100 定向类型targetType └ option_value String 31536383 定向类型optionValue └ price_upper String 0.71 建议出价上界 └ price_lower String 0.48 建议出价下界 └ price_middle String 0.60 建议出价 crowd_list CrowdRefVO [] 人群关系实体 └ campaign_id Number 68799007001 计划id └ adgroup_id Number 68796878061 单元id └ crowd_id Number 5526396502 人群主键id └ online_status Number 1 定向状态,0:下线 1:上线 crowd CrowdVO 人群 └ crowd_id Number 5526396502 人群主键id └ crowd_name String 目标人群扩展人群名称 └ crowd_value String 2191820003 人群值 └ target_type Number 130 定向类型 label LabelVO 定向标签 └ target_type Number 131 定向标签类型 └ label_id Number 3000494 定向标签id └ label_name String 关键词定向标签名称 └ label_desc String 关键词定向标签描述 └ label_value String 2000112 定向标签值 └ label_group_name String 人群人群类型，所属类型 └ price_dimension String OPTION 出价维度，OPTION:标签出价，多个子人群同时出价、LABEL:选项出价，以子人群为出价最小单位 price PriceVO 出价 └ bid_price String 1.16 出价 └ fit_bid_price String 0.70 建议出价 └ average_bid_price String 0.47 人群市场平均出价 └ min_fit_bid_price String 0.56 建议出价最小值 └ max_fit_bid_price String 0.84 建议出价最大值 └ validate_bid_min String 0.05 合法出价最小值 └ validate_bid_max String 99.99 合法出价最大值 └ discount String 30 溢价 └ fit_discount String 30 建议溢价 └ peer_avg_price String 0.56 竟对平均出价 option_group_list OptionGroupVO [] 标签选项分组 └ option_group_name String 性别标签分组名称 option_list OptionVO [] 标签选项 └ option_name String 人群特征继承选项名称 └ option_value String 2000123 选项值 └ option_desc String 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。选项描述 └ tag_id Number 100000 选项id，(用于关键词推广静态标签生成人群)如基础属性人群标签组合 └ option_group_name String 性别标签分组名称 label_option_properties LabelOptionProperties 透传属性 └ dmp_option_group_id String 1001 dmp选项分组id └ cate_name String 714616513841 物料id └ cate_id String 714616513841 物料id option_list OptionVO [] 标签选项 └ option_name String 人群特征继承选项名称 └ option_value String 2000123 选项值 └ option_desc String 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。选项描述 └ tag_id Number 100000 选项id，(用于关键词推广静态标签生成人群)如基础属性人群标签组合 └ option_group_name String 性别标签分组名称 label_option_properties LabelOptionProperties 透传属性 └ dmp_option_group_id String 1001 dmp选项分组id └ cate_name String 714616513841 物料id └ cate_id String 714616513841 物料id show_tag_list ShowTagVO [] 通用标签 └ code String hign_cvr 标签code └ name String 高转化率展示文案 └ tips String xxxxxx 悬浮描述 └ icon String xxxxxx 标签左侧图标地址 └ color String #FF4D4D 背景颜色 └ type String display_ocpc 标签类型 └ is_multi Boolean true 是否可以绑定多个定向,获取不到默认为否,true:是 false:否 └ category_id Number 3221312321 目标类目 └ category_name String 服装类目名称 label_option_properties LabelOptionProperties 透传属性 └ dmp_option_group_id String 1001 dmp选项分组id └ cate_name String 714616513841 物料id └ cate_id String 714616513841 物料id └ lookalike_multiple String 1 扩展倍数。低中高对应不同的倍数，由产品定义具体值，未来业务可支持滑动条。注意：倍数是指最终人数/种子人数，比如种子人群100万，扩展比种子多了50万，也就是总共150万，这时候扩展倍数是1.5而不是0.5 extend_seed_crowd_list ExtendSeedCrowdRefVO [] 种子人群关联信息 crowd ExtendSeedCrowdVO 人群扩展种子人群扩展种子人群的结构和实体是一致的，为了和前端交互更清晰，知道哪些参数需要传，所以定义一下种子人群的VO 种子人群信息 └ crowd_id Number 5536708993 人群主键id └ crowd_name String 喜欢店铺新品的访客人群名称 label ExtendSeedLabelVO 扩展人群种子人群Label结构种子人群label信息 └ target_type Number 131 定向标签类型 └ label_id Number 3000494 定向标签id └ label_name String 关键词定向标签名称 └ price_dimension String OPTION 出价维度，OPTION:标签出价，多个子人群同时出价、LABEL:选项出价，以子人群为出价最小单位 └ is_multi Boolean true 是否可以绑定多个定向,获取不到默认为否,true:是 false:否 option_list ExtendSeedOptionVO [] 选项值信息 └ option_name String 人群特征继承选项名称 └ option_value String 2000123 选项值 └ tag_id Number 100000 选项id，(用于关键词推广静态标签生成人群)如基础属性人群标签组合 sub_crowd_list SubCrowdVO [] 子人群信息 └ subcrowd_name String 目标人群扩展子定向名称 └ subcrowd_value String 2191820003 子定向值 price PriceVO 出价 └ bid_price String 1.16 出价 └ fit_bid_price String 0.70 建议出价 └ average_bid_price String 0.47 人群市场平均出价 └ min_fit_bid_price String 0.56 建议出价最小值 └ max_fit_bid_price String 0.84 建议出价最大值 └ validate_bid_min String 0.05 合法出价最小值 └ validate_bid_max String 99.99 合法出价最大值 └ discount String 30 溢价 └ fit_discount String 30 建议溢价 └ peer_avg_price String 0.56 竟对平均出价 show_tag_list ShowTagVO [] 通用标签 └ code String hign_cvr 标签code └ name String 高转化率展示文案 └ tips String xxxxxx 悬浮描述 └ icon String xxxxxx 标签左侧图标地址 └ color String #FF4D4D 背景颜色 └ type String display_ocpc 标签类型 bid_middle_effect EffectPredictVO 效果预估数据 └ pv Number 1621 展现量 └ pv_low Number 1297 展现量下限 └ pv_high Number 1945 展现量上限 └ click Number 97 点击量 └ click_low Number 78 点击量下限 └ click_high Number 117 点击量上限 └ conv Number 13 成交量 └ conv_low Number 10 成交量下限 └ conv_high Number 15 成交量上限 └ wconv Number 27 弱转化量 └ wconv_low Number 22 弱转化量下限 └ wconv_high Number 33 弱转化量上限 └ mem Number 0 入会量 └ mem_low Number 0 入会量下限 └ mem_high Number 1 入会量上限 └ cost String 823.83 消耗，单位元 └ cost_low String 659.06 消耗下限，单位元 └ cost_high String 988.60 消耗下限，单位元 └ cart Number 10 加购 └ cart_low Number 5 加购下限 └ cart_high Number 15 加购上限 └ uv_aim_low Number 5 预估目标uv数下限 └ uv_aim_high Number 15 预估目标uv数上限 └ gmv String 6845.21 预估成交额元 └ gmv_low String 5476.17 预估成交额下限元 └ gmv_high String 8214.26 预估成交额上限元 └ success_ratio_high String 0.9 抢位成功率上限 └ success_ratio_low String 0.8 抢位成功率下限 └ gmv_diff_percent String 0.67 gmv差异百分比 └ error_count Number 10 失败数量 error_details TopFailResult [] 失败结果集 └ code String xxxxx 业务失败编码 └ msg String xxxxx 业务失败原因

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewAlgoGetbatchbidsuggestionRequest req = new UniversalbpNewAlgoGetbatchbidsuggestionRequest();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.TopServiceContext obj1 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryListVO obj2 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryListVO();
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO> list4 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO obj5 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO();
list4.add(obj5);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoCampaignQueryVO obj7 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoCampaignQueryVO();
obj7.setCampaignId(68799007001L);
obj7.setPromotionModel("display");
obj7.setPromotionScene("promotion_scene_crowd");
obj7.setPromotionGoals("shop_crowd");
obj7.setOptimizeTarget("shop_visit_new");
obj7.setDmcType("normal");
obj7.setDayBudget(60L);
obj7.setTotalBudget(350L);
obj7.setBudgetPeriod(1L);
obj7.setBidType("roi_control");
obj7.setConstraintType("roi");
obj7.setConstraintValue("3");
obj7.setPromotionType("item");
obj7.setItemSelectedMode("user_define");
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO> list9 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO obj10 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO();
list9.add(obj10);
obj10.setAdzoneId(111287850198L);
obj10.setCampaignId(68796878069L);
obj10.setDiscount(3L);
obj10.setStatus("start");
obj7.setAdzoneList(list9);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO> list12 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO obj13 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO();
list12.add(obj13);
obj13.setDayOfWeek(1L);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO> list16 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO obj17 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO();
list16.add(obj17);
obj17.setDiscount(100L);
obj17.setTime("00:00-24:00");
list14.setTimeSpanList(list16);
obj7.setLaunchPeriodList(list12);
obj7.setLaunchAreaStrList(""all"");
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchTimeCommandVO obj18 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchTimeCommandVO();
obj18.setStartTime(StringUtils.parseDateTime("2023-06-09 00:00:00"));
obj18.setEndTime(StringUtils.parseDateTime("2199-02-01 00:00:00"));
obj18.setLaunchForever(true);
obj7.setLaunchTime(obj18);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO> list20 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO obj21 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO();
list20.add(obj21);
obj21.setBidwordId(1124844766581L);
obj21.setCampaignId(68796878069L);
obj21.setAdgroupId(68793666608L);
obj21.setWord("鞋原创小众");
obj21.setBidPrice("2.23");
obj21.setSuggestTraceId("xxxxx");
obj21.setOnlineStatus(1L);
obj21.setMatchScope(4L);
obj7.setWordList(list20);
obj7.setSearchUpgradePxb(0L);
obj7.setNeedTargetCrowd(1L);
obj7.setAlgoPredictionExtraInfo("{}");
obj7.setBidTypeV2("smart_bid");
obj7.setBidTargetV2("conv");
obj7.setSetSingleCostV2(true);
obj7.setItemRecStrategy(""effect_gmv","effect_coll"");
list6.setCampaign(obj7);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO> list24 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO obj25 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO();
list24.add(obj25);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdgroupMaterialCommandVO obj27 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdgroupMaterialCommandVO();
obj27.setMaterialId(714616513841L);
obj27.setMaterialName("yiliantest测试请不要拍22");
obj27.setPromotionType("item");
obj27.setSubPromotionType("item");
obj27.setLinkUrl("http://shop191070507.taobao.com/index.htm");
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO> list29 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO obj30 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO();
list29.add(obj30);
obj30.setLifeCycleDesc("新品打爆期");
obj30.setColor("#36A2FC");
obj30.setTips("近30日GMV排名在叶子类目5%以内的新品");
obj30.setType(1L);
obj27.setGoalLifeCycleList(list29);
list26.setMaterial(obj27);
list22.setAdgroupList(list24);
obj5.setDmcTypeElement("dayBudget");
obj2.setAlgoQueryList(list4);
req.setAlgoQueryListVO(obj2);
UniversalbpNewAlgoGetbatchbidsuggestionResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UniversalbpNewAlgoGetbatchbidsuggestionRequest req = new UniversalbpNewAlgoGetbatchbidsuggestionRequest();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.TopServiceContextDomain obj1 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.TopServiceContextDomain();
obj1.BizCode = "xxxxx";
obj1.LoginType = 1L;
obj1.MemberId = 12345L;
obj1.Ext = "{}";
req.TopServiceContext_ = obj1;
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryListVODomain obj2 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryListVODomain();
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVODomain> list4 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVODomain obj5 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVODomain();
list4.Add(obj5);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoCampaignQueryVODomain obj6 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoCampaignQueryVODomain();
obj6.CampaignId = 68799007001L;
obj6.PromotionModel = "display";
obj6.PromotionScene = "promotion_scene_crowd";
obj6.PromotionGoals = "shop_crowd";
obj6.OptimizeTarget = "shop_visit_new";
obj6.DmcType = "normal";
obj6.DayBudget = 60L;
obj6.TotalBudget = 350L;
obj6.BudgetPeriod = 1L;
obj6.BidType = "roi_control";
obj6.ConstraintType = "roi";
obj6.ConstraintValue = "3";
obj6.PromotionType = "item";
obj6.ItemSelectedMode = "user_define";
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVODomain> list8 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVODomain obj9 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVODomain();
list8.Add(obj9);
obj9.AdzoneId = 111287850198L;
obj9.CampaignId = 68796878069L;
obj9.Discount = 3L;
obj9.Status = "start";
obj6.AdzoneList= list8;
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain> list11 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain obj12 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain();
list11.Add(obj12);
obj12.DayOfWeek = 1L;
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVODomain> list14 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVODomain obj15 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVODomain();
list14.Add(obj15);
obj15.Discount = 100L;
obj15.Time = "00:00-24:00";
obj12.TimeSpanList= list14;
obj6.LaunchPeriodList= list11;
obj6.LaunchAreaStrList = ""all"";
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchTimeCommandVODomain obj16 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchTimeCommandVODomain();
obj16.StartTime = DateTime.Parse(2023-06-09 00:00:00");
obj16.EndTime = DateTime.Parse(2199-02-01 00:00:00");
obj16.LaunchForever = true;
obj6.LaunchTime= obj16;
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVODomain> list18 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVODomain obj19 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVODomain();
list18.Add(obj19);
obj19.BidwordId = 1124844766581L;
obj19.CampaignId = 68796878069L;
obj19.AdgroupId = 68793666608L;
obj19.Word = "鞋原创小众";
obj19.BidPrice = "2.23";
obj19.SuggestTraceId = "xxxxx";
obj19.OnlineStatus = 1L;
obj19.MatchScope = 4L;
obj6.WordList= list18;
obj6.SearchUpgradePxb = 0L;
obj6.NeedTargetCrowd = 1L;
obj6.AlgoPredictionExtraInfo = "{}";
obj6.BidTypeV2 = "smart_bid";
obj6.BidTargetV2 = "conv";
obj6.SetSingleCostV2 = true;
obj6.ItemRecStrategy = ""effect_gmv","effect_coll"";
obj5.Campaign= obj6;
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVODomain> list21 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVODomain obj22 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVODomain();
list21.Add(obj22);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdgroupMaterialCommandVODomain obj23 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdgroupMaterialCommandVODomain();
obj23.MaterialId = 714616513841L;
obj23.MaterialName = "yiliantest测试请不要拍22";
obj23.PromotionType = "item";
obj23.SubPromotionType = "item";
obj23.LinkUrl = "http://shop191070507.taobao.com/index.htm";
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVODomain> list25 = new List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVODomain>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVODomain obj26 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVODomain();
list25.Add(obj26);
obj26.LifeCycleDesc = "新品打爆期";
obj26.Color = "#36A2FC";
obj26.Tips = "近30日GMV排名在叶子类目5%以内的新品";
obj26.Type = 1L;
obj23.GoalLifeCycleList= list25;
obj22.Material= obj23;
obj5.AdgroupList= list21;
obj5.DmcTypeElement = "dayBudget";
obj2.AlgoQueryList= list4;
req.AlgoQueryListVO_ = obj2;
UniversalbpNewAlgoGetbatchbidsuggestionResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UniversalbpNewAlgoGetbatchbidsuggestionRequest;
$top_service_context = new TopServiceContext;
$top_service_context->biz_code="xxxxx";
$top_service_context->login_type="1";
$top_service_context->member_id="12345";
$top_service_context->ext="{}";
$req->setTopServiceContext(json_encode($top_service_context));
$algo_query_list_v_o = new AlgoQueryListVO;
$algo_query_list = new AlgoQueryVO;
$campaign = new AlgoCampaignQueryVO;
$campaign->campaign_id="68799007001";
$campaign->promotion_model="display";
$campaign->promotion_scene="promotion_scene_crowd";
$campaign->promotion_goals="shop_crowd";
$campaign->optimize_target="shop_visit_new";
$campaign->dmc_type="normal";
$campaign->day_budget="60";
$campaign->total_budget="350";
$campaign->budget_period="1";
$campaign->bid_type="roi_control";
$campaign->constraint_type="roi";
$campaign->constraint_value="3";
$campaign->promotion_type="item";
$campaign->item_selected_mode="user_define";
$adzone_list = new AdzoneRefCommandVO;
$adzone_list->adzone_id="111287850198";
$adzone_list->campaign_id="68796878069";
$adzone_list->discount="3";
$adzone_list->status="start";
$campaign->adzone_list = $adzone_list;
$launch_period_list = new CampaignLaunchPeriodCommandVO;
$launch_period_list->day_of_week="1";
$time_span_list = new TimeSpanVO;
$time_span_list->discount="100";
$time_span_list->time="00:00-24:00";
$launch_period_list->time_span_list = $time_span_list;
$campaign->launch_period_list = $launch_period_list;
$campaign->launch_area_str_list="[\"all\"]";
$launch_time = new CampaignLaunchTimeCommandVO;
$launch_time->start_time="2023-06-09 00:00:00";
$launch_time->end_time="2199-02-01 00:00:00";
$launch_time->launch_forever="true";
$campaign->launch_time = $launch_time;
$word_list = new WordCommandVO;
$word_list->bidword_id="1124844766581";
$word_list->campaign_id="68796878069";
$word_list->adgroup_id="68793666608";
$word_list->word="鞋原创小众";
$word_list->bid_price="2.23";
$word_list->suggest_trace_id="xxxxx";
$word_list->online_status="1";
$word_list->match_scope="4";
$campaign->word_list = $word_list;
$campaign->search_upgrade_pxb="0";
$campaign->need_target_crowd="1";
$campaign->algo_prediction_extra_info="{}";
$campaign->bid_type_v2="smart_bid";
$campaign->bid_target_v2="conv";
$campaign->set_single_cost_v2="true";
$campaign->item_rec_strategy="[\"effect_gmv\",\"effect_coll\"]";
$algo_query_list->campaign = $campaign;
$adgroup_list = new AlgoAdgroupQueryVO;
$material = new AdgroupMaterialCommandVO;
$material->material_id="714616513841";
$material->material_name="yiliantest测试请不要拍22";
$material->promotion_type="item";
$material->sub_promotion_type="item";
$material->link_url="http://shop191070507.taobao.com/index.htm";
$goal_life_cycle_list = new ItemLifeCycleViewVO;
$goal_life_cycle_list->life_cycle_desc="新品打爆期";
$goal_life_cycle_list->color="#36A2FC";
$goal_life_cycle_list->tips="近30日GMV排名在叶子类目5%以内的新品";
$goal_life_cycle_list->type="1";
$material->goal_life_cycle_list = $goal_life_cycle_list;
$adgroup_list->material = $material;
$algo_query_list->adgroup_list = $adgroup_list;
$algo_query_list->dmc_type_element="dayBudget";
$algo_query_list_v_o->algo_query_list = $algo_query_list;
$req->setAlgoQueryListVO(json_encode($algo_query_list_v_o));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.universalbp.new.algo.getbatchbidsuggestion' \
-d 'partner_id=apidoc' \
-d 'session=f081a375-9cff-469c-b71a-c9abeebf980a' \
-d 'sign=4F31EF57BCD16B00D3522DFCCB078FAD' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-28+15%3A26%3A52' \
-d 'v=2.0' \
-d 'algo_query_list_v_o=null' \
-d 'top_service_context=TopServiceContext'

# -*- coding: utf-8 -*-
import top.api

req=top.api.UniversalbpNewAlgoGetbatchbidsuggestionRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.top_service_context="TopServiceContext"
req.algo_query_list_v_o=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.universalbp.new.algo.getbatchbidsuggestion");
add_param(pRequest,"top_service_context","数据结构JSON示例");
add_param(pRequest,"algo_query_list_v_o","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.universalbp.new.algo.getbatchbidsuggestion', {
	'top_service_context':'数据结构JSON示例',
	'algo_query_list_v_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<universalbp_new_algo_getbatchbidsuggestion_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <bid_suggest_v_o_top_part_data>
            <count>10</count>
            <bid_suggest_v_o_list>
                <bid_suggest_v_o>
                    <campaign_id>68796878069</campaign_id>
                    <bid_min>4.17</bid_min>
                    <bid_max>16.66</bid_max>
                    <bid_left>6.66</bid_left>
                    <bid_middle>8.33</bid_middle>
                    <bid_right>9.66</bid_right>
                    <validate_bid_min>0.10</validate_bid_min>
                    <validate_bid_max>10.00</validate_bid_max>
                    <adzone_suggest_discount_list>
                        <adzone_suggest_discount_v_o>
                            <adzone_id>111287850197</adzone_id>
                            <suggest_discount>35</suggest_discount>
                        </adzone_suggest_discount_v_o>
                    </adzone_suggest_discount_list>
                    <adzone_list>
                        <adzone_ref_v_o>
                            <adzone_id>111287850198</adzone_id>
                            <adzone_name>全屏微详情</adzone_name>
                            <campaign_id>68796878069</campaign_id>
                            <campaign_name>管家计划_宝贝候选集</campaign_name>
                            <bid_type>max_amount</bid_type>
                            <discount>0</discount>
                            <fit_discount>0</fit_discount>
                            <status>start</status>
                            <operation_list>
                                <operation_v_o>
                                    <code>12</code>
                                    <name>操作</name>
                                    <tips>xxxx</tips>
                                    <disabled>false</disabled>
                                </operation_v_o>
                            </operation_list>
                        </adzone_ref_v_o>
                    </adzone_list>
                    <crowd_suggest_price_list>
                        <crowd_suggest_price_v_o>
                            <target_type>100</target_type>
                            <option_value>31536383</option_value>
                            <price_upper>0.71</price_upper>
                            <price_lower>0.48</price_lower>
                            <price_middle>0.60</price_middle>
                        </crowd_suggest_price_v_o>
                    </crowd_suggest_price_list>
                    <crowd_list>
                        <crowd_ref_v_o>
                            <campaign_id>68799007001</campaign_id>
                            <adgroup_id>68796878061</adgroup_id>
                            <crowd_id>5526396502</crowd_id>
                            <online_status>1</online_status>
                            <crowd>
                                <crowd_id>5526396502</crowd_id>
                                <crowd_name>目标人群扩展</crowd_name>
                                <crowd_value>2191820003</crowd_value>
                                <target_type>130</target_type>
                                <label>
                                    <target_type>131</target_type>
                                    <label_id>3000494</label_id>
                                    <label_name>关键词</label_name>
                                    <label_desc>关键词</label_desc>
                                    <label_value>2000112</label_value>
                                    <label_group_name>人群</label_group_name>
                                    <price_dimension>OPTION</price_dimension>
                                    <price>
                                        <bid_price>1.16</bid_price>
                                        <fit_bid_price>0.70</fit_bid_price>
                                        <average_bid_price>0.47</average_bid_price>
                                        <min_fit_bid_price>0.56</min_fit_bid_price>
                                        <max_fit_bid_price>0.84</max_fit_bid_price>
                                        <validate_bid_min>0.05</validate_bid_min>
                                        <validate_bid_max>99.99</validate_bid_max>
                                        <discount>30</discount>
                                        <fit_discount>30</fit_discount>
                                        <peer_avg_price>0.56</peer_avg_price>
                                    </price>
                                    <option_group_list>
                                        <option_group_v_o>
                                            <option_group_name>性别</option_group_name>
                                            <option_list>
                                                <option_v_o>
                                                    <option_name>人群特征继承</option_name>
                                                    <option_value>2000123</option_value>
                                                    <option_desc>该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。</option_desc>
                                                    <tag_id>100000</tag_id>
                                                    <option_group_name>性别</option_group_name>
                                                    <label_option_properties>
                                                        <dmp_option_group_id>1001</dmp_option_group_id>
                                                        <cate_name>714616513841</cate_name>
                                                        <cate_id>714616513841</cate_id>
                                                    </label_option_properties>
                                                </option_v_o>
                                            </option_list>
                                        </option_group_v_o>
                                    </option_group_list>
                                    <option_list>
                                        <option_v_o>
                                            <option_name>人群特征继承</option_name>
                                            <option_value>2000123</option_value>
                                            <option_desc>该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。</option_desc>
                                            <tag_id>100000</tag_id>
                                            <option_group_name>性别</option_group_name>
                                            <label_option_properties>
                                                <dmp_option_group_id>1001</dmp_option_group_id>
                                                <cate_name>714616513841</cate_name>
                                                <cate_id>714616513841</cate_id>
                                            </label_option_properties>
                                        </option_v_o>
                                    </option_list>
                                    <show_tag_list>
                                        <show_tag_v_o>
                                            <code>hign_cvr</code>
                                            <name>高转化率</name>
                                            <tips>xxxxxx</tips>
                                            <icon>xxxxxx</icon>
                                            <color>#FF4D4D</color>
                                            <type>display_ocpc</type>
                                        </show_tag_v_o>
                                    </show_tag_list>
                                    <is_multi>true</is_multi>
                                    <category_id>3221312321</category_id>
                                    <category_name>服装</category_name>
                                    <label_option_properties>
                                        <dmp_option_group_id>1001</dmp_option_group_id>
                                        <cate_name>714616513841</cate_name>
                                        <cate_id>714616513841</cate_id>
                                    </label_option_properties>
                                </label>
                                <lookalike_multiple>1</lookalike_multiple>
                                <extend_seed_crowd_list>
                                    <extend_seed_crowd_ref_v_o>
                                        <crowd>
                                            <crowd_id>5536708993</crowd_id>
                                            <crowd_name>喜欢店铺新品的访客</crowd_name>
                                            <label>
                                                <target_type>131</target_type>
                                                <label_id>3000494</label_id>
                                                <label_name>关键词</label_name>
                                                <price_dimension>OPTION</price_dimension>
                                                <is_multi>true</is_multi>
                                                <option_list>
                                                    <extend_seed_option_v_o>
                                                        <option_name>人群特征继承</option_name>
                                                        <option_value>2000123</option_value>
                                                        <tag_id>100000</tag_id>
                                                    </extend_seed_option_v_o>
                                                </option_list>
                                            </label>
                                        </crowd>
                                    </extend_seed_crowd_ref_v_o>
                                </extend_seed_crowd_list>
                                <sub_crowd_list>
                                    <sub_crowd_v_o>
                                        <subcrowd_name>目标人群扩展</subcrowd_name>
                                        <subcrowd_value>2191820003</subcrowd_value>
                                    </sub_crowd_v_o>
                                </sub_crowd_list>
                            </crowd>
                            <price>
                                <bid_price>1.16</bid_price>
                                <fit_bid_price>0.70</fit_bid_price>
                                <average_bid_price>0.47</average_bid_price>
                                <min_fit_bid_price>0.56</min_fit_bid_price>
                                <max_fit_bid_price>0.84</max_fit_bid_price>
                                <validate_bid_min>0.05</validate_bid_min>
                                <validate_bid_max>99.99</validate_bid_max>
                                <discount>30</discount>
                                <fit_discount>30</fit_discount>
                                <peer_avg_price>0.56</peer_avg_price>
                            </price>
                            <show_tag_list>
                                <show_tag_v_o>
                                    <code>hign_cvr</code>
                                    <name>高转化率</name>
                                    <tips>xxxxxx</tips>
                                    <icon>xxxxxx</icon>
                                    <color>#FF4D4D</color>
                                    <type>display_ocpc</type>
                                </show_tag_v_o>
                            </show_tag_list>
                        </crowd_ref_v_o>
                    </crowd_list>
                    <bid_middle_effect>
                        <pv>1621</pv>
                        <pv_low>1297</pv_low>
                        <pv_high>1945</pv_high>
                        <click>97</click>
                        <click_low>78</click_low>
                        <click_high>117</click_high>
                        <conv>13</conv>
                        <conv_low>10</conv_low>
                        <conv_high>15</conv_high>
                        <wconv>27</wconv>
                        <wconv_low>22</wconv_low>
                        <wconv_high>33</wconv_high>
                        <mem>0</mem>
                        <mem_low>0</mem_low>
                        <mem_high>1</mem_high>
                        <cost>823.83</cost>
                        <cost_low>659.06</cost_low>
                        <cost_high>988.60</cost_high>
                        <cart>10</cart>
                        <cart_low>5</cart_low>
                        <cart_high>15</cart_high>
                        <uv_aim_low>5</uv_aim_low>
                        <uv_aim_high>15</uv_aim_high>
                        <gmv>6845.21</gmv>
                        <gmv_low>5476.17</gmv_low>
                        <gmv_high>8214.26</gmv_high>
                        <success_ratio_high>0.9</success_ratio_high>
                        <success_ratio_low>0.8</success_ratio_low>
                        <gmv_diff_percent>0.67</gmv_diff_percent>
                    </bid_middle_effect>
                </bid_suggest_v_o>
            </bid_suggest_v_o_list>
            <error_count>10</error_count>
            <error_details>
                <top_fail_result>
                    <code>xxxxx</code>
                    <msg>xxxxx</msg>
                </top_fail_result>
            </error_details>
        </bid_suggest_v_o_top_part_data>
    </top_result>
</universalbp_new_algo_getbatchbidsuggestion_response>

{
    "universalbp_new_algo_getbatchbidsuggestion_response":{
        "top_result":{
            "info":{
                "ok":true,
                "message":"参数错误",
                "error_code":"xxxxx"
            },
            "bid_suggest_v_o_top_part_data":{
                "count":10,
                "bid_suggest_v_o_list":{
                    "bid_suggest_v_o":[
                        {
                            "campaign_id":68796878069,
                            "bid_min":"4.17",
                            "bid_max":"16.66",
                            "bid_left":"6.66",
                            "bid_middle":"8.33",
                            "bid_right":"9.66",
                            "validate_bid_min":"0.10",
                            "validate_bid_max":"10.00",
                            "adzone_suggest_discount_list":{
                                "adzone_suggest_discount_v_o":[
                                    {
                                        "adzone_id":111287850197,
                                        "suggest_discount":35
                                    }
                                ]
                            },
                            "adzone_list":{
                                "adzone_ref_v_o":[
                                    {
                                        "adzone_id":111287850198,
                                        "adzone_name":"全屏微详情",
                                        "campaign_id":68796878069,
                                        "campaign_name":"管家计划_宝贝候选集",
                                        "bid_type":"max_amount",
                                        "discount":0,
                                        "fit_discount":0,
                                        "status":"start",
                                        "operation_list":{
                                            "operation_v_o":[
                                                {
                                                    "code":"12",
                                                    "name":"操作",
                                                    "tips":"xxxx",
                                                    "disabled":false
                                                }
                                            ]
                                        }
                                    }
                                ]
                            },
                            "crowd_suggest_price_list":{
                                "crowd_suggest_price_v_o":[
                                    {
                                        "target_type":100,
                                        "option_value":"31536383",
                                        "price_upper":"0.71",
                                        "price_lower":"0.48",
                                        "price_middle":"0.60"
                                    }
                                ]
                            },
                            "crowd_list":{
                                "crowd_ref_v_o":[
                                    {
                                        "campaign_id":68799007001,
                                        "adgroup_id":68796878061,
                                        "crowd_id":5526396502,
                                        "online_status":1,
                                        "crowd":{
                                            "crowd_id":5526396502,
                                            "crowd_name":"目标人群扩展",
                                            "crowd_value":"2191820003",
                                            "target_type":130,
                                            "label":{
                                                "target_type":131,
                                                "label_id":3000494,
                                                "label_name":"关键词",
                                                "label_desc":"关键词",
                                                "label_value":"2000112",
                                                "label_group_name":"人群",
                                                "price_dimension":"OPTION",
                                                "price":{
                                                    "bid_price":"1.16",
                                                    "fit_bid_price":"0.70",
                                                    "average_bid_price":"0.47",
                                                    "min_fit_bid_price":"0.56",
                                                    "max_fit_bid_price":"0.84",
                                                    "validate_bid_min":"0.05",
                                                    "validate_bid_max":"99.99",
                                                    "discount":"30",
                                                    "fit_discount":"30",
                                                    "peer_avg_price":"0.56"
                                                },
                                                "option_group_list":{
                                                    "option_group_v_o":[
                                                        {
                                                            "option_group_name":"性别",
                                                            "option_list":{
                                                                "option_v_o":[
                                                                    {
                                                                        "option_name":"人群特征继承",
                                                                        "option_value":"2000123",
                                                                        "option_desc":"该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。",
                                                                        "tag_id":100000,
                                                                        "option_group_name":"性别",
                                                                        "label_option_properties":{
                                                                            "dmp_option_group_id":"1001",
                                                                            "cate_name":"714616513841",
                                                                            "cate_id":"714616513841"
                                                                        }
                                                                    }
                                                                ]
                                                            }
                                                        }
                                                    ]
                                                },
                                                "option_list":{
                                                    "option_v_o":[
                                                        {
                                                            "option_name":"人群特征继承",
                                                            "option_value":"2000123",
                                                            "option_desc":"该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。",
                                                            "tag_id":100000,
                                                            "option_group_name":"性别",
                                                            "label_option_properties":{
                                                                "dmp_option_group_id":"1001",
                                                                "cate_name":"714616513841",
                                                                "cate_id":"714616513841"
                                                            }
                                                        }
                                                    ]
                                                },
                                                "show_tag_list":{
                                                    "show_tag_v_o":[
                                                        {
                                                            "code":"hign_cvr",
                                                            "name":"高转化率",
                                                            "tips":"xxxxxx",
                                                            "icon":"xxxxxx",
                                                            "color":"#FF4D4D",
                                                            "type":"display_ocpc"
                                                        }
                                                    ]
                                                },
                                                "is_multi":true,
                                                "category_id":3221312321,
                                                "category_name":"服装",
                                                "label_option_properties":{
                                                    "dmp_option_group_id":"1001",
                                                    "cate_name":"714616513841",
                                                    "cate_id":"714616513841"
                                                }
                                            },
                                            "lookalike_multiple":"1",
                                            "extend_seed_crowd_list":{
                                                "extend_seed_crowd_ref_v_o":[
                                                    {
                                                        "crowd":{
                                                            "crowd_id":5536708993,
                                                            "crowd_name":"喜欢店铺新品的访客",
                                                            "label":{
                                                                "target_type":131,
                                                                "label_id":3000494,
                                                                "label_name":"关键词",
                                                                "price_dimension":"OPTION",
                                                                "is_multi":true,
                                                                "option_list":{
                                                                    "extend_seed_option_v_o":[
                                                                        {
                                                                            "option_name":"人群特征继承",
                                                                            "option_value":"2000123",
                                                                            "tag_id":100000
                                                                        }
                                                                    ]
                                                                }
                                                            }
                                                        }
                                                    }
                                                ]
                                            },
                                            "sub_crowd_list":{
                                                "sub_crowd_v_o":[
                                                    {
                                                        "subcrowd_name":"目标人群扩展",
                                                        "subcrowd_value":"2191820003"
                                                    }
                                                ]
                                            }
                                        },
                                        "price":{
                                            "bid_price":"1.16",
                                            "fit_bid_price":"0.70",
                                            "average_bid_price":"0.47",
                                            "min_fit_bid_price":"0.56",
                                            "max_fit_bid_price":"0.84",
                                            "validate_bid_min":"0.05",
                                            "validate_bid_max":"99.99",
                                            "discount":"30",
                                            "fit_discount":"30",
                                            "peer_avg_price":"0.56"
                                        },
                                        "show_tag_list":{
                                            "show_tag_v_o":[
                                                {
                                                    "code":"hign_cvr",
                                                    "name":"高转化率",
                                                    "tips":"xxxxxx",
                                                    "icon":"xxxxxx",
                                                    "color":"#FF4D4D",
                                                    "type":"display_ocpc"
                                                }
                                            ]
                                        }
                                    }
                                ]
                            },
                            "bid_middle_effect":{
                                "pv":1621,
                                "pv_low":1297,
                                "pv_high":1945,
                                "click":97,
                                "click_low":78,
                                "click_high":117,
                                "conv":13,
                                "conv_low":10,
                                "conv_high":15,
                                "wconv":27,
                                "wconv_low":22,
                                "wconv_high":33,
                                "mem":0,
                                "mem_low":0,
                                "mem_high":1,
                                "cost":"823.83",
                                "cost_low":"659.06",
                                "cost_high":"988.60",
                                "cart":10,
                                "cart_low":5,
                                "cart_high":15,
                                "uv_aim_low":5,
                                "uv_aim_high":15,
                                "gmv":"6845.21",
                                "gmv_low":"5476.17",
                                "gmv_high":"8214.26",
                                "success_ratio_high":"0.9",
                                "success_ratio_low":"0.8",
                                "gmv_diff_percent":"0.67"
                            }
                        }
                    ]
                },
                "error_count":10,
                "error_details":{
                    "top_fail_result":[
                        {
                            "code":"xxxxx",
                            "msg":"xxxxx"
                        }
                    ]
                }
            }
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

万相台无界API

taobao.universalbp.new.algo.getbatchbidsuggestion (批量获取出价建议)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ