文档中心 > API类目 > 万相台无界API

taobao.universalbp.algo.getbudgetsuggestion (预算预估)

预算预估

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
algo_query_v_o AlgoQueryVo 必须 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
  • 出价约束
  • └ 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:否
  • 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
  • 物料地址
  • └ dmc_type_element
  • String
  • 可选
  • dayBudget
  • 组件类型

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • budget_suggest_v_o
  • BudgetSuggestVo
  • 结果集
  • └ budget_left
  • Number
  • 200
  • 预算左值
  • └ budget_middle
  • Number
  • 220
  • 预算中值
  • └ budget_right
  • Number
  • 260
  • 预算右值
  • └ budget_upper
  • Number
  • 260
  • 预算上限(元)
  • └ budget_lower
  • Number
  • 200
  • 预算下限(元)
  • └ algo_budget
  • Number
  • 220
  • 直接销量达成:给出的预算
  • └ reason
  • String
  • 根据同类目投放情况,建议每日预算不低于<span class='font-number bold color-3'>200</span>元
  • 算法建议文案
  • └ budget_default
  • Number
  • 200
  • 默认预算
  • └ budget_min
  • Number
  • 100
  • 默认最低值

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpAlgoGetbudgetsuggestionRequest req = new UniversalbpAlgoGetbudgetsuggestionRequest();
UniversalbpAlgoGetbudgetsuggestionRequest.TopServiceContext obj1 = new UniversalbpAlgoGetbudgetsuggestionRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpAlgoGetbudgetsuggestionRequest.AlgoQueryVo obj2 = new UniversalbpAlgoGetbudgetsuggestionRequest.AlgoQueryVo();
UniversalbpAlgoGetbudgetsuggestionRequest.AlgoCampaignQueryVo obj3 = new UniversalbpAlgoGetbudgetsuggestionRequest.AlgoCampaignQueryVo();
obj3.setCampaignId(68799007001L);
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<UniversalbpAlgoGetbudgetsuggestionRequest.CampaignLaunchPeriodCommandVo> list5 = new ArrayList<UniversalbpAlgoGetbudgetsuggestionRequest.CampaignLaunchPeriodCommandVo>();
UniversalbpAlgoGetbudgetsuggestionRequest.CampaignLaunchPeriodCommandVo obj6 = new UniversalbpAlgoGetbudgetsuggestionRequest.CampaignLaunchPeriodCommandVo();
list5.add(obj6);
obj6.setDayOfWeek(1L);
List<UniversalbpAlgoGetbudgetsuggestionRequest.TimeSpanVo> list9 = new ArrayList<UniversalbpAlgoGetbudgetsuggestionRequest.TimeSpanVo>();
UniversalbpAlgoGetbudgetsuggestionRequest.TimeSpanVo obj10 = new UniversalbpAlgoGetbudgetsuggestionRequest.TimeSpanVo();
list9.add(obj10);
obj10.setDiscount(100L);
obj10.setTime("00:00-24:00");
list7.setTimeSpanList(list9);
obj3.setLaunchPeriodList(list5);
obj3.setLaunchAreaStrList(""all"");
UniversalbpAlgoGetbudgetsuggestionRequest.CampaignLaunchTimeCommandVo obj11 = new UniversalbpAlgoGetbudgetsuggestionRequest.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);
obj2.setCampaign(obj3);
List<UniversalbpAlgoGetbudgetsuggestionRequest.AlgoAdgroupQueryVo> list13 = new ArrayList<UniversalbpAlgoGetbudgetsuggestionRequest.AlgoAdgroupQueryVo>();
UniversalbpAlgoGetbudgetsuggestionRequest.AlgoAdgroupQueryVo obj14 = new UniversalbpAlgoGetbudgetsuggestionRequest.AlgoAdgroupQueryVo();
list13.add(obj14);
UniversalbpAlgoGetbudgetsuggestionRequest.AdgroupMaterialCommandVo obj16 = new UniversalbpAlgoGetbudgetsuggestionRequest.AdgroupMaterialCommandVo();
obj16.setMaterialId(714616513841L);
obj16.setMaterialName("yiliantest测试请不要拍22");
obj16.setPromotionType("item");
obj16.setSubPromotionType("item");
obj16.setLinkUrl("http://shop191070507.taobao.com/index.htm");
list15.setMaterial(obj16);
obj2.setAdgroupList(list13);
obj2.setDmcTypeElement("dayBudget");
req.setAlgoQueryVO(obj2);
UniversalbpAlgoGetbudgetsuggestionResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_algo_getbudgetsuggestion_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <budget_suggest_v_o>
            <budget_left>200</budget_left>
            <budget_middle>220</budget_middle>
            <budget_right>260</budget_right>
            <budget_upper>260</budget_upper>
            <budget_lower>200</budget_lower>
            <algo_budget>220</algo_budget>
            <reason>根据同类目投放情况,建议每日预算不低于&lt;span class=&apos;font-number bold color-3&apos;&gt;200&lt;/span&gt;元</reason>
            <budget_default>200</budget_default>
            <budget_min>100</budget_min>
        </budget_suggest_v_o>
    </result>
</universalbp_algo_getbudgetsuggestion_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部