文档中心 > API类目 > 直通车API

taobao.universalbp.algo.getbidsuggestion (获取出价建议)

获取出价建议

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
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());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
<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>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部