淘宝开放平台 - 文档中心

请求地址：

环境	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业务线编码
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 预算类型 └ 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:否 └ day_budget Number 可选 60 日预算 └ total_budget Number 可选 350 周预算 └ budget_period Number 可选 1 周期 adgroup_list AlgoAdgroupQueryVo [] 可选单元维度算法请求参数 material AdgroupMaterialCommandVo 可选主体类型对应的物料信息 └ material_id Number 可选 714616513841 物料id

名称	类型	示例值	描述
result	TopResult		结果体
info TopInfo 请求系统信息 └ 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 null 建议出价上界(元) └ 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:暂停 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 定向标签值 └ price_dimension String OPTION 出价维度，OPTION:标签出价，多个子人群同时出价、LABEL:选项出价，以子人群为出价最小单位 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 └ is_multi Boolean true 是否可以绑定多个定向,获取不到默认为否,true:是 false:否 label_option_properties LabelOptionProperties 透传属性 └ dmp_option_group_id String 1001 dmp选项分组id └ cate_name String 714616513841 物料id └ cate_id String 714616513841 物料id price PriceVo 出价 └ min_fit_bid_price String 0.49 建议出价最小值 └ max_fit_bid_price String 0.73 建议出价最大值 └ fit_discount String 0.61 建议溢价 └ average_bid_price String 0.34 人群市场平均出价 └ validate_bid_min String 0.05 合法出价最小值 └ validate_bid_max String 99.99 合法出价最大值 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);
UniversalbpAlgoGetbidsuggestionRequest req = new UniversalbpAlgoGetbidsuggestionRequest();
UniversalbpAlgoGetbidsuggestionRequest.TopServiceContext obj1 = new UniversalbpAlgoGetbidsuggestionRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpAlgoGetbidsuggestionRequest.AlgoQueryVo obj2 = new UniversalbpAlgoGetbidsuggestionRequest.AlgoQueryVo();
UniversalbpAlgoGetbidsuggestionRequest.AlgoCampaignQueryVo obj3 = new UniversalbpAlgoGetbidsuggestionRequest.AlgoCampaignQueryVo();
obj3.setPromotionModel("display");
obj3.setPromotionScene("promotion_scene_crowd");
obj3.setPromotionGoals("shop_crowd");
obj3.setOptimizeTarget("shop_visit_new");
obj3.setDmcType("normal");
obj3.setBidType("roi_control");
obj3.setConstraintType("roi");
obj3.setPromotionType("item");
obj3.setItemSelectedMode("user_define");
List<UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVo> list5 = new ArrayList<UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVo>();
UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVo obj6 = new UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVo();
list5.add(obj6);
obj6.setDayOfWeek(1L);
List<UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVo> list9 = new ArrayList<UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVo>();
UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVo obj10 = new UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVo();
list9.add(obj10);
obj10.setDiscount(100L);
obj10.setTime("00:00-24:00");
list7.setTimeSpanList(list9);
obj3.setLaunchPeriodList(list5);
obj3.setLaunchAreaStrList(""all"");
UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVo obj11 = new UniversalbpAlgoGetbidsuggestionRequest.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.setDayBudget(60L);
obj3.setTotalBudget(350L);
obj3.setBudgetPeriod(1L);
obj2.setCampaign(obj3);
List<UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVo> list13 = new ArrayList<UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVo>();
UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVo obj14 = new UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVo();
list13.add(obj14);
UniversalbpAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVo obj16 = new UniversalbpAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVo();
obj16.setMaterialId(714616513841L);
list15.setMaterial(obj16);
obj2.setAdgroupList(list13);
req.setAlgoQueryVO(obj2);
UniversalbpAlgoGetbidsuggestionResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UniversalbpAlgoGetbidsuggestionRequest req = new UniversalbpAlgoGetbidsuggestionRequest();
UniversalbpAlgoGetbidsuggestionRequest.TopServiceContextDomain obj1 = new UniversalbpAlgoGetbidsuggestionRequest.TopServiceContextDomain();
obj1.BizCode = "xxxxx";
req.TopServiceContext_ = obj1;
UniversalbpAlgoGetbidsuggestionRequest.AlgoQueryVoDomain obj2 = new UniversalbpAlgoGetbidsuggestionRequest.AlgoQueryVoDomain();
UniversalbpAlgoGetbidsuggestionRequest.AlgoCampaignQueryVoDomain obj3 = new UniversalbpAlgoGetbidsuggestionRequest.AlgoCampaignQueryVoDomain();
obj3.PromotionModel = "display";
obj3.PromotionScene = "promotion_scene_crowd";
obj3.PromotionGoals = "shop_crowd";
obj3.OptimizeTarget = "shop_visit_new";
obj3.DmcType = "normal";
obj3.BidType = "roi_control";
obj3.ConstraintType = "roi";
obj3.PromotionType = "item";
obj3.ItemSelectedMode = "user_define";
List<UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVoDomain> list5 = new List<UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVoDomain>();
UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVoDomain obj6 = new UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVoDomain();
list5.Add(obj6);
obj6.DayOfWeek = 1L;
List<UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVoDomain> list8 = new List<UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVoDomain>();
UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVoDomain obj9 = new UniversalbpAlgoGetbidsuggestionRequest.TimeSpanVoDomain();
list8.Add(obj9);
obj9.Discount = 100L;
obj9.Time = "00:00-24:00";
obj6.TimeSpanList= list8;
obj3.LaunchPeriodList= list5;
obj3.LaunchAreaStrList = ""all"";
UniversalbpAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVoDomain obj10 = new UniversalbpAlgoGetbidsuggestionRequest.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.DayBudget = 60L;
obj3.TotalBudget = 350L;
obj3.BudgetPeriod = 1L;
obj2.Campaign= obj3;
List<UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVoDomain> list12 = new List<UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVoDomain>();
UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVoDomain obj13 = new UniversalbpAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVoDomain();
list12.Add(obj13);
UniversalbpAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVoDomain obj14 = new UniversalbpAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVoDomain();
obj14.MaterialId = 714616513841L;
obj13.Material= obj14;
obj2.AdgroupList= list12;
req.AlgoQueryVO_ = obj2;
UniversalbpAlgoGetbidsuggestionResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UniversalbpAlgoGetbidsuggestionRequest;
$top_service_context = new TopServiceContext;
$top_service_context->biz_code="xxxxx";
$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->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->day_budget="60";
$campaign->total_budget="350";
$campaign->budget_period="1";
$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.algo.getbidsuggestion' \
-d 'partner_id=apidoc' \
-d 'session=6e32f9a2-4178-4d54-82b1-e73b4e9ed7d3' \
-d 'sign=4377C08E361586D0E43CE52FC8A7900A' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+22%3A54%3A48' \
-d 'v=2.0' \
-d 'algo_query_v_o=null' \
-d 'top_service_context=null'

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

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

