添加廣告組

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

相關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