Item Best Matches 转化率分析_新更新

Item Best Matches 转化率分析

发布时间：2017-07-06 最近刷新时间：2019-07-18

示例

请注意：示例中的刊登ID和用户ID可能在eBay已经失效，请替换为有效数据。

描述

本数据每24小时刷新。为你筛选出您账户下24小时内的潜力刊登（即该刊登在Best Match排名前20的曝光次数达到一定值），并提供对应这些刊登的曝光量（Impression），浏览量（View Item），成交量（Transaction），对应曝光量高的关键字，对应浏览、成交的流量来源，Watch数量等。

输入数据

资源路径
GET /gccbtapi/v1/item_best_matches

其它设置参见“eBay大中华卖家API简介”首页中“其他通用设置”的描述。

其他通用设置

• HTTP请求头

所有发送到eBay REST服务的请求都需要提供authorization请求头以获取验证信息。 Authorization请求头的格式为：Bearer + 空格 + Token。具体详情请参考： HTTP request headers

• OAuth请求域和Token

eBay开发了一套新的Global API，并使用了新的OAuth Token。请注意，这和Trading API的Token是不兼容的，Trading API的Token不能用于访问新的API。关于如何获取新的OAuth Token，请参考：Getting Access Tokens

另一个需要注意的是：新的Token中授权了用户可以访问的范围，这个范围eBay称之为scope（域），用户只能访问token中指定scope的资源，否则会返回错误。参数scope在申请授权码的时候指定，用户登录授权之后，应用根据授权码拿到新的Token，此时这些scopes就隐藏在Token之中了。

访问ItemBestMatches服务，需要用户的访问Token至少包含这个域： https://api.ebay.com/oauth/api_scope/sell.analytics.readonly

* 常见错误信息

请求参数

ItemBestMatches服务接受以下参数：

参数名称	参数类型	参数是否必需	解释
dateRange	string	必需	YYYYMMDD..YYYYMMDD
categoryL1	Integer	可选	品类ID
categoryL2	Integer	可选	品类ID
categoryL3	Integer	可选	品类ID
categoryLeaf	Integer	可选	品类ID
siteIds	string	可选	站点ID，如果有多个值，请用"\|"分开. 比如 "0\|3\|71"。
listingIds	string	可选	刊登ID序列，如果有多个值，请用 "\|"分开. 比如 "123231\|123432432\|2343243"。
pageNum	Integer	可选	分页的第几页，默认是1。
pageSize	Integer	可选	分页的每页大小，默认是25，大值是500，小值是1。

ItemBestMatches服务支持以下参数组合：

Seller ID (从Token中获取)+ dateRange
Seller ID + siteIds + dateRange
Seller ID + siteIds + Category L1,L2,L3,Leaf + dateRange
Seller ID + listingIds + dateRange

请注意：在Category L1,L2,L3或Leaf有多个存在的情况下，我们只取后一级。比如参数中有L1和L2，则我们只取L2；参数中有L2和L3，则我们只取L3。

输出

如果查询成功，将返回卖家各刊登的相关转化率数据。

信息类型	字段名	描述
基本信息	WATCH_COUNT	把刊登加关注(watch)的用户数量。如果用户取消关注此刊登，则watch数量会相应减少。
	PRICE	对应刊登的一口价价格，对应的货币单位与刊登所在站点一致，如美国站:USD,英国站:GBP,德国站:EUR,澳大利亚站:AUD等
	calDate	按照您查询的dateRange，以天为单位标记返回的刊登数据。时间格式为long型时间格式，对应GMT时间（下同）
曝光量/Impression相关	SRP_CNT	24小时内排在Best Match前20的曝光次数
	TOP3_CNT	24小时内排在Best Match前3的曝光次数
	TOP10_CNT	24小时内排在Best Match前10的曝光次数
	TOP_KEYWORD_1	对应BM排名的占曝光量高的3个关键字，及曝光次数
	TOP_KEYWORD_TRAFFIC_1
	TOP_KEYWORD_2
	TOP_KEYWORD_TRAFFIC_2
	TOP_KEYWORD_3
	TOP_KEYWORD_TRAFFIC_3