req.top_service_context="数据结构示例JSON格式"
req.algo_query_v_o="数据结构示例JSON格式"
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.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.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_algo_getbidsuggestion_response>
    <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>null</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_vo>
                    <adzone_id>111287850197</adzone_id>
                    <suggest_discount>35</suggest_discount>
                </adzone_suggest_discount_vo>
            </adzone_suggest_discount_list>
            <adzone_list>
                <adzone_ref_vo>
                    <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>
                </adzone_ref_vo>
            </adzone_list>
            <crowd_list>
                <crowd_ref_vo>
                    <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>
                            <price_dimension>OPTION</price_dimension>
                            <option_group_list>
                                <option_group_vo>
                                    <option_group_name>性别</option_group_name>
                                    <option_list>
                                        <option_vo>
                                            <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_vo>
                                    </option_list>
                                </option_group_vo>
                            </option_group_list>
                            <option_list>
                                <option_vo>
                                    <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_vo>
                            </option_list>
                            <is_multi>true</is_multi>
                            <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>
                    </crowd>
                    <price>
                        <min_fit_bid_price>0.49</min_fit_bid_price>
                        <max_fit_bid_price>0.73</max_fit_bid_price>
                        <fit_discount>0.61</fit_discount>
                        <average_bid_price>0.34</average_bid_price>
                        <validate_bid_min>0.05</validate_bid_min>
                        <validate_bid_max>99.99</validate_bid_max>
                    </price>
                </crowd_ref_vo>
            </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>
    </result>
</universalbp_algo_getbidsuggestion_response>

{
    "universalbp_algo_getbidsuggestion_response":{
        "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":"null",
                "validate_bid_min":"0.10",
                "validate_bid_max":"10.00",
                "adzone_suggest_discount_list":{
                    "adzone_suggest_discount_vo":[
                        {
                            "adzone_id":111287850197,
                            "suggest_discount":35
                        }
                    ]
                },
                "adzone_list":{
                    "adzone_ref_vo":[
                        {
                            "adzone_id":111287850198,
                            "adzone_name":"全屏微详情",
                            "campaign_id":68796878069,
                            "campaign_name":"管家计划_宝贝候选集",
                            "bid_type":"max_amount",
                            "discount":0,
                            "fit_discount":0,
                            "status":"start"
                        }
                    ]
                },
                "crowd_list":{
                    "crowd_ref_vo":[
                        {
                            "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",
                                    "price_dimension":"OPTION",
                                    "option_group_list":{
                                        "option_group_vo":[
                                            {
                                                "option_group_name":"性别",
                                                "option_list":{
                                                    "option_vo":[
                                                        {
                                                            "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_vo":[
                                            {
                                                "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"
                                                }
                                            }
                                        ]
                                    },
                                    "is_multi":true,
                                    "label_option_properties":{
                                        "dmp_option_group_id":"1001",
                                        "cate_name":"714616513841",
                                        "cate_id":"714616513841"
                                    }
                                }
                            },
                            "price":{
                                "min_fit_bid_price":"0.49",
                                "max_fit_bid_price":"0.73",
                                "fit_discount":"0.61",
                                "average_bid_price":"0.34",
                                "validate_bid_min":"0.05",
                                "validate_bid_max":"99.99"
                            }
                        }
                    ]
                },
                "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.algo.getbidsuggestion (获取出价建议)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