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

taobao.universalbp.new.crowd.findrecommendcrowd (查询推荐人群)

入参推广信息,查询推荐人群,查出的推荐人群列表,不需转换,直接可用于入参其他计划创编类接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
crowd_rec_query_v_o CrowdRecQueryVO 必须 crowdRecQueryVO
  • └ rec_scene_list
  • String []
  • 可选
  • ["bd_sys"]
  • 推荐场景,bd_sys:系统推荐人群,bd_ctr:行业榜单-点击率,bd_col_cart_rate:行业榜单-收藏加购,bd_cvr:行业榜单-转化率,bd_assist:行业榜单-助攻率,recSceneNew:关键词推广-新建流程,recSceneEffect:效果榜单,recSceneHeat:热度榜单,recSceneActivity:大促人群推荐,recSceneHomePage:首页榜单,recSceneAdgroupQualityOptions:单元列表智能拉新人群-优质组合推荐
  • └ campaign_id
  • Number
  • 可选
  • 68795552573
  • 计划id
  • └ item_selected_mode
  • String
  • 可选
  • shop
  • 选品方式,shop:全店优选,user_define:用户自定义选品,scope:范围圈选,trend:趋势选品
  • └ shop_item_type
  • String
  • 可选
  • effect
  • 优选集合,effect:效果优选,growing:全店成长,activity:活动选品,industry:行业尖货,scope:定义选品
  • └ material_id_list
  • Number []
  • 可选
  • [714894818852, 714901906337, 715106275342, 714813770503, 714707465203]
  • 宝贝id集合
  • └ promotion_type
  • String
  • 可选
  • item
  • 推广主体类型
  • └ sub_promotion_type
  • String
  • 可选
  • item
  • 主体类型,支持一个计划下存在多种类型
  • └ 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:旺旺留资
  • category
  • CategoryQueryVO
  • 可选
  • 类目查询
  • └ cat_id
  • Number
  • 可选
  • 35
  • 类目id
  • └ cat_name
  • String
  • 可选
  • 童装/婴儿装/亲子装
  • 类目名称
  • └ cat_level
  • Number
  • 可选
  • 1
  • 类目级别,一级类目、二级目录
  • └ promotion_scene
  • String
  • 可选
  • promotion_scene_crowd
  • 推广场景,promotion_scene_crowd:人群方舟,promotion_scene_item:店铺宝贝运营,promotion_scene_traffic:宝藏场景,AD_STRATEGY_LAXIN:策略中心拉新场景,AD_STRATEGY_SHANGXINLI:策略中心上新礼场景,AD_STRATEGY_FRESH_BOX:策略中心小黑盒场景,AD_STRATEGY_LAXIN_XINXIANG:策略中心拉新新享一笔钱场景,AD_STRATEGY_RUHUI_NEW:策略中心入会快新会员场景,AD_STRATEGY_RUHUI_OLD:策略中心入会快老会员场景,AD_STRATEGY_LIUZI:策略中心留资快场景,AD_STRATEGY_YURE:策略中心活动加速场景,AD_STRATEGY_HUODONG_ESCORT:活动全周期护航计划,AD_STRATEGY_CROWD_INDUSTRY:策略中心行业人群通,AD_STRATEGY_WHOLE_SHOP_SMART:策略中心全店放心推-智能托管,AD_STRATEGY_WHOLE_SHOP_CUSTOM:策略中心全店放心推-自定义,AD_STRATEGY_EVEN_BUDGET:策略中心均匀曝光场景,AD_STRATEGY_SXK_GUARANTEE:万相台上新快确定性保障,AD_STRATEGY_HPJS_GUARANTEE:万相台货品加速确定性保障,AD_STRATEGY_HPJS_TIME_LIMIT:万相台货品加速限时加速,AD_STRATEGY_FANS_HEADLINES:万相台粉丝头条,WXT_AGENCY_XST_CPC:服务商版一键起量(CPC),WXT_AGENCY_XST_CPA:服务商版客源多(CPA),WXT_AGENCY_SHEQUN:服务商版社群(CPA+CPS)

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • crowd_ref_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • crowd_ref_v_o_list
  • CrowdRefVO []
  • 批量成功结果集
  • └ campaign_id
  • Number
  • 68799007001
  • 计划id
  • └ adgroup_id
  • Number
  • 68796878061
  • 单元id
  • └ crowd_id
  • Number
  • 5526396502
  • 人群主键id
  • └ online_status
  • Number
  • 1
  • 定向状态,0:下线 1:上线
  • crowd
  • CrowdVO
  • 人群
  • └ crowd_id
  • Number
  • 5526396502
  • 人群主键id
  • └ crowd_name
  • String
  • 目标人群扩展
  • 人群名称
  • └ crowd_value
  • String
  • 2191820003
  • 人群值
  • └ target_type
  • Number
  • 130
  • 定向类型
  • label
  • LabelVO
  • 定向标签
  • └ target_type
  • Number
  • 131
  • 定向标签类型
  • └ label_id
  • Number
  • 3000494
  • 定向标签id
  • └ label_name
  • String
  • 关键词
  • 定向标签名称
  • └ label_desc
  • String
  • 关键词
  • 定向标签描述
  • └ label_value
  • String
  • 2000112
  • 定向标签值
  • └ label_group_name
  • String
  • 人群
  • 人群类型,所属类型
  • └ price_dimension
  • String
  • OPTION
  • 出价维度,OPTION:标签出价,多个子人群同时出价、LABEL:选项出价,以子人群为出价最小单位
  • price
  • PriceVO
  • 出价
  • └ bid_price
  • String
  • 30
  • 出价
  • └ fit_bid_price
  • String
  • 30
  • 建议出价
  • └ discount
  • String
  • 30
  • 溢价
  • └ fit_discount
  • String
  • 30
  • 建议溢价
  • option_group_list
  • OptionGroupVO []
  • 标签选项分组
  • └ option_group_name
  • String
  • 性别
  • 标签分组名称
  • option_list
  • OptionVO []
  • 标签选项
  • └ option_name
  • String
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 2000123
  • 选项值
  • └ option_desc
  • String
  • 该定向人群将继承原始计划已触达的消费者特征,缩短算法搜寻合适人群的冷启动周期,建议您同时开启【智能拓展】功能,提升投放效果。
  • 选项描述
  • └ tag_id
  • Number
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • └ option_group_name
  • String
  • 性别
  • 标签分组名称
  • └ properties
  • String
  • 扩展属性
  • 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 []
  • 关键词(综合关键词、竞争航线)子人群值
  • option_list
  • OptionVO []
  • 标签选项
  • └ option_name
  • String
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 2000123
  • 选项值
  • └ option_desc
  • String
  • 该定向人群将继承原始计划已触达的消费者特征,缩短算法搜寻合适人群的冷启动周期,建议您同时开启【智能拓展】功能,提升投放效果。
  • 选项描述
  • └ tag_id
  • Number
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • └ option_group_name
  • String
  • 性别
  • 标签分组名称
  • └ properties
  • String
  • 扩展属性
  • 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 []
  • 关键词(综合关键词、竞争航线)子人群值
  • show_tag_list
  • ShowTagVO []
  • 通用标签
  • └ code
  • String
  • hign_cvr
  • 标签code
  • └ name
  • String
  • 高转化率
  • 展示文案
  • └ tips
  • String
  • xxxxxx
  • 悬浮描述
  • └ icon
  • String
  • xxxxxx
  • 标签左侧图标地址
  • └ color
  • String
  • #FF4D4D
  • 背景颜色
  • └ type
  • String
  • display_ocpc
  • 标签类型
  • └ properties
  • String
  • 扩展属性
  • └ is_multi
  • Boolean
  • true
  • 是否可以绑定多个定向,获取不到 默认为否,true:是 false:否
  • └ category_id
  • Number
  • 3221312321
  • 目标类目
  • └ category_name
  • String
  • 服装
  • 类目名称
  • └ properties
  • String
  • 额外的属性参数
  • 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
  • ExtendSeedCrowdRefVO []
  • 种子人群关联信息
  • crowd
  • ExtendSeedCrowdVO
  • 人群扩展种子人群 扩展种子人群的结构和实体是一致的,为了和前端交互更清晰,知道哪些参数需要传,所以定义一下种子人群的VO
  • 种子人群信息
  • └ crowd_id
  • Number
  • 5536708993
  • 人群主键id
  • └ crowd_name
  • String
  • 喜欢店铺新品的访客
  • 人群名称
  • label
  • ExtendSeedLabelVO
  • 扩展人群种子人群Label结构
  • 种子人群label信息
  • └ target_type
  • Number
  • 131
  • 定向标签类型
  • └ label_id
  • Number
  • 3000494
  • 定向标签id
  • └ label_name
  • String
  • 关键词
  • 定向标签名称
  • └ price_dimension
  • String
  • OPTION
  • 出价维度,OPTION:标签出价,多个子人群同时出价、LABEL:选项出价,以子人群为出价最小单位
  • └ is_multi
  • Boolean
  • true
  • 是否可以绑定多个定向,获取不到 默认为否,true:是 false:否
  • option_list
  • ExtendSeedOptionVO []
  • 选项值信息
  • └ option_name
  • String
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 2000123
  • 选项值
  • └ tag_id
  • Number
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • sub_crowd_list
  • SubCrowdVO []
  • 子人群信息
  • └ subcrowd_name
  • String
  • 目标人群扩展
  • 子定向名称
  • └ subcrowd_value
  • String
  • 2191820003
  • 子定向值
  • price
  • PriceVO
  • 出价
  • └ bid_price
  • String
  • 30
  • 出价
  • └ fit_bid_price
  • String
  • 30
  • 建议出价
  • └ discount
  • String
  • 30
  • 溢价
  • └ fit_discount
  • String
  • 30
  • 建议溢价
  • show_tag_list
  • ShowTagVO []
  • 通用标签
  • └ code
  • String
  • hign_cvr
  • 标签code
  • └ name
  • String
  • 高转化率
  • 展示文案
  • └ tips
  • String
  • xxxxxx
  • 悬浮描述
  • └ icon
  • String
  • xxxxxx
  • 标签左侧图标地址
  • └ color
  • String
  • #FF4D4D
  • 背景颜色
  • └ type
  • String
  • display_ocpc
  • 标签类型
  • └ properties
  • String
  • 扩展属性

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewCrowdFindrecommendcrowdRequest req = new UniversalbpNewCrowdFindrecommendcrowdRequest();
UniversalbpNewCrowdFindrecommendcrowdRequest.TopServiceContext obj1 = new UniversalbpNewCrowdFindrecommendcrowdRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewCrowdFindrecommendcrowdRequest.CrowdRecQueryVO obj2 = new UniversalbpNewCrowdFindrecommendcrowdRequest.CrowdRecQueryVO();
obj2.setRecSceneList(""bd_sys"");
obj2.setCampaignId(68795552573L);
obj2.setItemSelectedMode("shop");
obj2.setShopItemType("effect");
obj2.setMaterialIdList(new Long[] { 714894818852, 714901906337, 715106275342, 714813770503, 714707465203 };
);
obj2.setPromotionType("item");
obj2.setSubPromotionType("item");
obj2.setOptimizeTarget("conv");
UniversalbpNewCrowdFindrecommendcrowdRequest.CategoryQueryVO obj3 = new UniversalbpNewCrowdFindrecommendcrowdRequest.CategoryQueryVO();
obj3.setCatId(35L);
obj3.setCatName("童装/婴儿装/亲子装");
obj3.setCatLevel(1L);
obj2.setCategory(obj3);
obj2.setPromotionScene("promotion_scene_crowd");
req.setCrowdRecQueryVO(obj2);
UniversalbpNewCrowdFindrecommendcrowdResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_crowd_findrecommendcrowd_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <crowd_ref_v_o_top_bulk_data>
            <count>10</count>
            <crowd_ref_v_o_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>30</bid_price>
                                <fit_bid_price>30</fit_bid_price>
                                <discount>30</discount>
                                <fit_discount>30</fit_discount>
                            </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>
                                        </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>
                                </option_v_o>
                            </option_list>
                            <show_tag_list>
                                <show_tag_v_o>
                                    <code>hign_cvr</code>
                                    <name>高转化率</name>
                                    <tips>xxxxxx</tips>
                                    <icon>xxxxxx</icon>
                                    <color>#FF4D4D</color>
                                    <type>display_ocpc</type>
                                </show_tag_v_o>
                            </show_tag_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>30</bid_price>
                        <fit_bid_price>30</fit_bid_price>
                        <discount>30</discount>
                        <fit_discount>30</fit_discount>
                    </price>
                    <show_tag_list>
                        <show_tag_v_o>
                            <code>hign_cvr</code>
                            <name>高转化率</name>
                            <tips>xxxxxx</tips>
                            <icon>xxxxxx</icon>
                            <color>#FF4D4D</color>
                            <type>display_ocpc</type>
                        </show_tag_v_o>
                    </show_tag_list>
                </crowd_ref_v_o>
            </crowd_ref_v_o_list>
        </crowd_ref_v_o_top_bulk_data>
    </top_result>
</universalbp_new_crowd_findrecommendcrowd_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

返回
顶部