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

taobao.universalbp.new.campaign.onebpsearch.batchupdate (批量更新计划出价)

对已经存在的计划,更新出价(关键词场景,使用前请咨询)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
campaign_bid_list_v_o CampaignBidListVO 必须 campaignBidListVO
  • bid_list
  • CampaignBidCommandVO []
  • 必须
  • 计划出价更新集合
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填
  • └ bid_type
  • String
  • 可选
  • max_amount
  • 出价方式,custom_bid:手动出价,max_amount:最大化拿量,pe:控成本,roi_control:控投产比
  • └ cold_boot
  • Number
  • 可选
  • 1
  • 冷启动标识,0:否,1:是
  • └ optimize_target
  • String
  • 可选
  • conv
  • 优化目标,conv:促进成交,coll_cart:促进加购,click:促进点击,deal_count:促进成交笔数,exposure_pv:促进曝光,mini_view:促进橱窗宝贝浏览个数,mini_interactive:促进橱窗宝贝互动,ad_strategy_wangwang:策略中心旺旺咨询,shop_potential:提升潜客人数,shop_interest_new:提升兴趣新客人数,shop_purchase_new:提升首购新客人数,shop_visit_new:提升访问新客人数,shop_repurchase:提升复购人数,high_cvr:提升高转换人群成交人数,deeplink_d:提升品牌发现人数-D,deeplink_e1:提升品牌种草人数-E,deeplink_e2:提升品牌互动人数-E,deeplink_p:提升品牌行动人数-P,deeplink_i:提升品牌首购人数-I,deeplink_n:提升品牌复购人数-N,deeplink_k:提升品牌挚爱人数-K,hf_grass_plant:预热种草,hf_impoundment:预售蓄水,hf_harvest:爆发收割,nd_click:提高互动量,nd_cart:提高加购量,nd_deal:提高成交量,ad_strategy_ruhui_count:策略中心入会快新会员场景入会量目标,ad_strategy_lzl:策略中心留资快留资量目标,ad_strategy_try:策略中心派样量,ad_strategy_view:策略中心优化展现,ad_strategy_auto_trans:策略中心自动流转,ad_strategy_trial_order:策略中心表单获客成本,ad_strategy_liuzi_cost:策略中心广义留资目标,ad_strategy_cool_start:策略中心自动冷启动,ad_strategy_cool_start_mini_aim:策略中心冷启动分阶段目标流转,wxt_agency_ai:A转I人群流转,wxt_agency_smart:自定义场景,form_submit:表单提交,trial_order:试用下单,wangwang_liuzi:旺旺留资
  • └ constraint_type
  • String
  • 可选
  • 元/次点击
  • 出价约束类型,non:无约束,click:点击成本,coll_cart:收藏加购成本(非场景推广),cart:收藏加购成本(场景推广),conv:成交成本(非场景推广),deal:成交成本(场景推广),dir_conv:直接成交成本,roi:投产比约束
  • └ constraint_value
  • String
  • 可选
  • 3
  • 出价约束值
  • campaign_ocpc
  • CampaignOcpcCommandVO
  • 可选
  • ocpc出价
  • └ enable_ocpc
  • Boolean
  • 可选
  • true
  • OCPC是否开启智能调价,true:是,false:否
  • └ ocpc_ratio
  • Number
  • 可选
  • 200
  • OCPC溢价比例
  • crowd_list
  • CrowdRefCommandVO []
  • 可选
  • 人群推广-手动出价-人群出价列表
  • └ campaign_id
  • Number
  • 可选
  • 68799007001
  • 计划id,计划已经存在场景必填
  • └ adgroup_id
  • Number
  • 可选
  • 68796878061
  • 单元id,单元已经存在场景必填
  • └ crowd_id
  • Number
  • 可选
  • 5526396502
  • 人群主键id,人群已经存在场景必填
  • └ online_status
  • Number
  • 可选
  • 1
  • 定向状态,0:下线 1:上线
  • crowd
  • CrowdCommandVO
  • 可选
  • 人群
  • └ crowd_id
  • Number
  • 可选
  • 5526396502
  • 人群主键id,人群已经存在场景必填
  • └ crowd_name
  • String
  • 可选
  • 目标人群扩展
  • 人群名称
  • └ crowd_value
  • String
  • 可选
  • 2191820003
  • 人群值
  • └ target_type
  • Number
  • 可选
  • 130
  • 定向类型
  • label
  • LabelCommandVO
  • 可选
  • 定向标签
  • └ target_type
  • Number
  • 可选
  • 131
  • 定向标签类型
  • └ label_id
  • Number
  • 可选
  • 3000494
  • 定向标签id
  • └ label_name
  • String
  • 可选
  • 关键词
  • 定向标签名称
  • └ label_desc
  • String
  • 可选
  • 关键词
  • 定向标签描述
  • └ label_value
  • String
  • 可选
  • 2000112
  • 定向标签值
  • option_list
  • OptionCommandVO []
  • 可选
  • 标签选项
  • └ option_name
  • String
  • 可选
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 可选
  • 2000123
  • 选项值
  • └ tag_id
  • Number
  • 可选
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • label_option_properties
  • LabelOptionProperties
  • 可选
  • 透传属性
  • └ dmp_option_group_id
  • String
  • 可选
  • 1001
  • dmp选项分组id
  • └ cate_name
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ cate_id
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ sub_value_list
  • String []
  • 可选
  • [183]
  • 关键词(综合关键词、竞争航线)子人群值
  • label_option_properties
  • LabelOptionProperties
  • 可选
  • 透传属性
  • └ dmp_option_group_id
  • String
  • 可选
  • 1001
  • dmp选项分组id
  • └ cate_name
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ cate_id
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ target_value
  • Number
  • 可选
  • 11111
  • 父人群id
  • └ lookalike_multiple
  • String
  • 可选
  • 1
  • 扩展倍数。低中高对应不同的倍数,由产品定义具体值,未来业务可支持滑动条。注意:倍数是指最终人数/种子人数,比如种子人群100万,扩展比种子多了50万,也就是总共150万,这时候扩展倍数是1.5而不是0.5
  • extend_seed_crowd_list
  • ExtendSeedCrowdRefCommandVO []
  • 可选
  • 种子人群关联信息
  • crowd
  • ExtendSeedCrowdCommandVO
  • 可选
  • 人群扩展种子人群 扩展种子人群的结构和实体是一致的,为了和前端交互更清晰,知道哪些参数需要传,所以定义一下种子人群的VO
  • 种子人群信息
  • └ crowd_id
  • Number
  • 可选
  • 5536708993
  • 人群主键id
  • └ crowd_name
  • String
  • 可选
  • 喜欢店铺新品的访客
  • 人群名称
  • label
  • ExtendSeedLabelCommandVO
  • 可选
  • 扩展人群种子人群Label结构
  • 种子人群label信息
  • └ label_id
  • Number
  • 可选
  • 3000494
  • 定向标签id
  • └ label_name
  • String
  • 可选
  • 关键词
  • 定向标签名称
  • option_list
  • ExtendSeedOptionCommandVO []
  • 可选
  • 选项值信息
  • └ option_name
  • String
  • 可选
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 可选
  • 2000123
  • 选项值
  • └ tag_id
  • Number
  • 可选
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • price
  • PriceCommandVO
  • 可选
  • 出价
  • └ bid_price
  • String
  • 可选
  • 30
  • 出价
  • └ discount
  • String
  • 可选
  • 30
  • 溢价
  • adzone_list
  • AdzoneRefCommandVO []
  • 可选
  • 人群推广-手动出价-资源位溢价列表
  • └ adzone_id
  • Number
  • 可选
  • 111287850198
  • 资源包id
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • └ discount
  • Number
  • 可选
  • 3
  • 资源位/包 溢价
  • └ status
  • String
  • 可选
  • start
  • 状态,start:投放,pause:暂停
  • └ crowd_discount
  • Number
  • 可选
  • 30
  • 关键词推广-手动出价-人群统一溢价
  • └ word_price
  • String
  • 可选
  • 30
  • 关键词推广-手动出价-关键词统一出价 (元)
  • └ bid_type_v2
  • String
  • 可选
  • smart_bid
  • 智能出价升级,出价类型
  • └ bid_target_v2
  • String
  • 可选
  • conv
  • 出价目标
  • └ set_single_cost_v2
  • Boolean
  • 可选
  • true
  • 是否设置单次成本

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • campaign_bid_update_result_v_o_top_part_data
  • TopPartData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • campaign_bid_update_result_v_o_list
  • CampaignBidUpdateResultVO []
  • 批量成功结果集
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • └ error_count
  • Number
  • 10
  • 失败数量
  • error_details
  • TopFailResult []
  • 失败结果集
  • └ code
  • String
  • xxxxx
  • 业务失败编码
  • └ msg
  • String
  • xxxxx
  • 业务失败原因
  • result
  • CampaignBidUpdateResultVO
  • 错误信息
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest req = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.TopServiceContext obj1 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignBidListVO obj2 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignBidListVO();
List<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignBidCommandVO> list4 = new ArrayList<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignBidCommandVO>();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignBidCommandVO obj5 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignBidCommandVO();
list4.add(obj5);
obj5.setCampaignId(68796878069L);
obj5.setBidType("max_amount");
obj5.setColdBoot(1L);
obj5.setOptimizeTarget("conv");
obj5.setConstraintType("元/次点击");
obj5.setConstraintValue("3");
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignOcpcCommandVO obj7 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CampaignOcpcCommandVO();
obj7.setEnableOcpc(true);
obj7.setOcpcRatio(200L);
list6.setCampaignOcpc(obj7);
List<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CrowdRefCommandVO> list10 = new ArrayList<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CrowdRefCommandVO>();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CrowdRefCommandVO obj11 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CrowdRefCommandVO();
list10.add(obj11);
obj11.setCampaignId(68799007001L);
obj11.setAdgroupId(68796878061L);
obj11.setCrowdId(5526396502L);
obj11.setOnlineStatus(1L);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CrowdCommandVO obj13 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.CrowdCommandVO();
obj13.setCrowdId(5526396502L);
obj13.setCrowdName("目标人群扩展");
obj13.setCrowdValue("2191820003");
obj13.setTargetType(130L);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.LabelCommandVO obj14 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.LabelCommandVO();
obj14.setTargetType(131L);
obj14.setLabelId(3000494L);
obj14.setLabelName("关键词");
obj14.setLabelDesc("关键词");
obj14.setLabelValue("2000112");
List<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.OptionCommandVO> list16 = new ArrayList<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.OptionCommandVO>();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.OptionCommandVO obj17 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.OptionCommandVO();
list16.add(obj17);
obj17.setOptionName("人群特征继承");
obj17.setOptionValue("2000123");
obj17.setTagId(100000L);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.LabelOptionProperties obj19 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.LabelOptionProperties();
obj19.setDmpOptionGroupId("1001");
obj19.setCateName("714616513841");
obj19.setCateId("714616513841");
list18.setLabelOptionProperties(obj19);
obj17.setSubValueList("183");
obj14.setOptionList(list16);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.LabelOptionProperties obj20 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.LabelOptionProperties();
obj20.setDmpOptionGroupId("1001");
obj20.setCateName("714616513841");
obj20.setCateId("714616513841");
obj14.setLabelOptionProperties(obj20);
obj14.setTargetValue(11111L);
obj13.setLabel(obj14);
obj13.setLookalikeMultiple("1");
List<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedCrowdRefCommandVO> list22 = new ArrayList<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedCrowdRefCommandVO>();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedCrowdRefCommandVO obj23 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedCrowdRefCommandVO();
list22.add(obj23);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedCrowdCommandVO obj25 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedCrowdCommandVO();
obj25.setCrowdId(5536708993L);
obj25.setCrowdName("喜欢店铺新品的访客");
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedLabelCommandVO obj26 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedLabelCommandVO();
obj26.setLabelId(3000494L);
obj26.setLabelName("关键词");
List<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedOptionCommandVO> list28 = new ArrayList<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedOptionCommandVO>();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedOptionCommandVO obj29 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.ExtendSeedOptionCommandVO();
list28.add(obj29);
obj29.setOptionName("人群特征继承");
obj29.setOptionValue("2000123");
obj29.setTagId(100000L);
obj26.setOptionList(list28);
obj25.setLabel(obj26);
list24.setCrowd(obj25);
obj13.setExtendSeedCrowdList(list22);
list12.setCrowd(obj13);
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.PriceCommandVO obj31 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.PriceCommandVO();
obj31.setBidPrice("30");
obj31.setDiscount("30");
list30.setPrice(obj31);
list8.setCrowdList(list10);
List<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.AdzoneRefCommandVO> list34 = new ArrayList<UniversalbpNewCampaignOnebpsearchBatchupdateRequest.AdzoneRefCommandVO>();
UniversalbpNewCampaignOnebpsearchBatchupdateRequest.AdzoneRefCommandVO obj35 = new UniversalbpNewCampaignOnebpsearchBatchupdateRequest.AdzoneRefCommandVO();
list34.add(obj35);
obj35.setAdzoneId(111287850198L);
obj35.setCampaignId(68796878069L);
obj35.setDiscount(3L);
obj35.setStatus("start");
list32.setAdzoneList(list34);
obj5.setCrowdDiscount(30L);
obj5.setWordPrice("30");
obj5.setBidTypeV2("smart_bid");
obj5.setBidTargetV2("conv");
obj5.setSetSingleCostV2(true);
obj2.setBidList(list4);
req.setCampaignBidListVO(obj2);
UniversalbpNewCampaignOnebpsearchBatchupdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_campaign_onebpsearch_batchupdate_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <campaign_bid_update_result_v_o_top_part_data>
            <count>10</count>
            <campaign_bid_update_result_v_o_list>
                <campaign_bid_update_result_v_o>
                    <campaign_id>68796878069</campaign_id>
                </campaign_bid_update_result_v_o>
            </campaign_bid_update_result_v_o_list>
            <error_count>10</error_count>
            <error_details>
                <top_fail_result>
                    <code>xxxxx</code>
                    <msg>xxxxx</msg>
                    <result>
                        <campaign_id>68796878069</campaign_id>
                    </result>
                </top_fail_result>
            </error_details>
        </campaign_bid_update_result_v_o_top_part_data>
    </top_result>
</universalbp_new_campaign_onebpsearch_batchupdate_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

返回
顶部