获取出价建议
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| top_service_context | TopServiceContext | 必须 | topServiceContext | ||
|
|||||
| algo_query_v_o | AlgoQueryVO | 必须 | algoQueryVO | ||
|
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| top_result | TopResult | topResult | |
|
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.setCampaignId(68799007001L);
obj3.setPromotionModel("display");
obj3.setPromotionScene("promotion_scene_crowd");
obj3.setSimilarItemStrategy("new_ad_similar");
obj3.setPromotionGoals("shop_crowd");
obj3.setOptimizeTarget("shop_visit_new");
obj3.setDmcType("normal");
obj3.setDayBudget(60L);
obj3.setReapAllBudget(60L);
obj3.setOldBudget(500L);
obj3.setTotalBudget(350L);
obj3.setDayAverageBudget(50L);
obj3.setBudgetPeriod(1L);
obj3.setBidType("roi_control");
obj3.setConstraintType("roi");
obj3.setConstraintValue("3");
obj3.setOldConstraintValue("2.5");
obj3.setPromotionType("item");
obj3.setItemSelectedMode("user_define");
obj3.setItemRecStrategy(""effect_gmv","effect_coll"");
obj3.setIsQuickLift(true);
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignQuickLiftCommandVO obj4 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignQuickLiftCommandVO();
obj4.setQuickLiftSwitch(true);
obj4.setQuickLiftBudget("50");
obj4.setQuickLiftTimeSlot("0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23");
obj4.setQuickLiftLaunchAreaList("all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域");
obj4.setQuickLiftBudgetVersion("1");
obj3.setQuickLiftBudgetCommand(obj4);
List<UniversalbpNewAlgoGetbidsuggestionRequest.AdzoneRefCommandVO> list6 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.AdzoneRefCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.AdzoneRefCommandVO obj7 = new UniversalbpNewAlgoGetbidsuggestionRequest.AdzoneRefCommandVO();
list6.add(obj7);
obj7.setAdzoneId(111287850198L);
obj7.setCampaignId(68796878069L);
obj7.setDiscount(3L);
obj7.setStatus("start");
obj3.setAdzoneList(list6);
List<UniversalbpNewAlgoGetbidsuggestionRequest.CrowdRefCommandVO> list9 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.CrowdRefCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.CrowdRefCommandVO obj10 = new UniversalbpNewAlgoGetbidsuggestionRequest.CrowdRefCommandVO();
list9.add(obj10);
obj10.setCampaignId(68799007001L);
obj10.setAdgroupId(68796878061L);
obj10.setCrowdId(5526396502L);
obj10.setOnlineStatus(1L);
UniversalbpNewAlgoGetbidsuggestionRequest.CrowdCommandVO obj12 = new UniversalbpNewAlgoGetbidsuggestionRequest.CrowdCommandVO();
obj12.setCrowdId(5526396502L);
obj12.setCrowdName("目标人群扩展");
obj12.setCrowdValue("2191820003");
obj12.setTargetType(130L);
UniversalbpNewAlgoGetbidsuggestionRequest.LabelCommandVO obj13 = new UniversalbpNewAlgoGetbidsuggestionRequest.LabelCommandVO();
obj13.setTargetType(131L);
obj13.setLabelId(3000494L);
obj13.setLabelName("关键词");
obj13.setLabelDesc("关键词");
obj13.setLabelValue("2000112");
List<UniversalbpNewAlgoGetbidsuggestionRequest.OptionCommandVO> list15 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.OptionCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.OptionCommandVO obj16 = new UniversalbpNewAlgoGetbidsuggestionRequest.OptionCommandVO();
list15.add(obj16);
obj16.setOptionName("人群特征继承");
obj16.setOptionValue("2000123");
obj16.setTagId(100000L);
obj16.setProperties("");
UniversalbpNewAlgoGetbidsuggestionRequest.LabelOptionProperties obj18 = new UniversalbpNewAlgoGetbidsuggestionRequest.LabelOptionProperties();
obj18.setDmpOptionGroupId("1001");
obj18.setCateName("714616513841");
obj18.setCateId("714616513841");
list17.setLabelOptionProperties(obj18);
obj16.setSubValueList("183");
obj13.setOptionList(list15);
obj13.setProperties("");
UniversalbpNewAlgoGetbidsuggestionRequest.LabelOptionProperties obj19 = new UniversalbpNewAlgoGetbidsuggestionRequest.LabelOptionProperties();
obj19.setDmpOptionGroupId("1001");
obj19.setCateName("714616513841");
obj19.setCateId("714616513841");
obj13.setLabelOptionProperties(obj19);
obj13.setTargetValue(11111L);
obj13.setIsMulti(true);
obj12.setLabel(obj13);
obj12.setLookalikeMultiple("1");
List<UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedCrowdRefCommandVO> list21 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedCrowdRefCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedCrowdRefCommandVO obj22 = new UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedCrowdRefCommandVO();
list21.add(obj22);
UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedCrowdCommandVO obj24 = new UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedCrowdCommandVO();
obj24.setCrowdId(5536708993L);
obj24.setCrowdName("喜欢店铺新品的访客");
UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedLabelCommandVO obj25 = new UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedLabelCommandVO();
obj25.setLabelId(3000494L);
obj25.setLabelName("关键词");
List<UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedOptionCommandVO> list27 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedOptionCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedOptionCommandVO obj28 = new UniversalbpNewAlgoGetbidsuggestionRequest.ExtendSeedOptionCommandVO();
list27.add(obj28);
obj28.setOptionName("人群特征继承");
obj28.setOptionValue("2000123");
obj28.setTagId(100000L);
obj28.setProperties("");
obj25.setOptionList(list27);
obj24.setLabel(obj25);
list23.setCrowd(obj24);
obj12.setExtendSeedCrowdList(list21);
list11.setCrowd(obj12);
UniversalbpNewAlgoGetbidsuggestionRequest.PriceCommandVO obj30 = new UniversalbpNewAlgoGetbidsuggestionRequest.PriceCommandVO();
obj30.setBidPrice("30");
obj30.setDiscount("30");
list29.setPrice(obj30);
obj3.setCrowdList(list9);
List<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO> list32 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO obj33 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchPeriodCommandVO();
list32.add(obj33);
obj33.setDayOfWeek(1L);
List<UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO> list36 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO obj37 = new UniversalbpNewAlgoGetbidsuggestionRequest.TimeSpanVO();
list36.add(obj37);
obj37.setDiscount(100L);
obj37.setTime("00:00-24:00");
list34.setTimeSpanList(list36);
obj3.setLaunchPeriodList(list32);
obj3.setLaunchAreaStrList(""all"");
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVO obj38 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignLaunchTimeCommandVO();
obj38.setStartTime(StringUtils.parseDateTime("2023-06-09 00:00:00"));
obj38.setEndTime(StringUtils.parseDateTime("2199-02-01 00:00:00"));
obj38.setLaunchForever(true);
obj3.setLaunchTime(obj38);
List<UniversalbpNewAlgoGetbidsuggestionRequest.WordCommandVO> list40 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.WordCommandVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.WordCommandVO obj41 = new UniversalbpNewAlgoGetbidsuggestionRequest.WordCommandVO();
list40.add(obj41);
obj41.setBidwordId(1124844766581L);
obj41.setCampaignId(68796878069L);
obj41.setAdgroupId(68793666608L);
obj41.setWord("鞋原创小众");
obj41.setBidPrice("2.23");
obj41.setSuggestTraceId("xxxxx");
obj41.setOnlineStatus(1L);
obj41.setMatchScope(4L);
obj3.setWordList(list40);
obj3.setSearchUpgradePxb(0L);
obj3.setNeedTargetCrowd(1L);
obj3.setAlgoPredictionExtraInfo("{}");
obj3.setBidTypeV2("smart_bid");
obj3.setBidTargetV2("conv");
obj3.setSetSingleCostV2(true);
obj3.setPromotionStrategy("xxxxx");
obj3.setMajorizationPPC(false);
obj3.setUserType(10L);
obj3.setIsMultiTarget(true);
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignMultiTargetVO obj42 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignMultiTargetVO();
obj42.setMultiTargetSwitch(1L);
obj42.setMultiTargetSourceType(1L);
List<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignMultiTargetConfigVO> list44 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.CampaignMultiTargetConfigVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.CampaignMultiTargetConfigVO obj45 = new UniversalbpNewAlgoGetbidsuggestionRequest.CampaignMultiTargetConfigVO();
list44.add(obj45);
obj45.setOptimizeTarget("1034");
obj45.setMultiTargetBudget("1000");
obj45.setMultiTargetDefinedMaxRate(50L);
obj42.setMultiTargetConfigList(list44);
obj3.setMultiTarget(obj42);
obj2.setCampaign(obj3);
List<UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO> list47 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO obj48 = new UniversalbpNewAlgoGetbidsuggestionRequest.AlgoAdgroupQueryVO();
list47.add(obj48);
UniversalbpNewAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVO obj50 = new UniversalbpNewAlgoGetbidsuggestionRequest.AdgroupMaterialCommandVO();
obj50.setMaterialId(714616513841L);
obj50.setMaterialName("yiliantest测试请不要拍22");
obj50.setPromotionType("item");
obj50.setSubPromotionType("item");
obj50.setLinkUrl("http://shop191070507.taobao.com/index.htm");
List<UniversalbpNewAlgoGetbidsuggestionRequest.ItemLifeCycleViewVO> list52 = new ArrayList<UniversalbpNewAlgoGetbidsuggestionRequest.ItemLifeCycleViewVO>();
UniversalbpNewAlgoGetbidsuggestionRequest.ItemLifeCycleViewVO obj53 = new UniversalbpNewAlgoGetbidsuggestionRequest.ItemLifeCycleViewVO();
list52.add(obj53);
obj53.setLifeCycleDesc("新品打爆期");
obj53.setColor("#36A2FC");
obj53.setTips("近30日GMV排名在叶子类目5%以内的新品");
obj53.setType(1L);
obj50.setGoalLifeCycleList(list52);
list49.setMaterial(obj50);
obj2.setAdgroupList(list47);
obj2.setEffectTypeList(""gmv"");
obj2.setDmcTypeElement("dayBudget");
req.setAlgoQueryVO(obj2);
UniversalbpNewAlgoGetbidsuggestionResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
<universalbp_new_algo_getbidsuggestion_response>
<top_result>
<info>
<ok>true</ok>
<message>参数错误</message>
<error_code>xxxxx</error_code>
</info>
<bid_suggest_v_o>
<campaign_id>68796878069</campaign_id>
<bid_min>4.17</bid_min>
<bid_max>16.66</bid_max>
<bid_left>6.66</bid_left>
<bid_middle>8.33</bid_middle>
<bid_right>9.66</bid_right>
<validate_bid_min>0.10</validate_bid_min>
<validate_bid_max>10.00</validate_bid_max>
<adzone_suggest_discount_list>
<adzone_suggest_discount_v_o>
<adzone_id>111287850197</adzone_id>
<suggest_discount>35</suggest_discount>
</adzone_suggest_discount_v_o>
</adzone_suggest_discount_list>
<adzone_list>
<adzone_ref_v_o>
<adzone_id>111287850198</adzone_id>
<adzone_name>全屏微详情</adzone_name>
<min_discount>1</min_discount>
<max_discount>30</max_discount>
<campaign_id>68796878069</campaign_id>
<campaign_name>管家计划_宝贝候选集</campaign_name>
<bid_type>max_amount</bid_type>
<discount>0</discount>
<fit_discount>0</fit_discount>
<status>start</status>
<operation_list>
<operation_v_o>
<code>12</code>
<name>操作</name>
<tips>xxxx</tips>
<disabled>false</disabled>
</operation_v_o>
</operation_list>
</adzone_ref_v_o>
</adzone_list>
<crowd_suggest_price_list>
<crowd_suggest_price_v_o>
<target_type>100</target_type>
<option_value>31536383</option_value>
<price_upper>0.71</price_upper>
<price_lower>0.48</price_lower>
<price_middle>0.60</price_middle>
</crowd_suggest_price_v_o>
</crowd_suggest_price_list>
<crowd_list>
<crowd_ref_v_o>
<campaign_id>68799007001</campaign_id>
<adgroup_id>68796878061</adgroup_id>
<crowd_id>5526396502</crowd_id>
<online_status>1</online_status>
<crowd>
<crowd_id>5526396502</crowd_id>
<crowd_name>目标人群扩展</crowd_name>
<crowd_value>2191820003</crowd_value>
<target_type>130</target_type>
<label>
<target_type>131</target_type>
<label_id>3000494</label_id>
<label_name>关键词</label_name>
<label_desc>关键词</label_desc>
<label_value>2000112</label_value>
<label_group_name>人群</label_group_name>
<price_dimension>OPTION</price_dimension>
<price>
<bid_price>1.16</bid_price>
<fit_bid_price>0.70</fit_bid_price>
<average_bid_price>0.47</average_bid_price>
<min_fit_bid_price>0.56</min_fit_bid_price>
<max_fit_bid_price>0.84</max_fit_bid_price>
<validate_bid_min>0.05</validate_bid_min>
<validate_bid_max>99.99</validate_bid_max>
<discount>30</discount>
<fit_discount>30</fit_discount>
<peer_avg_price>0.56</peer_avg_price>
</price>
<option_group_list>
<option_group_v_o>
<option_group_name>性别</option_group_name>
<option_list>
<option_v_o>
<option_name>人群特征继承</option_name>
<option_value>2000123</option_value>
<option_desc>该定向人群将继承原始计划已触达的消费者特征,缩短算法搜寻合适人群的冷启动周期,建议您同时开启【智能拓展】功能,提升投放效果。</option_desc>
<tag_id>100000</tag_id>
<option_group_name>性别</option_group_name>
<label_option_properties>
<dmp_option_group_id>1001</dmp_option_group_id>
<cate_name>714616513841</cate_name>
<cate_id>714616513841</cate_id>
</label_option_properties>
<sub_value_list>
<string>[183]</string>
</sub_value_list>
</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>
<sub_value_list>
<string>[183]</string>
</sub_value_list>
</option_v_o>
</option_list>
<is_multi>true</is_multi>
<category_id>3221312321</category_id>
<category_name>服装</category_name>
<label_option_properties>
<dmp_option_group_id>1001</dmp_option_group_id>
<cate_name>714616513841</cate_name>
<cate_id>714616513841</cate_id>
</label_option_properties>
</label>
<lookalike_multiple>1</lookalike_multiple>
<extend_seed_crowd_list>
<extend_seed_crowd_ref_v_o>
<crowd>
<crowd_id>5536708993</crowd_id>
<crowd_name>喜欢店铺新品的访客</crowd_name>
<label>
<target_type>131</target_type>
<label_id>3000494</label_id>
<label_name>关键词</label_name>
<price_dimension>OPTION</price_dimension>
<is_multi>true</is_multi>
<option_list>
<extend_seed_option_v_o>
<option_name>人群特征继承</option_name>
<option_value>2000123</option_value>
<tag_id>100000</tag_id>
</extend_seed_option_v_o>
</option_list>
</label>
</crowd>
</extend_seed_crowd_ref_v_o>
</extend_seed_crowd_list>
<sub_crowd_list>
<sub_crowd_v_o>
<subcrowd_name>目标人群扩展</subcrowd_name>
<subcrowd_value>2191820003</subcrowd_value>
</sub_crowd_v_o>
</sub_crowd_list>
</crowd>
<price>
<bid_price>1.16</bid_price>
<fit_bid_price>0.70</fit_bid_price>
<average_bid_price>0.47</average_bid_price>
<min_fit_bid_price>0.56</min_fit_bid_price>
<max_fit_bid_price>0.84</max_fit_bid_price>
<validate_bid_min>0.05</validate_bid_min>
<validate_bid_max>99.99</validate_bid_max>
<discount>30</discount>
<fit_discount>30</fit_discount>
<peer_avg_price>0.56</peer_avg_price>
</price>
</crowd_ref_v_o>
</crowd_list>
<bid_middle_effect>
<pv>1621</pv>
<pv_low>1297</pv_low>
<pv_high>1945</pv_high>
<click>97</click>
<click_low>78</click_low>
<click_high>117</click_high>
<conv>13</conv>
<conv_low>10</conv_low>
<conv_high>15</conv_high>
<wconv>27</wconv>
<wconv_low>22</wconv_low>
<wconv_high>33</wconv_high>
<mem>0</mem>
<mem_low>0</mem_low>
<mem_high>1</mem_high>
<cost>823.83</cost>
<cost_low>659.06</cost_low>
<cost_high>988.60</cost_high>
<cart>10</cart>
<cart_low>5</cart_low>
<cart_high>15</cart_high>
<uv_aim_low>5</uv_aim_low>
<uv_aim_high>15</uv_aim_high>
<gmv>6845.21</gmv>
<gmv_net>6845.21</gmv_net>
<gmv_low>5476.17</gmv_low>
<gmv_high>8214.26</gmv_high>
<gmv_low_net>5476.17</gmv_low_net>
<gmv_high_net>8214.26</gmv_high_net>
<min_gmv>5476.17</min_gmv>
<max_gmv>8214.26</max_gmv>
<success_ratio_high>0.9</success_ratio_high>
<success_ratio_low>0.8</success_ratio_low>
<gmv_diff_percent>0.67</gmv_diff_percent>
<effect_predict_reason>预计曝光量<span number=\"highlight\">+20%</span>,自然流量助推<span number=\"error\">+10%</span></effect_predict_reason>
<reason>预计可获得点击量2次</reason>
</bid_middle_effect>
<bid_rec_reason>商品昨日搜索点击量低于2,同行同层平均目标投产比为5.84,建议投产比设置不超过10.31,获取更多点击。大促期建议考虑确收因素,设置更合理的ROI。</bid_rec_reason>
<bid_info_list>
<bid_info_v_o>
<value>1.92</value>
<tag>性价比推荐</tag>
<is_default>false</is_default>
<tag_mode>AI小万</tag_mode>
<reason>采纳后预计可获得点击量提出7%</reason>
</bid_info_v_o>
</bid_info_list>
</bid_suggest_v_o>
</top_result>
</universalbp_new_algo_getbidsuggestion_response>
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>
| 错误码 | 错误描述 | 解决方案 |
|---|