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

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

对已经存在的计划,更新出价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
data_list CampaignBidCommandVo 必须 list
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填
  • └ bid_type
  • String
  • 可选
  • max_amount
  • 出价方式,custom_bid:手动出价,max_amount:最大化拿量,cost_control:控成本,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
  • label_option_properties
  • LabelOptionProperties
  • 可选
  • 透传属性
  • └ dmp_option_group_id
  • String
  • 可选
  • 1001
  • dmp选项分组id
  • └ cate_name
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ cate_id
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ lookalike_multiple
  • String
  • 可选
  • 1
  • 扩展倍数。低中高对应不同的倍数,由产品定义具体值,未来业务可支持滑动条。注意:倍数是指最终人数/种子人数,比如种子人群100万,扩展比种子多了50万,也就是总共150万,这时候扩展倍数是1.5而不是0.5
  • extend_seed_crowd_list
  • ExtendSeedCrowdRefCommandVo []
  • 可选
  • 种子人群关联信息
  • crowd
  • ExtendSeedCrowdCommandVo
  • 可选
  • 种子人群信息
  • └ crowd_id
  • Number
  • 可选
  • 5536708993
  • 人群主键id
  • └ crowd_name
  • String
  • 可选
  • 喜欢店铺新品的访客
  • 人群名称
  • label
  • ExtendSeedLabelCommandVo
  • 可选
  • 种子人群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
  • 关键词推广-手动出价-关键词统一出价 (元)

