文档中心 > API类目 > 直通车API

taobao.universalbp.bidword.suggestkrlist (关键词建议)

入参推广信息,出参建议的全部关键词

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
bidword_suggest_query_v_o BidwordSuggestQueryVo 必须 bidwordSuggestQueryVO
  • └ type
  • String
  • 可选
  • kr_overall
  • 类型,kr_overall:综合推荐,kr_flow:精准引流,kr_category:类目优质词,kr_industry:行业机会词,kr_mta:助攻词,kr_search:搜索词联想,kr_byword:以词推词,kr_bycrowd:以人群词,new_default:新建流程默认推词
  • └ material_id
  • Number
  • 可选
  • 715017855321
  • 宝贝id
  • └ adgroup_id
  • Number
  • 可选
  • 68793666608
  • 单元id,单元已经存在场景必填
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填
  • └ crowd_id_list
  • Number []
  • 可选
  • [111]
  • 人群id
  • └ word
  • String
  • 可选
  • 连衣裙

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • suggest_bidword_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • suggest_bidword_v_o_list
  • SuggestBidwordVo []
  • 批量结果集
  • └ word
  • String
  • 吵吵家
  • 关键词
  • └ bid_price
  • String
  • 1
  • 关键词
  • └ avg_price
  • String
  • 0.47
  • 市场平均出价
  • └ impression
  • String
  • 0-10
  • 预估展现
  • └ relevance_type
  • Number
  • 3
  • 相关性,1:差,2:中,3:好
  • └ ctr
  • String
  • 0.0381
  • 点击率
  • └ cvr
  • String
  • 0.0209
  • 点击转化率
  • └ type
  • Number
  • 0
  • 分类,0:宝贝,1:店铺
  • └ impression_index
  • Number
  • 30
  • 展现指数
  • └ competition_index
  • String
  • 20
  • 竞争指数
  • └ search_index
  • Number
  • 20
  • 搜索指数
  • └ qscore
  • String
  • 6.00
  • 预估质量分
  • └ item_click
  • Number
  • 20
  • 进店次数
  • └ transaction_shipping_total
  • Number
  • 20
  • 引导下单数
  • └ item_click_coverage
  • String
  • 0.5
  • 下单转化率
  • └ mta_roi
  • String
  • 20
  • 助攻roi
  • reason_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
  • 扩展属性
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpBidwordSuggestkrlistRequest req = new UniversalbpBidwordSuggestkrlistRequest();
UniversalbpBidwordSuggestkrlistRequest.TopServiceContext obj1 = new UniversalbpBidwordSuggestkrlistRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpBidwordSuggestkrlistRequest.BidwordSuggestQueryVo obj2 = new UniversalbpBidwordSuggestkrlistRequest.BidwordSuggestQueryVo();
obj2.setType("kr_overall");
obj2.setMaterialId(715017855321L);
obj2.setAdgroupId(68793666608L);
obj2.setCampaignId(68796878069L);
obj2.setCrowdIdList(new Long[] { 111 };
);
obj2.setWord("连衣裙");
req.setBidwordSuggestQueryVO(obj2);
UniversalbpBidwordSuggestkrlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_bidword_suggestkrlist_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <suggest_bidword_v_o_top_bulk_data>
            <suggest_bidword_v_o_list>
                <suggest_bidword_vo>
                    <word>吵吵家</word>
                    <bid_price>1</bid_price>
                    <avg_price>0.47</avg_price>
                    <impression>0-10</impression>
                    <relevance_type>3</relevance_type>
                    <ctr>0.0381</ctr>
                    <cvr>0.0209</cvr>
                    <type>0</type>
                    <impression_index>30</impression_index>
                    <competition_index>20</competition_index>
                    <search_index>20</search_index>
                    <qscore>6.00</qscore>
                    <item_click>20</item_click>
                    <transaction_shipping_total>20</transaction_shipping_total>
                    <item_click_coverage>0.5</item_click_coverage>
                    <mta_roi>20</mta_roi>
                    <reason_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>
                    </reason_tag_list>
                </suggest_bidword_vo>
            </suggest_bidword_v_o_list>
            <count>1</count>
        </suggest_bidword_v_o_top_bulk_data>
    </result>
</universalbp_bidword_suggestkrlist_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

返回
顶部