浏览量/View Item相关	VI_NONBOT_HITS	浏览量
	VI_SRP	来自BM的浏览量
	VI_Direct_Click_eBay	来自直接点击的浏览量-deal。
	VI_Other_Source	来其他渠道的浏览量，包括搜索引擎、邮件促销、社交网络等
	VI_PC	来自PC端的浏览量
	VI_Portable	来自移动端的浏览量
成交量/Transaction相关	CK_NONBOT_HITS	成交量：由同一天曝光量直接转化的成交量（不包括非同一天添加的购物车付款，付款时页面发生跳转等情况）
	CK_SRP	来自BM的成交量
	CK_Direct_Click_eBay	来自直接点击的成交量
	CK_Other_Source	来其他渠道的成交量量，包括搜索引擎、邮件促销、社交网络等
	CK_PC	来自PC端的成交量
	CK_Portable	来自移动端的成交量

如果查询成功但data是空数组或没值，则可能是我们目前对该用户没有数据支持。

响应字段描述

输出字段	类型	出现频率	含义
ackValue	string	总是出现	SUCCESS 或 FAILURE
errorMessage	object	有时出现	如果发生异常或请求错误，就可能看到errorMessage字段。 "errorMessage": { "error": [ { "errorId": 1001, "domain": "PARAMETER", "category": "REQUEST", "message": "Parameter dateRange is missing", "longMessage": "Parameter dateRange is missing", "actionToTake": "CORRECTINPUTDATA" } ] }
timestamp	long	总是出现	响应的服务器时间
data	array	有时出现	请求成功，并且有数据，这个字段应该是个数组。否则可能返回null。

响应举例

{
    "ackValue": "SUCCESS",
    "statusCode": 200,
    "timeStamp": 1487051583102,
    "data": [
        {
            "bestMatchId": 5001899130,
            "userSlctdId": "external_api_buyer",
            "userId": 133300946,
            "itemId": 310751194469,
            "metaCategId": 293,
            "categLvl2Id": 3270,
            "categLvl3Id": 48610,
            "leafCategId": 75389,
            "watchCount": 473,
            "price": 12.4,
            "itemSiteId": 0,
            "srpCnt": 170,
            "top3Cnt": 22,
            "***0Cnt": 148,
            "topKeyword1": "PARKING SENSOR",
            "topKeywordTraffic1": 24,
            "topKeyword2": "REVERSE SENSOR",
            "topKeywordTraffic2": 14,
            "topKeyword3": null,
            "topKeywordTraffic3": 0,
            "viNonbotHits": 22,
            "viSrp": 17,
            "viDirectClickEbay": 3,
            "viOtherSource": 2,
            "viPc": 7,
            "viPortable": 15,
            "ckNonbotHits": 1,
            "ckSrp": 0,
            "ckDirectClickEbay": 0,
            "ckOtherSource": 1,
            "ckPc": 1,
           "ckPortable": 0,
            "calDate": 1480748400000,
        },
        {
            "bestMatchId": 5000025171,
            "userSlctdId": "external_api_buyer",
            "userId": 133300946,
            "itemId": 201705671029,
            "metaCategId": 619,
            "categLvl2Id": 16212,
            "categLvl3Id": 182138,
            "leafCategId": 182146,
            "watchCount": 0,
            "price": 8.7,
            "itemSiteId": 0,
            "srpCnt": 2,
            "top3Cnt": 0,
            "***0Cnt": 1,
            "topKeyword1": "ALTO TROMBONE",
            "topKeywordTraffic1": 1,
            "topKeyword2": "TROMBONE MOUTHPIECE",
            "topKeywordTraffic2": 1,
            "topKeyword3": null,
            "topKeywordTraffic3": 0,
            "viNonbotHits": 0,
            "viSrp": 0,
            "viDirectClickEbay": 0,
            "viOtherSource": 0,
            "viPc": 0,
            "viPortable": 0,
            "ckNonbotHits": 0,
            "ckSrp": 0,
            "ckDirectClickEbay": 0,
            "ckOtherSource": 0,
            "ckPc": 0,
            "ckPortable": 0,
            "calDate": 1482649200000,
        }
    ],
    "pageNum": 1,
    "pageSize": 2,
    "entriesTotal": 1117,
    "pageTotal": 559
}

开发者专区

描述