淘宝开放平台

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

万相台无界API

taobao.universalbp.new.crowd.findlist (查询人群绑定列表)

查询计划和单元上绑定的人群列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投（叉乘）时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
crowd_bind_query_list_v_o CrowdBindQueryListVO 必须 crowdBindQueryListVO
  • crowd_bind_query_list
  • CrowdBindQueryVO []
  • 必须
  • 人群信息查询条件集合
  • └ offset
  • Number
  • 可选
  • 0
  • 偏移量
  • └ page_size
  • Number
  • 可选
  • 20
  • 页面大小
  • └ campaign_id_list
  • Number []
  • 可选
  • [68792788657]
  • 计划id集合
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填
  • └ adgroup_id_list
  • Number []
  • 可选
  • [68798447504]
  • 单元id集合,单元已经存在场景必填

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • crowd_bind_result_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • crowd_bind_result_v_o_list
  • CrowdBindResultVO []
  • 批量成功结果集
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • └ adgroup_id
  • Number
  • 68793666608
  • 单元id
  • crowd_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
  • 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
  • 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
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewCrowdFindlistRequest req = new UniversalbpNewCrowdFindlistRequest();
UniversalbpNewCrowdFindlistRequest.TopServiceContext obj1 = new UniversalbpNewCrowdFindlistRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewCrowdFindlistRequest.CrowdBindQueryListVO obj2 = new UniversalbpNewCrowdFindlistRequest.CrowdBindQueryListVO();
List<UniversalbpNewCrowdFindlistRequest.CrowdBindQueryVO> list4 = new ArrayList<UniversalbpNewCrowdFindlistRequest.CrowdBindQueryVO>();
UniversalbpNewCrowdFindlistRequest.CrowdBindQueryVO obj5 = new UniversalbpNewCrowdFindlistRequest.CrowdBindQueryVO();
list4.add(obj5);
obj5.setOffset(0L);
obj5.setPageSize(20L);
obj5.setCampaignIdList(new Long[] { 68792788657 };
);
obj5.setCampaignId(68796878069L);
obj5.setAdgroupIdList(new Long[] { 68798447504 };
);
obj2.setCrowdBindQueryList(list4);
req.setCrowdBindQueryListVO(obj2);
UniversalbpNewCrowdFindlistResponse 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
138
139
140
141
142
143
<universalbp_new_crowd_findlist_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <crowd_bind_result_v_o_top_bulk_data>
            <count>10</count>
            <crowd_bind_result_v_o_list>
                <crowd_bind_result_v_o>
                    <campaign_id>68796878069</campaign_id>
                    <adgroup_id>68793666608</adgroup_id>
                    <crowd_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_list>
                </crowd_bind_result_v_o>
            </crowd_bind_result_v_o_list>
        </crowd_bind_result_v_o_top_bulk_data>
    </top_result>
</universalbp_new_crowd_findlist_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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部