淘宝开放平台

请求地址：

环境	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_v_o	AlgoQueryVO	必须	algoQueryVO
campaign AlgoCampaignQueryVO 可选计划维度算法请求参数 └ 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 出价约束 └ promotion_type String 可选 item 主体类型 └ item_selected_mode String 可选 user_define 选品方式 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:否 └ 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

名称	类型	示例值	描述
top_result	TopResult		topResult
info TopInfo 通用前端结果的Info信息请求系统信息 └ ok Boolean true 是否成功 └ message String 参数错误错误信息 └ error_code String xxxxx 错误编码 bid_suggest_v_o BidSuggestVO 结果集 └ 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_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 30 出价 └ fit_bid_price String 30 建议出价 └ discount String 30 溢价 └ fit_discount String 30 建议溢价 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 30 出价 └ fit_bid_price String 30 建议出价 └ discount String 30 溢价 └ fit_discount String 30 建议溢价 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 消耗下限，单位元 └ gmv String 6845.21 预估成交额元 └ gmv_low String 5476.17 预估成交额下限元 └ gmv_high String 8214.26 预估成交额上限元 └ cart Number 10 加购 └ cart_low Number 5 加购下限 └ cart_high Number 15 加购上限 └ uv_aim_low Number 5 预估目标uv数下限 └ uv_aim_high Number 15 预估目标uv数上限 └ gmv_diff_percent String 0.67 gmv预估变化

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewAlgoGetbidsuggestionRequest req = new UniversalbpNewAlgoGetbidsuggestionRequest();
UniversalbpNewAlgoGetbidsuggestionRequest.TopServiceContext obj1 = new UniversalbpNewAlgoGetbidsuggestionRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoQueryVO obj2 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoQueryVO();
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoCampaignQueryVO obj3 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoCampaignQueryVO();
obj3.setPromotionModel("display");
obj3.setPromotionScene("promotion_scene_crowd");
obj3.setPromotionGoals("shop_crowd");
obj3.setOptimizeTarget("shop_visit_new");
obj3.setDmcType("normal");
obj3.setDayBudget(60L);
obj3.setTotalBudget(350L);
obj3.setBudgetPeriod(1L);
obj3.setBidType("roi_control");
obj3.setConstraintType("roi");
obj3.setPromotionType("item");
obj3.setItemSelectedMode("user_define");
List<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO> list5 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO obj6 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO();
list5.add(obj6);
obj6.setDayOfWeek(1L);
List<UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO> list9 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO obj10 = new UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO();
list9.add(obj10);
obj10.setDiscount(100L);
obj10.setTime("00:00-24:00");
list7.setTimeSpanList(list9);
obj3.setLaunchPeriodList(list5);
obj3.setLaunchAreaStrList(""all"");
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVO obj11 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVO();
obj11.setStartTime(StringUtils.parseDateTime("2023-06-09 00:00:00"));
obj11.setEndTime(StringUtils.parseDateTime("2199-02-01 00:00:00"));
obj11.setLaunchForever(true);
obj3.setLaunchTime(obj11);
obj3.setBidTypeV2("smart_bid");
obj3.setBidTargetV2("conv");
obj3.setSetSingleCostV2(true);
obj3.setItemRecStrategy(""effect_gmv","effect_coll"");
obj2.setCampaign(obj3);
List<UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO> list13 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO obj14 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO();
list13.add(obj14);
UniversalbpNewAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVO obj16 = new UniversalbpNewAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVO();
obj16.setMaterialId(714616513841L);
list15.setMaterial(obj16);
obj2.setAdgroupList(list13);
req.setAlgoQueryVO(obj2);
UniversalbpNewAlgoGetbidsuggestionResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UniversalbpNewAlgoGetbidsuggestionRequest req = new UniversalbpNewAlgoGetbidsuggestionRequest();
UniversalbpNewAlgoGetbidsuggestionRequest.TopServiceContextDomain obj1 = new UniversalbpNewAlgoGetbidsuggestionRequest.TopServiceContextDomain();
obj1.BizCode = "xxxxx";
obj1.LoginType = 1L;
obj1.MemberId = 12345L;
obj1.Ext = "{}";
req.TopServiceContext_ = obj1;
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoQueryVODomain obj2 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoQueryVODomain();
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoCampaignQueryVODomain obj3 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoCampaignQueryVODomain();
obj3.PromotionModel = "display";
obj3.PromotionScene = "promotion_scene_crowd";
obj3.PromotionGoals = "shop_crowd";
obj3.OptimizeTarget = "shop_visit_new";
obj3.DmcType = "normal";
obj3.DayBudget = 60L;
obj3.TotalBudget = 350L;
obj3.BudgetPeriod = 1L;
obj3.BidType = "roi_control";
obj3.ConstraintType = "roi";
obj3.PromotionType = "item";
obj3.ItemSelectedMode = "user_define";
List<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain> list5 = new List<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain>();
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain obj6 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVODomain();
list5.Add(obj6);
obj6.DayOfWeek = 1L;
List<UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVODomain> list8 = new List<UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVODomain>();
UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVODomain obj9 = new UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVODomain();
list8.Add(obj9);
obj9.Discount = 100L;
obj9.Time = "00:00-24:00";
obj6.TimeSpanList= list8;
obj3.LaunchPeriodList= list5;
obj3.LaunchAreaStrList = ""all"";
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVODomain obj10 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVODomain();
obj10.StartTime = DateTime.Parse(2023-06-09 00:00:00");
obj10.EndTime = DateTime.Parse(2199-02-01 00:00:00");
obj10.LaunchForever = true;
obj3.LaunchTime= obj10;
obj3.BidTypeV2 = "smart_bid";
obj3.BidTargetV2 = "conv";
obj3.SetSingleCostV2 = true;
obj3.ItemRecStrategy = ""effect_gmv","effect_coll"";
obj2.Campaign= obj3;
List<UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVODomain> list12 = new List<UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVODomain>();
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVODomain obj13 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVODomain();
list12.Add(obj13);
UniversalbpNewAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVODomain obj14 = new UniversalbpNewAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVODomain();
obj14.MaterialId = 714616513841L;
obj13.Material= obj14;
obj2.AdgroupList= list12;
req.AlgoQueryVO_ = obj2;
UniversalbpNewAlgoGetbidsuggestionResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UniversalbpNewAlgoGetbidsuggestionRequest;
$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_v_o = new AlgoQueryVO;
$campaign = new AlgoCampaignQueryVO;
$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->promotion_type="item";
$campaign->item_selected_mode="user_define";
$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;
$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_v_o->campaign = $campaign;
$adgroup_list = new AlgoAdgroupQueryVO;
$material = new AdgroupMaterialCommandVO;
$material->material_id="714616513841";
$adgroup_list->material = $material;
$algo_query_v_o->adgroup_list = $adgroup_list;
$req->setAlgoQueryVO(json_encode($algo_query_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.getbidsuggestion' \
-d 'partner_id=apidoc' \
-d 'session=52ce924c-8ac5-465d-9eff-b8950fb4a46f' \
-d 'sign=078C3918AC6FB43B825C54D57CCB73E9' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+15%3A58%3A19' \
-d 'v=2.0' \
-d 'algo_query_v_o=null' \
-d 'top_service_context=TopServiceContext'

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

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

req.top_service_context="TopServiceContext"
req.algo_query_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.getbidsuggestion");
add_param(pRequest,"top_service_context","数据结构JSON示例");
add_param(pRequest,"algo_query_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.getbidsuggestion', {
	'top_service_context':'数据结构JSON示例',
	'algo_query_v_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<universalbp_new_algo_getbidsuggestion_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <bid_suggest_v_o>
            <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_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>30</bid_price>
                                <fit_bid_price>30</fit_bid_price>
                                <discount>30</discount>
                                <fit_discount>30</fit_discount>
                            </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>30</bid_price>
                        <fit_bid_price>30</fit_bid_price>
                        <discount>30</discount>
                        <fit_discount>30</fit_discount>
                    </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>
                <gmv>6845.21</gmv>
                <gmv_low>5476.17</gmv_low>
                <gmv_high>8214.26</gmv_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_diff_percent>0.67</gmv_diff_percent>
            </bid_middle_effect>
        </bid_suggest_v_o>
    </top_result>
</universalbp_new_algo_getbidsuggestion_response>

{
    "universalbp_new_algo_getbidsuggestion_response":{
        "top_result":{
            "info":{
                "ok":true,
                "message":"参数错误",
                "error_code":"xxxxx"
            },
            "bid_suggest_v_o":{
                "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_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":"30",
                                        "fit_bid_price":"30",
                                        "discount":"30",
                                        "fit_discount":"30"
                                    },
                                    "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":"30",
                                "fit_bid_price":"30",
                                "discount":"30",
                                "fit_discount":"30"
                            },
                            "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",
                    "gmv":"6845.21",
                    "gmv_low":"5476.17",
                    "gmv_high":"8214.26",
                    "cart":10,
                    "cart_low":5,
                    "cart_high":15,
                    "uv_aim_low":5,
                    "uv_aim_high":15,
                    "gmv_diff_percent":"0.67"
                }
            }
        }
    }
}

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.getbidsuggestion (获取出价建议)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