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

taobao.universalbp.new.crowd.horizontal.modifybidprice (修改人群出价)

修改指定计划、单元上的人群的出价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
crowd_ref_command_list_v_o CrowdRefCommandListVO 必须 crowdRefCommandListVO
  • 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,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • └ properties
  • String
  • 可选
  • 扩展属性
  • label_option_properties
  • LabelOptionProperties
  • 可选
  • 透传属性
  • └ dmp_option_group_id
  • String
  • 可选
  • 1001
  • dmp选项分组id
  • └ cate_name
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ cate_id
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ properties
  • String
  • 可选
  • 扩展属性
  • 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
  • 溢价

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • crowd_ref_update_result_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • crowd_ref_update_result_v_o_list
  • CrowdRefUpdateResultVO []
  • 批量成功结果集
  • └ campaign_id
  • Number
  • 68799007001
  • 计划id
  • └ adgroup_id
  • Number
  • 68796878061
  • 单元id
  • └ crowd_id
  • Number
  • 5526396502
  • 人群主键id
  • └ count
  • Number
  • 2
  • 更新成功数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewCrowdHorizontalModifybidpriceRequest req = new UniversalbpNewCrowdHorizontalModifybidpriceRequest();
UniversalbpNewCrowdHorizontalModifybidpriceRequest.TopServiceContext obj1 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdRefCommandListVO obj2 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdRefCommandListVO();
List<UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdRefCommandVO> list4 = new ArrayList<UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdRefCommandVO>();
UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdRefCommandVO obj5 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdRefCommandVO();
list4.add(obj5);
obj5.setCampaignId(68799007001L);
obj5.setAdgroupId(68796878061L);
obj5.setCrowdId(5526396502L);
obj5.setOnlineStatus(1L);
UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdCommandVO obj7 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.CrowdCommandVO();
obj7.setCrowdId(5526396502L);
obj7.setCrowdName("目标人群扩展");
obj7.setCrowdValue("2191820003");
obj7.setTargetType(130L);
UniversalbpNewCrowdHorizontalModifybidpriceRequest.LabelCommandVO obj8 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.LabelCommandVO();
obj8.setTargetType(131L);
obj8.setLabelId(3000494L);
obj8.setLabelName("关键词");
obj8.setLabelDesc("关键词");
obj8.setLabelValue("2000112");
List<UniversalbpNewCrowdHorizontalModifybidpriceRequest.OptionCommandVO> list10 = new ArrayList<UniversalbpNewCrowdHorizontalModifybidpriceRequest.OptionCommandVO>();
UniversalbpNewCrowdHorizontalModifybidpriceRequest.OptionCommandVO obj11 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.OptionCommandVO();
list10.add(obj11);
obj11.setOptionName("人群特征继承");
obj11.setOptionValue("2000123");
obj11.setTagId(100000L);
obj11.setProperties("");
UniversalbpNewCrowdHorizontalModifybidpriceRequest.LabelOptionProperties obj13 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.LabelOptionProperties();
obj13.setDmpOptionGroupId("1001");
obj13.setCateName("714616513841");
obj13.setCateId("714616513841");
list12.setLabelOptionProperties(obj13);
obj8.setOptionList(list10);
obj8.setProperties("");
UniversalbpNewCrowdHorizontalModifybidpriceRequest.LabelOptionProperties obj14 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.LabelOptionProperties();
obj14.setDmpOptionGroupId("1001");
obj14.setCateName("714616513841");
obj14.setCateId("714616513841");
obj8.setLabelOptionProperties(obj14);
obj8.setTargetValue(11111L);
obj7.setLabel(obj8);
obj7.setLookalikeMultiple("1");
List<UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedCrowdRefCommandVO> list16 = new ArrayList<UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedCrowdRefCommandVO>();
UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedCrowdRefCommandVO obj17 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedCrowdRefCommandVO();
list16.add(obj17);
UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedCrowdCommandVO obj19 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedCrowdCommandVO();
obj19.setCrowdId(5536708993L);
obj19.setCrowdName("喜欢店铺新品的访客");
UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedLabelCommandVO obj20 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedLabelCommandVO();
obj20.setLabelId(3000494L);
obj20.setLabelName("关键词");
List<UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedOptionCommandVO> list22 = new ArrayList<UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedOptionCommandVO>();
UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedOptionCommandVO obj23 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.ExtendSeedOptionCommandVO();
list22.add(obj23);
obj23.setOptionName("人群特征继承");
obj23.setOptionValue("2000123");
obj23.setTagId(100000L);
obj20.setOptionList(list22);
obj19.setLabel(obj20);
list18.setCrowd(obj19);
obj7.setExtendSeedCrowdList(list16);
list6.setCrowd(obj7);
UniversalbpNewCrowdHorizontalModifybidpriceRequest.PriceCommandVO obj25 = new UniversalbpNewCrowdHorizontalModifybidpriceRequest.PriceCommandVO();
obj25.setBidPrice("30");
obj25.setDiscount("30");
list24.setPrice(obj25);
obj2.setCrowdList(list4);
req.setCrowdRefCommandListVO(obj2);
UniversalbpNewCrowdHorizontalModifybidpriceResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_crowd_horizontal_modifybidprice_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <crowd_ref_update_result_v_o_top_bulk_data>
            <count>10</count>
            <crowd_ref_update_result_v_o_list>
                <crowd_ref_update_result_v_o>
                    <campaign_id>68799007001</campaign_id>
                    <adgroup_id>68796878061</adgroup_id>
                    <crowd_id>5526396502</crowd_id>
                    <count>2</count>
                </crowd_ref_update_result_v_o>
            </crowd_ref_update_result_v_o_list>
        </crowd_ref_update_result_v_o_top_bulk_data>
    </top_result>
</universalbp_new_crowd_horizontal_modifybidprice_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

返回
顶部