自动投放匹配类型列表

根据指定查询条件搜索自动投放匹配类型列表。

相关URL

Newegg.com: https://api.newegg.com/marketplace/sponsoredmgmt/campaign/autotargeting/matchtypesearch?sellerid={sellerid}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
POST 需要 Json Json 1000 请求/小时

请求文件主体

属性 是否必填？ 格式 描述
sellerId 是 String 您在新蛋商城的商家编号
campaignNumber 是 Integer 现有广告活动的标识编号
groupNumber 是 Integer 现有广告组的标识编号

示例：Json，Request

POST https://api.newegg.com/marketplace/sponsoredmgmt/campaign/autotargeting/matchtypesearch?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
  "sellerID": "AP08",
  "campaignNumber": 1003234,
  "groupNumber": 1003235
}

回复文件主体

属性 格式 描述
msg String 返回信息
bizCode String 有效值：

  • 200：查询匹配类型成功
matchType Integer 匹配类型。有效值：

  • 2:  Close match 紧密匹配
  • 3:  Loose match 宽泛匹配
  • 4:  Substitute 同类商品
  • 5:  Complements 关联商品
matchTypeName String 匹配类型名称。有效值：

  • 紧密匹配：当matchType=2时
  • 宽泛匹配：当matchType=3时
  • 同类商品：当matchType=4时
  • 关联商品：当matchType=5时
suggBid Decimal 建议出价
suggBidLowest Decimal 建议最低出价
suggBidMost Decimal 建议最高出价
bid Decimal 与此类型匹配的竞价。仅适用于可竞价匹配类型
activeStatus Enum 广告活动状态：

  • Active 启用：查询处理中、正在投放、已超预算状态的数据
  • Inactive 暂停：查询暂停和已结束状态的数据
status Enum 广告活动状态描述：

  • Pending 待审核
  • Delivering 正在投放
  • Processing 处理中
  • Out of budget 已超预算
  • Inactive 已暂停
  • Ended 已结束
declineReason String 广告活动被拒绝原因
totalRows Integer 返回结果总数量

示例：Json，Request

{
  "header": [
    {
      "msg": "query match type success!",
      "bizCode": "200"
    }
  ],
  "rows": [
    {
      "matchType": 2,
      "matchTypeName": "Close match",
      "suggBid": 0.55,
      "suggBidLowest": 0.32,
      "suggBidMost": 0.77,
      "bid": 0.76,
      "activeStatus": "Active",
      "status": "Delivering",
      "declineReason": null
    },
    {
      "matchType": 3,
      "matchTypeName": "Loose match",
      "suggBid": 0.36,
      "suggBidLowest": 0.32,
      "suggBidMost": 0.4,
      "bid": 0.64,
      "activeStatus": "Active",
      "status": "Delivering",
      "declineReason": null
    },
    {
      "matchType": 4,
      "matchTypeName": "Substitutes",
      "suggBid": 0.13,
      "suggBidLowest": 0.1,
      "suggBidMost": 0.16,
      "bid": 0.42,
      "activeStatus": "Active",
      "status": "Delivering",
      "declineReason": null
    },
    {
      "matchType": 5,
      "matchTypeName": "Complements",
      "suggBid": 0.16,
      "suggBidLowest": 0.12,
      "suggBidMost": 0.2,
      "bid": 0.56,
      "activeStatus": "Active",
      "status": "Delivering",
      "declineReason": null
    }
  ],
  "totalRows": 4
}

更新日期：06/29/2022