响应参数

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

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpCampaignBidBatchupdateRequest req = new UniversalbpCampaignBidBatchupdateRequest();
UniversalbpCampaignBidBatchupdateRequest.TopServiceContext obj1 = new UniversalbpCampaignBidBatchupdateRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpCampaignBidBatchupdateRequest.CampaignBidCommandVo obj2 = new UniversalbpCampaignBidBatchupdateRequest.CampaignBidCommandVo();
obj2.setCampaignId(68796878069L);
obj2.setBidType("max_amount");
obj2.setColdBoot(1L);
obj2.setOptimizeTarget("conv");
obj2.setConstraintType("元/次点击");
obj2.setConstraintValue("3");
UniversalbpCampaignBidBatchupdateRequest.CampaignOcpcCommandVo obj3 = new UniversalbpCampaignBidBatchupdateRequest.CampaignOcpcCommandVo();
obj3.setEnableOcpc(true);
obj3.setOcpcRatio(200L);
obj2.setCampaignOcpc(obj3);
List<UniversalbpCampaignBidBatchupdateRequest.CrowdRefCommandVo> list5 = new ArrayList<UniversalbpCampaignBidBatchupdateRequest.CrowdRefCommandVo>();
UniversalbpCampaignBidBatchupdateRequest.CrowdRefCommandVo obj6 = new UniversalbpCampaignBidBatchupdateRequest.CrowdRefCommandVo();
list5.add(obj6);
obj6.setCampaignId(68799007001L);
obj6.setAdgroupId(68796878061L);
obj6.setCrowdId(5526396502L);
obj6.setOnlineStatus(1L);
UniversalbpCampaignBidBatchupdateRequest.CrowdCommandVo obj8 = new UniversalbpCampaignBidBatchupdateRequest.CrowdCommandVo();
obj8.setCrowdId(5526396502L);
obj8.setCrowdName("目标人群扩展");
obj8.setCrowdValue("2191820003");
obj8.setTargetType(130L);
UniversalbpCampaignBidBatchupdateRequest.LabelCommandVo obj9 = new UniversalbpCampaignBidBatchupdateRequest.LabelCommandVo();
obj9.setTargetType(131L);
obj9.setLabelId(3000494L);
obj9.setLabelName("关键词");
obj9.setLabelDesc("关键词");
obj9.setLabelValue("2000112");
List<UniversalbpCampaignBidBatchupdateRequest.OptionCommandVo> list11 = new ArrayList<UniversalbpCampaignBidBatchupdateRequest.OptionCommandVo>();
UniversalbpCampaignBidBatchupdateRequest.OptionCommandVo obj12 = new UniversalbpCampaignBidBatchupdateRequest.OptionCommandVo();
list11.add(obj12);
obj12.setOptionName("人群特征继承");
obj12.setOptionValue("2000123");
obj12.setTagId(100000L);
UniversalbpCampaignBidBatchupdateRequest.LabelOptionProperties obj14 = new UniversalbpCampaignBidBatchupdateRequest.LabelOptionProperties();
obj14.setDmpOptionGroupId("1001");
obj14.setCateName("714616513841");
obj14.setCateId("714616513841");
list13.setLabelOptionProperties(obj14);
obj9.setOptionList(list11);
UniversalbpCampaignBidBatchupdateRequest.LabelOptionProperties obj15 = new UniversalbpCampaignBidBatchupdateRequest.LabelOptionProperties();
obj15.setDmpOptionGroupId("1001");
obj15.setCateName("714616513841");
obj15.setCateId("714616513841");
obj9.setLabelOptionProperties(obj15);
obj8.setLabel(obj9);
obj8.setLookalikeMultiple("1");
List<UniversalbpCampaignBidBatchupdateRequest.ExtendSeedCrowdRefCommandVo> list17 = new ArrayList<UniversalbpCampaignBidBatchupdateRequest.ExtendSeedCrowdRefCommandVo>();
UniversalbpCampaignBidBatchupdateRequest.ExtendSeedCrowdRefCommandVo obj18 = new UniversalbpCampaignBidBatchupdateRequest.ExtendSeedCrowdRefCommandVo();
list17.add(obj18);
UniversalbpCampaignBidBatchupdateRequest.ExtendSeedCrowdCommandVo obj20 = new UniversalbpCampaignBidBatchupdateRequest.ExtendSeedCrowdCommandVo();
obj20.setCrowdId(5536708993L);
obj20.setCrowdName("喜欢店铺新品的访客");
UniversalbpCampaignBidBatchupdateRequest.ExtendSeedLabelCommandVo obj21 = new UniversalbpCampaignBidBatchupdateRequest.ExtendSeedLabelCommandVo();
obj21.setLabelId(3000494L);
obj21.setLabelName("关键词");
List<UniversalbpCampaignBidBatchupdateRequest.ExtendSeedOptionCommandVo> list23 = new ArrayList<UniversalbpCampaignBidBatchupdateRequest.ExtendSeedOptionCommandVo>();
UniversalbpCampaignBidBatchupdateRequest.ExtendSeedOptionCommandVo obj24 = new UniversalbpCampaignBidBatchupdateRequest.ExtendSeedOptionCommandVo();
list23.add(obj24);
obj24.setOptionName("人群特征继承");
obj24.setOptionValue("2000123");
obj24.setTagId(100000L);
obj21.setOptionList(list23);
obj20.setLabel(obj21);
list19.setCrowd(obj20);
obj8.setExtendSeedCrowdList(list17);
list7.setCrowd(obj8);
UniversalbpCampaignBidBatchupdateRequest.PriceCommandVo obj26 = new UniversalbpCampaignBidBatchupdateRequest.PriceCommandVo();
obj26.setBidPrice("30");
obj26.setDiscount("30");
list25.setPrice(obj26);
obj2.setCrowdList(list5);
List<UniversalbpCampaignBidBatchupdateRequest.AdzoneRefCommandVo> list28 = new ArrayList<UniversalbpCampaignBidBatchupdateRequest.AdzoneRefCommandVo>();
UniversalbpCampaignBidBatchupdateRequest.AdzoneRefCommandVo obj29 = new UniversalbpCampaignBidBatchupdateRequest.AdzoneRefCommandVo();
list28.add(obj29);
obj29.setAdzoneId(111287850198L);
obj29.setCampaignId(68796878069L);
obj29.setDiscount(3L);
obj29.setStatus("start");
obj2.setAdzoneList(list28);
obj2.setCrowdDiscount(30L);
obj2.setWordPrice("30");
req.setDataList(obj2);
UniversalbpCampaignBidBatchupdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_campaign_bid_batchupdate_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <campaign_bid_update_result_v_o_top_part_data>
            <count>1</count>
            <campaign_bid_update_result_v_o_list>
                <campaign_bid_update_result_vo>
                    <campaign_id>68796878069</campaign_id>
                </campaign_bid_update_result_vo>
            </campaign_bid_update_result_v_o_list>
            <error_count>1</error_count>
            <error_details>
                <top_fail_result>
                    <code>xxxxx</code>
                    <msg>xxxxx</msg>
                </top_fail_result>
            </error_details>
        </campaign_bid_update_result_v_o_top_part_data>
    </result>
</universalbp_campaign_bid_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

返回
顶部