批量获取出价建议
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| top_service_context | TopServiceContext | 必须 | topServiceContext | ||
|
|||||
| algo_query_list_v_o | AlgoQueryListVO | 必须 | algoQueryListVO | ||
|
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| top_result | TopResult | topResult | |
|
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewAlgoGetbatchbidsuggestionRequest req = new UniversalbpNewAlgoGetbatchbidsuggestionRequest();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.TopServiceContext obj1 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryListVO obj2 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryListVO();
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO> list4 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO obj5 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoQueryVO();
list4.add(obj5);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoCampaignQueryVO obj7 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoCampaignQueryVO();
obj7.setCampaignId(68799007001L);
obj7.setPromotionModel("display");
obj7.setPromotionScene("promotion_scene_crowd");
obj7.setSimilarItemStrategy("new_ad_similar");
obj7.setPromotionGoals("shop_crowd");
obj7.setOptimizeTarget("shop_visit_new");
obj7.setDmcType("normal");
obj7.setDayBudget(60L);
obj7.setReapAllBudget(60L);
obj7.setOldBudget(500L);
obj7.setTotalBudget(350L);
obj7.setDayAverageBudget(50L);
obj7.setBudgetPeriod(1L);
obj7.setBidType("roi_control");
obj7.setConstraintType("roi");
obj7.setConstraintValue("3");
obj7.setOldConstraintValue("2.5");
obj7.setPromotionType("item");
obj7.setItemSelectedMode("user_define");
obj7.setItemRecStrategy(""effect_gmv","effect_coll"");
obj7.setIsQuickLift(true);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignQuickLiftCommandVO obj8 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignQuickLiftCommandVO();
obj8.setQuickLiftSwitch(true);
obj8.setQuickLiftBudget("50");
obj8.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");
obj8.setQuickLiftLaunchAreaList("all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域");
obj8.setQuickLiftBudgetVersion("1");
obj7.setQuickLiftBudgetCommand(obj8);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO> list10 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO obj11 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdzoneRefCommandVO();
list10.add(obj11);
obj11.setAdzoneId(111287850198L);
obj11.setCampaignId(68796878069L);
obj11.setDiscount(3L);
obj11.setStatus("start");
obj7.setAdzoneList(list10);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CrowdRefCommandVO> list13 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CrowdRefCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CrowdRefCommandVO obj14 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CrowdRefCommandVO();
list13.add(obj14);
obj14.setCampaignId(68799007001L);
obj14.setAdgroupId(68796878061L);
obj14.setCrowdId(5526396502L);
obj14.setOnlineStatus(1L);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CrowdCommandVO obj16 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CrowdCommandVO();
obj16.setCrowdId(5526396502L);
obj16.setCrowdName("目标人群扩展");
obj16.setCrowdValue("2191820003");
obj16.setTargetType(130L);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.LabelCommandVO obj17 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.LabelCommandVO();
obj17.setTargetType(131L);
obj17.setLabelId(3000494L);
obj17.setLabelName("关键词");
obj17.setLabelDesc("关键词");
obj17.setLabelValue("2000112");
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.OptionCommandVO> list19 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.OptionCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.OptionCommandVO obj20 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.OptionCommandVO();
list19.add(obj20);
obj20.setOptionName("人群特征继承");
obj20.setOptionValue("2000123");
obj20.setTagId(100000L);
obj20.setProperties("");
UniversalbpNewAlgoGetbatchbidsuggestionRequest.LabelOptionProperties obj22 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.LabelOptionProperties();
obj22.setDmpOptionGroupId("1001");
obj22.setCateName("714616513841");
obj22.setCateId("714616513841");
list21.setLabelOptionProperties(obj22);
obj20.setSubValueList("183");
obj17.setOptionList(list19);
obj17.setProperties("");
UniversalbpNewAlgoGetbatchbidsuggestionRequest.LabelOptionProperties obj23 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.LabelOptionProperties();
obj23.setDmpOptionGroupId("1001");
obj23.setCateName("714616513841");
obj23.setCateId("714616513841");
obj17.setLabelOptionProperties(obj23);
obj17.setTargetValue(11111L);
obj17.setIsMulti(true);
obj16.setLabel(obj17);
obj16.setLookalikeMultiple("1");
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedCrowdRefCommandVO> list25 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedCrowdRefCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedCrowdRefCommandVO obj26 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedCrowdRefCommandVO();
list25.add(obj26);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedCrowdCommandVO obj28 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedCrowdCommandVO();
obj28.setCrowdId(5536708993L);
obj28.setCrowdName("喜欢店铺新品的访客");
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedLabelCommandVO obj29 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedLabelCommandVO();
obj29.setLabelId(3000494L);
obj29.setLabelName("关键词");
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedOptionCommandVO> list31 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedOptionCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedOptionCommandVO obj32 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ExtendSeedOptionCommandVO();
list31.add(obj32);
obj32.setOptionName("人群特征继承");
obj32.setOptionValue("2000123");
obj32.setTagId(100000L);
obj32.setProperties("");
obj29.setOptionList(list31);
obj28.setLabel(obj29);
list27.setCrowd(obj28);
obj16.setExtendSeedCrowdList(list25);
list15.setCrowd(obj16);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.PriceCommandVO obj34 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.PriceCommandVO();
obj34.setBidPrice("30");
obj34.setDiscount("30");
list33.setPrice(obj34);
obj7.setCrowdList(list13);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO> list36 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO obj37 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchPeriodCommandVO();
list36.add(obj37);
obj37.setDayOfWeek(1L);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO> list40 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO obj41 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.TimeSpanVO();
list40.add(obj41);
obj41.setDiscount(100L);
obj41.setTime("00:00-24:00");
list38.setTimeSpanList(list40);
obj7.setLaunchPeriodList(list36);
obj7.setLaunchAreaStrList(""all"");
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchTimeCommandVO obj42 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignLaunchTimeCommandVO();
obj42.setStartTime(StringUtils.parseDateTime("2023-06-09 00:00:00"));
obj42.setEndTime(StringUtils.parseDateTime("2199-02-01 00:00:00"));
obj42.setLaunchForever(true);
obj7.setLaunchTime(obj42);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO> list44 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO obj45 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.WordCommandVO();
list44.add(obj45);
obj45.setBidwordId(1124844766581L);
obj45.setCampaignId(68796878069L);
obj45.setAdgroupId(68793666608L);
obj45.setWord("鞋原创小众");
obj45.setBidPrice("2.23");
obj45.setSuggestTraceId("xxxxx");
obj45.setOnlineStatus(1L);
obj45.setMatchScope(4L);
obj7.setWordList(list44);
obj7.setSearchUpgradePxb(0L);
obj7.setNeedTargetCrowd(1L);
obj7.setAlgoPredictionExtraInfo("{}");
obj7.setBidTypeV2("smart_bid");
obj7.setBidTargetV2("conv");
obj7.setSetSingleCostV2(true);
obj7.setPromotionStrategy("xxxxx");
obj7.setMajorizationPPC(false);
obj7.setUserType(10L);
obj7.setIsMultiTarget(true);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignMultiTargetVO obj46 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignMultiTargetVO();
obj46.setMultiTargetSwitch(1L);
obj46.setMultiTargetSourceType(1L);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignMultiTargetConfigVO> list48 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignMultiTargetConfigVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignMultiTargetConfigVO obj49 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.CampaignMultiTargetConfigVO();
list48.add(obj49);
obj49.setOptimizeTarget("1034");
obj49.setMultiTargetBudget("1000");
obj49.setMultiTargetDefinedMaxRate(50L);
obj46.setMultiTargetConfigList(list48);
obj7.setMultiTarget(obj46);
list6.setCampaign(obj7);
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO> list52 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO obj53 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AlgoAdgroupQueryVO();
list52.add(obj53);
UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdgroupMaterialCommandVO obj55 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.AdgroupMaterialCommandVO();
obj55.setMaterialId(714616513841L);
obj55.setMaterialName("yiliantest测试请不要拍22");
obj55.setPromotionType("item");
obj55.setSubPromotionType("item");
obj55.setLinkUrl("http://shop191070507.taobao.com/index.htm");
List<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO> list57 = new ArrayList<UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO>();
UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO obj58 = new UniversalbpNewAlgoGetbatchbidsuggestionRequest.ItemLifeCycleViewVO();
list57.add(obj58);
obj58.setLifeCycleDesc("新品打爆期");
obj58.setColor("#36A2FC");
obj58.setTips("近30日GMV排名在叶子类目5%以内的新品");
obj58.setType(1L);
obj55.setGoalLifeCycleList(list57);
list54.setMaterial(obj55);
list50.setAdgroupList(list52);
obj5.setEffectTypeList(""gmv"");
obj5.setDmcTypeElement("dayBudget");
obj2.setAlgoQueryList(list4);
req.setAlgoQueryListVO(obj2);
UniversalbpNewAlgoGetbatchbidsuggestionResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
<universalbp_new_algo_getbatchbidsuggestion_response>
<top_result>
<info>
<ok>true</ok>
<message>参数错误</message>
<error_code>xxxxx</error_code>
</info>
<bid_suggest_v_o_top_part_data>
<count>10</count>
<bid_suggest_v_o_list>
<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>
</bid_suggest_v_o_list>
<error_count>10</error_count>
<error_details>
<top_fail_result>
<code>xxxxx</code>
<msg>xxxxx</msg>
</top_fail_result>
</error_details>
</bid_suggest_v_o_top_part_data>
</top_result>
</universalbp_new_algo_getbatchbidsuggestion_response>
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>
| 错误码 | 错误描述 | 解决方案 |
|---|