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

taobao.simba.bidword.pricetools (关键词出价指导工具(新))

关键词出价指导工具(新)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adgroup_id Number 必须 12345678 推广单元id
bidword_id Number 必须 1234567890 关键词id
traffic_type String 可选 WL 区分渠道 ,计算机:PC,无线 :WL
type Number 必须 1 出价目标 ,1:争取排名;2:提升展现;3:提示点击;4:提升转化

响应参数

名称 类型 示例值 描述
result_list PriceSuggestionDto true true 表示符合准入,false不符合
  • └ bidwordid
  • String
  • 123123123
  • 关键词id
  • └ word
  • String
  • 连衣裙
  • 关键词原词
  • └ stat
  • String
  • 1
  • 状态码
  • yesterday_info
  • YesterdayInfo
  • 1
  • 昨日信息
  • └ click
  • String
  • 1
  • 昨日点击量
  • └ impression
  • String
  • 1
  • 昨日展现量
  • guidance_price
  • GuidancePrice
  • 1
  • 出价建议
  • └ click_up_rate
  • String
  • 1
  • 相对当前价格点击提升比例
  • └ impression_up_rate
  • String
  • 1
  • 相对当前价格展现提升比例
  • └ price_flag
  • String
  • 1
  • 价格类型,0代表正常排名建议,1代表被过滤排名建议, * 2代表相近价格建议,3代表转化出价建议
  • └ price
  • String
  • 1
  • 建议出价(分)
  • └ flag
  • String
  • 1
  • flag=0,1时为目标排名,flag=2时无意义,flag=3时代表对应的建议
  • └ new_click
  • String
  • 1
  • 建议价格能够拿到的点击量
  • └ new_impression
  • String
  • 1
  • 建议价格能够拿到的展现量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SimbaBidwordPricetoolsRequest req = new SimbaBidwordPricetoolsRequest();
req.setAdgroupId(12345678L);
req.setBidwordId(1234567890L);
req.setTrafficType("WL");
req.setType(1L);
SimbaBidwordPricetoolsResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<simba_bidword_pricetools_response>
    <result_list>
        <bidwordid>123123123</bidwordid>
        <word>连衣裙</word>
        <stat>1</stat>
        <yesterday_info>
            <click>1</click>
            <impression>1</impression>
        </yesterday_info>
        <guidance_price>
            <click_up_rate>1</click_up_rate>
            <impression_up_rate>1</impression_up_rate>
            <price_flag>1</price_flag>
            <price>1</price>
            <flag>1</flag>
            <new_click>1</new_click>
            <new_impression>1</new_impression>
        </guidance_price>
    </result_list>
</simba_bidword_pricetools_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

返回
顶部