自動投放匹配類型列表

根據指定查詢準則搜索自動投放匹配類型列表。

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