开发人员参考
一 解决方案接入流程
1、本方案仅支持英语,见API中的枚举;
2、开放平台JAVA版本SDK下载链接,请下载该SDK来接入1688开放平台:
3、JAVA版本SDK使用说明:
4、授权方式说明:使用【2、多用户授权】
5、如何接入【用户行为收集】接口。参考以下方式。
第一步:提供机构的appKey给到1688运营或者对接的技术同学,由1688侧配置页面打点标识SPM,然后将配置值提供给机构对接人;
第二步:在前端HTML页面接入以下JS,填入当前机构的appKey、当前页面的pageKey(服务商提供)、机构的userId等。如下:
<script>
window.__1688_LOGGER_CONFIG={
appKey: 'test_01', // 应用对应的appKey
pageKey: 'order_detail', // 页面唯一标识符
userId: 'abc123' // 用户ID
}
</script>
第三步:行动点上报。在 html 元素上增加 data-logger-action-type,值为事件名称。如下:
<button data-logger-action-type="fxg_action_type_test">元素事件点击发送</button>
第四步:商品卡片点击&曝光。在 html 元素上增加两个值,data-tracker="offer"这个为固定值,另外一个为商品卡片相关数据的值,data-aplus-report,值为接口返回的 traceInfo(具体服务端接口中有描述,如词搜、图搜、商品详情等接口)。如下:
<div
data-tracker="offer"
data-aplus-report="object_id@669466877052^object_type@offer">
曝光+点击测试
</div>
二 商机货盘枚举
商机货盘有通过词搜接口承载,传此参数需要通过运营同学申请商机货盘权限,开通后方可正常访问
枚举 | 含义 |
westernYoungster | 欧美年轻人喜爱的品类货盘 |
amazonTailored | 定向亚马逊销售的货盘 |
TW-台湾;RU-俄罗斯;VN-越南;KR-韩国 或者 krOpp-韩国;JP-日本 或者 jpOpp-日本;AE-阿联酋;US-美国;GB-英国;NG-尼日利亚;MO-澳门;TH-泰国;ID-印尼;FR-法国;HK-香港;ES-西班牙;MX-墨西哥;AR-阿根廷;ZA-南非;BR-巴西;CL-智利;PE-秘鲁;KE-肯尼亚;SA-沙特阿拉伯 | 国家或地区维度商机货盘 |
508235 | TM爆品1688同款货盘 |
171159309 | 春节不打烊 |
173372338 | 近一年动销货盘 |
三 搜索筛选枚举
参数示例:filter传入"shipIn24Hours,shipIn48Hours",多个条件英文逗号分割;
枚举值:
筛选归属 | 筛选指标 | 类型详情 | 外部传参定义 |
履约质量 | 综合体验分 | 5星 | totalEpScoreLv1 |
4.5星-5.0星 | totalEpScoreLv2 | ||
4星-4.5星 | totalEpScoreLv3 | ||
4星以下 | totalEpScoreLv4 | ||
认证工厂 | 是否 | certifiedFactory | |
24小时揽收率 | <95% | getRate24HLv1 | |
>=95% | getRate24HLv2 | ||
>=99% | getRate24HLv3 | ||
48小时揽收率 | <95% | getRate48HLv1 | |
>=95% | getRate48HLv2 | ||
>=99% | getRate48HLv3 | ||
履约保障 | 当日发货 | 是否 | shipInToday |
严选 | 是否 | 1688Selection | |
分销严选 | 是否 | jxhy | |
24小时发货 | 是否 | shipIn24Hours | |
48小时发货 | 是否 | shipIn48Hours | |
7天无理由 | 是否 | noReason7DReturn | |
支持一件代发 | 是否 | isOnePsale | |
支持包邮(一件代发包邮) | 是否 | isOnePsaleFreePost | |
7天上新 | 是否 | new7 | |
30天上新 | 是否 | new30 | |
全球严选 | 是否 | isQqyx | |
跨境select货盘 | 是否 | isSelect | |
排除不宜销售 | 排除日本不宜销售商品 | 是否 | JPFL |
排除美国不宜销售商品 | 是否 | USFL | |
排除韩国不宜销售商品 | 是否 | KRFL | |
排除越南不宜销售商品 | 是否 | VNFL | |
排除沙特阿拉伯不宜销售商品 | 是否 | SAFL | |
排除东欧不宜销售商品 | 是否 | RUFL | |
排除哈萨克斯坦不宜销售商品 | 是否 | KZFL | |
排除中国香港不宜销售商品 | 是否 | HKFL | |
排除中国澳门不宜销售商品 | 是否 | MOFL | |
排除中国台湾不宜销售商品 | 是否 | TWFL |
四 语言枚举
目前语言是通过country入参
语言 | 枚举 |
英语 | en |
日语 | ja |
韩语 | ko |
俄罗斯语 | ru |
越南语 | vi |
西班牙语 | es |
五、榜单rankType支持的字段
complex综合榜,hot热销榜,goodPrice好价榜,anchorHot主播热卖榜,anchorNew主播新兴榜,anchorRecommend主播热推榜,VNHot越南热销榜,VNTrend越南趋势榜
六、TagInfo枚举
商品详情tagInfoList枚举,字段存在且值为true,则表明商品支持此服务
枚举 | 解释 |
isOnePsale | 一件代发 |
isOnePsaleFreePostage | 一件代发包邮 |
isSupportMix | 混批 |
noReason7DReturn | 7天无理由退货 |
1688_yx | 1688严选 |
new7 | 7天上新 |
new30 | 30天上新 |
isQqyx | 全球严选 |
select | 跨境select货盘 |
推荐
-
-
QQ空间
-
新浪微博
-
人人网
-
豆瓣