创建广告活动

创建一个新的广告活动。

相关URL

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

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

参数

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

相关请求信息

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

请求文件主体

属性 是否必填？ 格式 描述
sellerId 是 String 您在新蛋商城的商家编号
countryCode 是 String 国家/地区的国际标准3位国家编码
currencyCode 是 String 货币代码
campaignName 是 String 广告活动名称。最长为200个字符，每个卖家账户下的活动名称不可重复。
startDate 是 DateTime 广告活动上线的开始日期
endDate 否 DateTime 广告活动停止运行的结束日期
dailyBudget 是 Decimal 广告活动的每日预算
totalBudget 否 Decimal 广告活动的总预算
groupName 是 String 广告组名称。最长为200个字符，同一广告活动的活动组名称不可重复。
products 是 String 产品集合。最小为1，最大为10000，同一广告组下的产品不可重复，且只能添加同一卖家的产品
keywords keyword 是 String 关键词文本。最小为1，最大为1000，同一广告组下的关键词不能重复
normalizedKeyword 是 String 标准化关键词
suggBid 否 Decimal 建议出价
suggBidLowest 否 Decimal 建议最低出价
suggBidMost 否 Decimal 建议最高出价
bid 是 Decimal 卖家为广告活动组关键词设置的出价
matchType 是 Integer 匹配类型。有效值：

  • 0：Exact 精确
  • 1：Broad 广泛
  • 6：Phrase 短语
type 是 Integer 广告活动投放类型。有效值：

  • 0：manual targeting 手动投放
  • 1：auto targeting 自动投放
defaultBid 否 Decimal 如Type=1 – 自动投放，卖家可设置自动投放广告的出价
matchTypes matchType 是 Integer 匹配类型。有效值：

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

  • Active
  • Inactive
bid 是 Decimal 由广告活动类型算法设置的出价
negativeKeywords keyword 是 String 与搜索查询匹配的关键词文本
keywordType 是 Enum 匹配类型。有效值：

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

  • 0：Deactive
  • 1：Active
groupType 否 Integer 广告活动的定位类型。有效值：

  • 0：Keyword  targeting 关键词投放
  • 1：Product targeting 商品投放
  • 2：On-site Product Targeting 新蛋平台投放
  • 3：Off-site Product Targeting 非新蛋平台投放
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 非新蛋平台竞价金额

示例：Json，Request

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

{
  "sellerId": "AXER",
  "countryCode": "USA",
  "currencyCode": "USD",
  "campaignName": "General Promotion",
  "startDate": "2022-06-15 00:00:00",
  "endDate": null,
  "dailyBudget": 2,
  "totalBudget": null,
  "groupName": "1",
  "products": [
    "9SIAXERJ571971",
    "9SIAXERHTU3073"
  ],
  "keywords": [],
  "type": 1,
  "defaultBid": 0.48,
  "matchTypes": [
    {
      "matchType": 2,
      "activeStatus": "Active",
      "bid": 0.39
    },
    {
      "matchType": 3,
      "activeStatus": "Inactive",
      "bid": 0.4
    },
    {
      "matchType": 4,
      "activeStatus": "Active",
      "bid": 0.2
    },
    {
      "matchType": 5,
      "activeStatus": "Inactive",
      "bid": 0.225
    }
  ],
 
  "negativeKeywords": [],
  "video": null,
  "groupType": 0,
  "relevantProducts": null,
  "offSiteBid": null,
  "displayMatchType": null
 
}

回复文件主体

属性 格式 描述
biz code String 有效值：

  • 001:  广告活动创建成功
  • 002:  广告活动名称长度超多200字符或重复
  • 004:  同一广告组的商品不能重复
  • 005:  同一广告组的关键词不能重复
msg String 返回信息

示例：Json，Request

{
  "header": [
    {
      "msg": "create campaign success",
      "bizCode": "001",
      "content": [
        "General Promotion"
      ]
    }
  ]
}

更新日期：06/29/2022