文档中心 > 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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
<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示例
1
2
3
4
5
6
<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

返回
顶部