添加广告组

为现有广告活动添加广告组。

相关URL

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

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

参数

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

相关请求信息

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

请求文件主体

属性 是否必填？ 格式 描述
countryCode 是 String 国家/地区的国际标准3位国家编码
currencyCode 是 String 货币代码
campaignNumber 是 Integer 与广告组相关联的现有广告活动
groupName 是 String 广告组的名称
products 是 String 相关联的产品集合。最小为1，最大为10000，同一广告组下的产品不可重复，且只能添加同一卖家的产品
keywords keyword 是 String 关键词文本。最小为1，最大为1000，同一广告组下的关键词不能重复
normalizedKeyword 是 String 标准化关键词
bid 是 Decimal 与关键词相关的竞价。仅适用于可出价匹配类型
matchType 是 Integer 匹配类型。有效值：

  • 0：Exact 精确
  • 1：Broad 广泛
  • 6：Phrase 短语
negativeKeywords keyword 是 String 与搜索查询匹配的关键词文本
keywordType 是 Enum 匹配类型。有效值：

  • 0：exact match 精准匹配
  • 6：phrase match 短语匹配
status 是 Integer 否定关键词状态。有效值：

  • 0：Deactive
  • 1：Active
matchTypes matchType 是 Integer 匹配类型。有效值：

  • 2:  Near match 紧密匹配
  • 3:  Loose match 宽泛匹配
  • 4:  Substitute 同类商品
  • 5:  Complements 关联商品
activeStatus 是 Enum 活动状态匹配类型。有效值：

  • Active
  • Inactive
bid 否 Decimal 由广告活动类型算法设置的出价
relevantProducts type 是 Integer 相关有效值类型：

  • 0：Product 商品
  • 1：Category 类别
relevantCode 是 String 如果Type=0（商品），则返值为新蛋商品编号
如果Type=1（类别），则返值为新蛋商品的类别编号
currentBid 否 Decimal 如果Type=0（商品），则返值为产品报价
如果Type=1（类别），则返值为null
status 否 Integer 相关状态。有效值：

  • 1：Paused
  • 2：Enabled
  • 3：Delete
  • 4：Arrears
categoryRefine 否 细分类别数据。
如果Type=0（商品），则返值为null
如果Type=1（类别），则返值如下
CategoryRefine brand_id 否 String 产品品牌
low_price 否 Decimal 价格范围 – 最低价格
high_price 否 Decimal 价格范围 – 最高价格
review_low_ratings 否 Integer Egg评级，最低默认为0
review_high_ratings 否 Integer Egg评级，最高默认为5
status 否 Integer 类别细分状态。有效值：

  • 1：Paused
  • 2：Enabled
  • 3：Delete
  • 4：Arrears
offSiteBid 否 Decimal 非新蛋平台竞价金额
displayMatchType No Integer

示例：Json，Request

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

{
  "countryCode": "USA",
  "currencyCode": "USD",
  "campaignNumber": 1153302,
  "groupName": "Z-11-3-Grey Black- Red switch",
   "products": [
    "9SIAWEJHGK6318"
  ],
  "keywords": [],
  "negativeKeywords": [],
  "defaultBid": 1.09,
  "matchTypes": [
    {
      "matchType": 2,
      "activeStatus": "Active",
      "bid": 0.45
    },
    {
      "matchType": 3,
      "activeStatus": "Active",
      "bid": 0.41
    },
    {
      "matchType": 4,
      "activeStatus": "Active",
      "bid": 0.215
    },
    {
      "matchType": 5,
      "activeStatus": "Active",
      "bid": 0.265
    }
  ],
  "relevantProducts": null,
  "offSiteBid": null,
  "displayMatchType": null
}

回复文件主体

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

  • 012:  添加广告组成功
  • 013:  所添加广告组名称重复
  • 014:  所添加广告组商品重复

示例：Json，Request

{
  "header": [
    {
      "msg": "add group to campaign success",
      "bizCode": "012"
    }
  ]
}

更新日期：06/29/2022