添加廣告組

為現有廣告活動添加廣告組。

相關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 國家/地區的國際標準三位國家代碼
currencyCode 是 String 貨幣代碼
campaignNumber 是 Integer 與廣告組相關聯的現有廣告活動
groupName 是 String 廣告組的名稱
products 是 String 相關聯的產品集合。最小為1，最大為10K，同一廣告組下的產品不可重複，且只能添加同一賣家的產品
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 否 String 細分類別數據。
如果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 否 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