关键词绩效报告

根据指定关键词查询广告活动信息。

参数

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

请求文件主体

属性		是否必填？	格式	描述
sellerId		是	String	您的商家编号
extUrl		是	String	绩效精确链接有效值：keyword/searchKeywordList
countryCode		否	String	国家/地区的国际标准3位国家编码
campaignNumber		是	Integer	与关键词相关联的广告活动标识编号
groupNumber		是	Integer	与关键词相关联的广告组标识编号
searchKeywordType		否	Enum	关键词，模糊匹配与关键词配合使用，同时返回值或不返回值如果不通过，表示该条件未被过滤
keyword		否	String	结果限制为与指定文本精准匹配的关键词
activeStatus		否	Enum	有效值： Active 启用：查询处理中、正在投放、已超预算状态的数据 Inactive 暂停：查询暂停和已结束状态的数据
fromDate		是	String	广告活动的开始日期
toDate		是	String	广告活动的结束日期
pageInfo	pageIndex	否	Integer	当前页索引，默认为 1
	pageSize	否	Integer	一页中的记录数（默认为20，最大值为每页999999 条）
	sortField	否	String	排序字段名称，默认为InDate
	sortType	否	String	默认Desc，支持Desc、Asc两种方式

示例：Json，Request

POST https://api.newegg.com/marketplace/sponsoredmgmt/campaign/keyword/performance?sellerid={sellerid}
Content-Type: application/json
Accept: application/json
Authorization: 2d9da3949bdffd8594e9fa8a77764ce1
SecretKey: 55F55BC1-5E65-401B-BB1D-E29B0A19B734  
 
{
  "sellerId": "A2GS",
  "extUrl": "keyword/searchKeywordList",
  "countryCode": null,
  "campaignNumber": "989059",
  "groupNumber": "992977",
  "searchKeywordType": "KEYWORD",
  "keyword": "test manufacturer",
  "activeStatus": null,
  "fromDate": "2022-01-01",
  "toDate": "2022-09-09",
  "pageInfo": {
    "pageIndex": 1,
    "pageSize": 20,
    "sortField": "InDate",
    "sortType": "Desc"
  }
}

回复文件主体

属性	格式	描述
ACoS	Decimal	投入产出比：商品花费 / 销售额
activeStatus	Enum	有效值： Active 启用：查询处理中、正在投放、已超预算状态的数据 Inactive 暂停：查询暂停和已结束状态的数据
bid	Decimal	与关键词相关联的出价
campaignName	String	与关键词相关联的广告活动名称
campaignNumber	Integer	与关键词相关联的广告活动标识编号
clicks	Integer	关键词获得的点击次数
competition	Enum	竞争类型。有效值： Low 低 Medium 中 High 高
cpc	Decimal	每次点击费用
cr	Decimal	转化率
ctr	Decimal	点击率：商品的点击次数 / 广告活动曝光量
declineReason	String	广告活动被拒绝原因
groupNumber	Integer	关键词相关联的广告组标识编号
groupName	String	关键词相关联的广告组名称
impressions	Integer	关键词被展示次数
inDate	String	关键词创建日期
inUser	String	关键词创建用户ID
keyword	String	与搜索查询匹配的文本
keywordUrl	String	在新蛋网站上的关键词URL
matchType	Integer	匹配类型。有效值： 0：Exact 精确 1：Broad 广泛 6：Phrase 短语
normalizedKeyword	String	标准化关键词
orders	Integer	关键词订单数量
sales	Decimal	关键词销售额
searchVolume	String	关键词搜索量
spend	Decimal	关键词花费金额
status	String	广告活动状态描述有效值： Pending 待审核 Delivering 正在投放 Processing 处理中 Out of budget 已超预算 Inactive 已暂停 Ended 已结束
suggBid	Decimal	建议出价
suggBidLowest	Decimal	建议最高出价
suggBidMost	Decimal	建议最低出价
totalRows	Integer	记录总数

示例：Json，Request

{
  "header": [
    {
      "msg": "query keywords success!",
      "bizCode": "200"
    }
  ],
  "rows": [
    {
      "campaignNumber": 0,
      "campaignName": null,
      "groupNumber": 0,
      "groupName": null,
      "keyword": "test manufacturer",
      "matchType": 1,
      "normalizedKeyword": "manufacture|test",
      "keywordUrl": "https://www.newegg.com/p/pl?d=test manufacturer",
      "suggBid": 0.4,
      "suggBidLowest": 0.4,
      "suggBidMost": 0.5,
      "searchVolume": "NA",
      "competition": "Low",
      "bid": 0.1,
      "userId": null,
      "userName": null,
      "activeStatus": "Active",
      "status": "Delivering",
      "declineReason": null,
      "inDate": "Tue Feb 08 14:17:38 PST 2022",
      "inUser": "28740045",
      "costModel": null,
      "spend": 0,
      "sales": 0,
      "acos": 0,
      "impressions": 0,
      "clicks": 0,
      "ctr": 0,
      "orders": 0,
      "cr": 0,
      "cpc": 0
    }
  ],
  "totalRows": 1
}

更新日期：10/03/2022

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

关键词绩效报告

相关URL

参数

相关请求信息

请求文件主体

回复文件主体