电商服务
目录
一、版本介绍：导购版本、返利版本、与“百川商品详情页套件”联动点
二、接入说明：如何获取并套件、如何实现后台及接口配置、商业跟踪说明
三、如何申请：定向开放
一、版本介绍
媒体私域购物车定义：消费者在媒体APP端浏览商品时用于临时存储所选商品，并可实现批量下单的购物工具，支持媒体根据自身业务需要，自定义相关消费者购物引导内容。
媒体私域购物车，根据媒体业务形态，共分两个版本：导购版本、返利版本。媒体可根据业务需要，可申请对应的一个或多个版本（渠道管理可根据媒体自行业务需要使用任一版本）。
导购版私域购物车：适用于常规导购媒体，在私域购物车内可为消费者提供或展示商品相关优惠信息：目前主要可展现优惠券、(淘礼金)红包。
①重点模块详解-总优惠区块
总优惠金额：当前私域购物车内商品总优惠，系统会根据购物车内商品的红包、券（注意：因系统性能原因，目前仅支持第一分页前20个商品对应的优惠汇总计算）
优惠文案提示：提示文案可自定义，同时详细的优惠优惠获取及价格说明可在自定义的配置页内告知消费者【此模块在百川媒体后台配置】
②重点模块详解-商品优惠区块
商品优惠：对于私域购物车内的每个商品，媒体都可为消费者提示相应优惠信息，其中包含淘礼金红包(若有)、优惠券(若有)，优惠均可根据消费者进行指定，消费者看到的是总优惠，需“点击领取”，若已经领取，则提示为“下单立减”【此模块为接口配置】
③重点模块详解-批量下单
支持对私域购物车内商品，进行批量下单（注意：商品优惠需要消费者自己领取，结算时不支持自动帮消费者领取）
④重点模块详解-相似推荐
相似推荐：跳转是该商品的相似推荐页面。相似推荐页内商品，均为淘宝客商品。
商品对应优惠信息，支持媒体动态传参【此模块为接口配置】
⑤重点模块详解-商品推荐模块
“看了又看”中的推荐商品均为CPS商品，当前推荐方式为：个性化推荐
商品对应优惠信息，支持媒体动态传参【此模块为接口配置】
返利版商品详情页：适用于消费者购买一定返利的媒体，在私域购物车内可为消费者提供或展示商品相关优惠信息：目前主要可展现优惠券、(淘礼金)红包、返利信息。
①重点模块详解-总优惠区块
总优惠金额：当前私域购物车内商品总优惠，系统会根据购物车内商品的红包、券、返利(返利是否计算在内，由媒体商品详情页的设置决定)（注意：因系统性能原因，目前仅支持第一分页商品对应的优惠汇总计算）【此模块在百川媒体后台配置】
优惠文案提示：提示文案可自定义，同时详细的优惠优惠获取及价格说明可在自定义的配置页内告知消费者。
②重点模块详解-商品优惠区块
商品优惠：对于私域购物车内的每个商品，媒体都可为消费者提示相应优惠信息，其中包含淘礼金红包(若有)、优惠券(若有)、对应返利金额，优惠均可根据消费者进行指定，红包和券归拢为点击可领取的优惠总额，需要消费者点击领取【此模块为接口配置】
③重点模块详解-批量下单
支持对私域购物车内商品，进行批量下单，在点击“结算时”会自动帮助消费者完成所选商品对应优货(红包和券)的领取。
④重点模块详解-相似推荐
相似推荐：跳转是该商品的相似推荐页面。相似推荐页内商品，均为淘宝客商品。
⑤重点模块详解-商品推荐模块
“看了又看”中的推荐商品均为CPS商品，当前推荐方式为：个性化推荐
商品对应优惠信息，支持媒体动态传参【此模块为接口配置】
①商品详情页顶部“购物车入口”，如果有私域购物车权限，则会自动从唤醒手淘购物车，调整为跳转至媒体APP端内的“私域购物车”页面
②商品详情页底部“加入购物车”按钮，消费者将商品点击加入购物车后，私域购物车内，就会出现该加购的商品。
二、接入说明
SDK及套件使用总流程：
步骤① 开发者资格认证
开发者资格认证链路没有变化，已经入驻百川的媒体请跳过此步
步骤② 创建应用
已有百川appkey的应用无需新创建应用，可向平台运营提出旗舰版SDK下载申请（提供appkey信息），由百川平台进行数据订正后即可下载使用。
（测试期appkey已经默认开通，可直接下载旗舰版SDK）
步骤③ 套件申请并选择版本
选择对应应用appkey，进行套件申请：媒体商品详情页(套件ID:99)
页面类型分三类，媒体业务需要选择对应版本，一次可以申请多个版本；
提交申请后将进入审核流程，在审核流程结束之前，无法发起新的审核流程，请等待；
重要说明：在选择前，请先复制链接，了解套件详细介绍。套件权限申请只能叠加，不能取消。
步骤④ 版本配置管理
选择对应的商详版本，点击进入套件配置（注意：根据媒体申请且审核通过的版本，会在此处出现版本配置入口）
- 高级配置：点击页面中的“修改”按钮，然后打开高级配置
步骤⑤ 发布至线上
修改完成后点击“提交”按钮，相关的配置会提交运营审核。审核成功后，可发布至线上，也可以点击取消，重新发起修改配置完毕。
重要说明：发布至线上必须点击“发布”按钮，否则线上配置不会做任何修改。
2.媒体入参说明【接口配置】
2.1 AlibcTaokeParams跟踪相关参数
| 字段 |
说明 |
备注 |
| pid |
1.PID是淘客广告位； 2.取消了原来adzoneId + appkey的方式。 3.如果不传，则不进行会转链，采用原链接打开。 |
|
| relationId |
渠道id |
|
2.2 AlibcBizParams里的扩展参数(extParams)业务相关参数说明
在媒体打开媒体商品详情页业务上需要入参的说明列表
| 字段 |
是否必填 |
参数说明 |
| isvUserId |
否 |
媒体上下文用户参数（便于媒体决策版本和入参），用于奇门服务端交互 |
媒体商品详情页内展示的商品推荐模块，其中的商品点击时需要跳转回媒体商品商详页。目前商详页支持媒体自定义展示券ID，渠道收益／会员返利比率，淘礼金红包ID等信息，因此需要在商品区块中支持媒体为特定商品itemid指定相关自定义的信息。（强烈建议媒体将服务部署在聚石塔张北区域，服务性能相比其他方式对接，提升极为明显，平均对接约在20毫秒内）
- 服务端交互流图：
- 系统调用时序图
- 媒体接入奇门流程图
-
奇门接口名称：taobao.tbk.item.rule.get
-
场景：淘宝客
- 接入帮助文档：开发与实现接口，参考官方文档：https://open.taobao.com/doc.htm?docId=108958&docType=1
-
奇门后台使用流程示例：
联系联盟运营添加百川appkey的授权后登录qimen.taobao.com，在 云工作台-> 官方集成->官方集成(新) 下可找到名为淘宝客的场景。
进入该场景，查看接口文档，文档理解清楚后点 “接入”。
-
媒体服务稳定性说明：媒体商详页直接影响用户的浏览体验，因此需要媒体保障提供服务的稳定性，以免对用户体验造成影响。因此需要媒体配合做以下几件事情：
- 性能上：商品规则计算逻辑尽量保持简单，做到服务接口能在100ms内返回。同时仔细评估接口qps，做好压测，并准备充足的机器资源。
- 部署上：尽量在北京／张北区域，与联盟整体地域相近，调用能降低网络延迟。
- 如果是自建机房最好能往阿里云或者聚石塔上迁移，避免由于自身机房的网络延迟／带宽问题造成的服务故障。
3.商业逻辑说明
凡私域购物车内商品，因是媒体APP端内加购引导，故只要在媒体私域购物车内下单,（商品当下仍为淘宝客商品时)均可实现跟踪结算。
转链计划为该媒体对应账号下，当前最优转链逻辑。
三、接入说明
试用期，暂不开放申请。以邀请制为准。
四、FAQ
Q：一个appkey应用，可以同时获得多个媒体私域购物车的版本吗？审核时间长吗？
A：可以申请，但平台会根据媒体对应已有功能进行审批。导购版本支持常规导购媒体申请，返利版本仅支持具备会员运营管理权限的媒体对应淘宝客账号申请。当前为人工审核，会尽可能保证按周审核完毕。
Q：媒体私域购物车，和淘宝购物车有什么区别？
A：媒体私域购物车，是指可在媒体端内打开展示的购物车，此购物车内商品，仅支持在媒体端内加购的商品；淘宝购物车为消费者全部加购商品。即私域购物车是淘宝购物车的一部分。私域购物车商品最多可加购数量，以淘宝购物车商品数为上限。媒体可对私域购物车内的商品，进行消费者营销，促进消费者购买。
Q：媒体私域购物车，跟踪逻辑？
A：凡私域购物车内商品，因是媒体端内加购引导，故只要在媒体私域购物车内下单,（商品当下仍为淘宝客时)均可实现跟踪结算。
Q：商品优惠区块，展示逻辑是什么样子的？
A：不同版本提示的优惠内容不同。具体说明如下：
- 导购版本：“淘礼金红包+优惠券”的展示，媒体可自行决定是否对该消费者展现淘礼金红包，若无红包，则红包部分不显示；媒体可自行决定是否指定优惠券展示，如有则指定优惠券优先展示，若无则联盟提供该商品当前SKU下最优优惠券展示。消费者可一键领取对应优惠，或在下单时也会帮助消费者一键领取当前可获得的优惠(红包&券)。
- 返利版本：“淘礼金红包+优惠券”的展示逻辑，同导购版本。返利版本增加返利金额和比率的透出。消费者可一键领取对应优惠(红包&券)，或在下单时也会帮助消费者一键领取当前可获得的优惠(红包&券)。
Q：媒体配置后台，是可以随时修改的吗？
A：私域购物车的后台配置，需要点击发布后生效，接口参数配置为实时对接和生效。