基础文档
目录
二、接入说明：如何获取并套件、如何实现后台及接口配置、商业跟踪说明
三、如何申请：定向开放
------------
商详套件优势：
1、媒体端内即可CPS跟踪。即点开此商详页就实现跟踪，跟踪前置，大大降低跳转至手淘后再跟踪的折损
2、媒体端内完成优惠领取。支持媒体端内无需跳转，即可完成优惠券、红包等优惠领取，且引导去购买时系统也可帮助用户完成优惠领取
3、媒体端内实现商品加购。加购后商品同步至手淘购物车，即可保存用户购物意愿，又可实现商品加购跟踪，即使用户直接在手淘购物车内下单，也可实现跟踪结算
4、媒体端内完整SKU查看。不跳出媒体端，即可进行完整的SKU及对应优惠后价格的查看，提高消费者浏览效率和完整性
5、媒体端内商品详情等完整信息查看。详细信息在不跳出端的场景下，实现端内“逛”的环境，降低跳转折损
------------
一、版本介绍
媒体商品详情页定义：消费者在媒体APP端内，浏览和了解商品详情信息的购物工具，支持媒体根据自身业务需要，自定义相关消费者购物引导内容。
媒体商品详情页，根据媒体业务形态，共分三个版本：导购版本、返利版本、渠道管理版本。媒体可根据业务需要，可申请对应的一个或多个版本。
三个版本核心差异点：到手价优惠模块、底部加购&购买模块
| 导购版本 | 返利版本 | 渠道管理版本 |
 |
 |
 |
导购版商品详情页：适用于常规导购媒体，推广商品时为消费者提供或展示优惠信息：目前主要可展现优惠券、(淘礼金)红包。
①重点模块详解-顶部购物车入口
作为购物车入口，可点击跳转至购物车页面，媒体自定义是否展现该入口（唤醒至手淘内购物车页）【此模块在百川媒体后台配置】
②重点模块详解-价格优惠区块
- “到手价约”是根据商品的淘宝/天猫在线价格(上图示为“全款预售¥32.8”)，减去相应红包、优惠券金额之后自动结算的结果；如果该商品存在多个SKU，页面上默认显示淘宝搜索结果页的价格，相关优惠按照该价格核算；若展开SKU选择页，则会根据所选的具体SKU，核算对应优惠内容；
- 距结束时间：根据红包和优惠券，最先使用结束时间为准。若1天内会展示“时/分/秒”，超过1天则会显示天数；
- 专享红包：目前仅支持淘礼金红包，文案名称可自定义，媒体可定义是否给该消费者展示淘礼金红包。注意：1)若该页面入参pid与创建淘礼金红包的pid不一致，则红包不展示，2)如果淘礼金红包已经被领完，则红包不展示。【此模块为接口配置】
- 优惠券：目前支持店铺公开优惠券、阿里妈妈推广券的展示。媒体可指定优先展示的券id，若有指定，则指定券优先展示(使用门槛需满足当前页面价格，若不满足门槛则会放在多张券里展示)，其次为联盟推荐当前最优券，再其次为当前该商品最小满减门槛的券面额【此模块为接口配置】
- 提示：提示文案媒体可自定义，计算小贴士是跳转到媒体自定义的优惠说明页面，需在页面中，告知消费者优惠获取及价格说明(要求是H5静态页面)【此模块在百川媒体后台配置】
- 媒体名称：展示媒体名称【此模块在百川媒体后台配置】
- （注意：若淘礼金红包、优惠券都没有，则该区块会自动不展示，若红包或优惠券其中一个没有，正常展示该模块）
③重点模块详解-店铺模块
按钮“进店逛逛”，作为店铺浏览页入口，可跳转至店铺首页（默认唤醒手淘店铺首页），媒体可选择是否展现该入口【此模块在百川媒体后台配置】
④重点模块详解-商品推荐模块
“看了又看”中的推荐商品均为CPS商品，当前推荐方式为：个性化推荐
商品对应优惠信息，支持媒体动态传参【此模块为接口配置】
⑤重点模块详解-底部操作按钮
- 自定义icon(图示“首页”)：媒体可自行决定是否展示该按钮及可配置对应跳转页面(可以是url或者是媒体APP的原生页面)【此模块在百川媒体后台配置】
- 分享icon：媒体可自行决定是否展示该按钮及可配置对应跳转的媒体端内分享页面(可以是url或者是媒体APP的原生页面)【此模块在百川媒体后台配置】
- 加入购物车按钮：媒体可自行决定是否展示该按钮，若配置，则消费者可点击将商品加入淘宝购物车【此模块在百川媒体后台配置】
- 去淘宝购买按钮：点击后唤醒至手淘商品详情页
- (注意：消费者点击“加入购物车”或“去淘宝购买”，系统会帮消费者一键领取当前页相关红包和券)
返利版商品详情页：适用于消费者购买一定返利的媒体，推广商品时为消费者提供或展示优惠信息：目前主要可展现优惠券、(淘礼金)红包、返利信息。
①重点模块详解-顶部购物车入口
作为购物车入口，可点击跳转至购物车页面，媒体自定义是否展现该入口（唤醒至手淘内购物车页）【此模块在百川媒体后台配置】
②重点模块详解-价格优惠区块
- “到手价约”是根据商品的淘宝/天猫在线价格，减去相应红包、优惠券金额、返利金额(注意返利金额是否减掉由媒体自定义配置)之后自动结算的结果【此模块在百川媒体后台配置】
- 距结束时间：根据红包和优惠券，最先使用结束时间为准。若1天内会展示“时/分/秒”，超过1天则会显示天数；
- 专享红包：目前仅支持淘礼金红包，文案名称可自定义，媒体可定义是否给该消费者展示淘礼金红包。注意：1)若该页面入参pid与创建淘礼金红包的pid不一致，则红包不展示，2)如果淘礼金红包已经被领完，则红包不展示。【此模块为接口配置】
- 优惠券：目前支持店铺公开优惠券、阿里妈妈推广券的展示。媒体可指定优先展示的券id，若有指定，则指定券优先展示(使用门槛需满足当前页面价格，若不满足门槛则会放在多张券里展示)，其次为联盟推荐当前最优券，再其次为当前该商品最小满减门槛的券面额【此模块为接口配置】
- 返利金额：展示返利金额和返利比率 [返利金额=(商品价格-当前价格可使用的最优券金额)*返利比率] ，由媒体根据消费者自定义返利比率，页面展示数字以按比例计算后直接舍弃两位小数后的位数的方式【此模块为接口配置】
- 提示：提示文案媒体可自定义，计算小贴士是跳转到媒体自定义的优惠说明页面，需在页面中，告知消费者优惠获取及价格说明(要求是H5静态页面)【此模块在百川媒体后台配置】
- 媒体名称：展示媒体名称【此模块在百川媒体后台配置】
- （注意：若淘礼金红包、优惠券都没有，则该区块会自动不展示，若红包或优惠券其中一个没有，正常展示该模块）
③重点模块详解-店铺模块
按钮“进店逛逛”，作为店铺浏览页入口，可跳转至店铺对应页面，媒体可选择是否展现该入口（默认唤醒手淘店铺对应页面）【此模块在百川媒体后台配置】
④重点模块详解-商品推荐模块
“看了又看”中的推荐商品均为CPS商品，当前推荐方式为：个性化推荐
商品对应优惠信息，支持媒体动态传参【此模块为接口配置】
⑤重点模块详解-底部操作按钮
- 自定义icon：媒体可自行决定是否展示该按钮，若配置，则跳转至对应配置页面(可以是url或者是媒体APP的原生页面)【此模块在百川媒体后台配置】
- 分享icon：媒体可自行决定是否展示该按钮，若配置，则跳转至对应配置的媒体分享页面(可以是url或者是媒体APP的原生页面)【此模块在百川媒体后台配置】
- 加入购物车按钮：媒体可自行决定是否展示该按钮，若配置，则消费者可点击将商品加入淘宝购物车【此模块在百川媒体后台配置】
- 去淘宝购买按钮：点击后唤醒手淘商品详情页【此模块在百川媒体后台配置】
- (注意：消费者点击“加入购物车”或“去淘宝购买”，系统会帮消费者一键领取当前页相关红包和券)
渠道管理版商品详情页：适用于渠道管理中，合作方对渠道方的商品推荐，为渠道方提供或展示优惠信息以及渠道方推广可获取的收益：目前主要可展现优惠券、(淘礼金)红包、渠道方收益金额。
①重点模块详解-顶部购物车入口
作为购物车入口，可点击跳转至购物车页面，媒体自定义是否展现该入口（唤醒至手淘内购物车页）【此模块在百川媒体后台配置】
②重点模块详解-价格优惠区块
- “到手价约”是根据商品的淘宝/天猫在线价格，减去相应红包、优惠券金额、分享赚金额(注意分享赚金额是否减掉由媒体自定义配置)之后自动结算的结果【此模块在百川媒体后台配置】
- 距结束时间：根据红包和优惠券，最先使用结束时间为准。若1天内会展示“时/分/秒”，超过1天则会显示天数；
- 专享红包：目前仅支持淘礼金红包，文案名称可自定义，媒体可定义是否给该消费者展示淘礼金红包。注意：1)若该页面入参pid与创建淘礼金红包的pid不一致，则红包不展示，2)如果淘礼金红包已经被领完，则红包不展示。【此模块为接口配置】
- 优惠券：目前支持店铺公开优惠券、阿里妈妈推广券的展示。媒体可指定优先展示的券id，若有指定，则指定券优先展示(使用门槛需满足当前页面价格，若不满足门槛则会放在多张券里展示)，其次为联盟推荐当前最优券，再其次为当前该商品最小满减门槛的券面额【此模块为接口配置】
- 渠道方收益：即为渠道方推广可获得的收益，由媒体根据渠道方设置对应收益比率 [渠道收益金额=(商品价格-当前价格可使用的最优券金额)*渠道收益比率]，页面展示数字以按比例计算后直接舍弃两位小数后的位数的方式 【此模块为接口配置】，同时渠道方收益可跳转至媒体自定义链接内进行详细说明(要求是H5静态页面)【此模块在百川媒体后台配置】
- 提示：提示文案媒体可自定义，计算小贴士是跳转到媒体自定义的优惠说明页面，需在页面中，告知消费者优惠领取及价格说明(要求是H5静态页面)【此模块在百川媒体后台配置】
- 媒体名称：展示媒体名称【此配置在百川媒体后台的高级配置中】
- （注意：若淘礼金红包、优惠券都没有，则该区块会自动不展示，若红包或优惠券其中一个没有，正常展示该模块）
③重点模块详解-店铺模块
按钮“进店逛逛”，作为店铺浏览页入口，可跳转至店铺对应页面，媒体可选择是否展现该入口（默认唤醒手淘店铺对应页面）【此模块在百川媒体后台配置】
④重点模块详解-商品推荐模块
“看了又看”中的推荐商品均为CPS商品，当前推荐方式为：个性化推荐
商品对应优惠信息，支持媒体动态传参【此模块为接口配置】
⑤重点模块详解-底部操作按钮
- 自定义icon：媒体可自行决定是否展示该按钮，若配置，则跳转至对应配置页面(可以是url或者是媒体APP的原生页面)【此模块在百川媒体后台配置】
- 加入购物车按钮：媒体可自行决定是否展示该按钮，若配置，则消费者可点击将商品加入淘宝购物车【此模块在百川媒体后台配置】
- 去分享：点击跳转至媒体配置的分享页面(可以是url或者是媒体APP的原生页面)【此模块在百川媒体后台配置】
- 去淘宝购买按钮：点击后唤醒手淘商品详情页【此模块在百川媒体后台配置】
- (注意：消费者点击“加入购物车”或“去淘宝购买”，系统会帮消费者一键领取当前页相关红包和券)
二、接入说明
SDK及套件使用总流程
步骤① 开发者资格认证
开发者资格认证链路没有变化，已经入驻百川的媒体请跳过此步
步骤② 创建应用
已有百川appkey的应用无需新创建应用，可向平台运营提出旗舰版SDK下载申请（提供appkey信息），由百川平台定向开放入口后即可下载使用。
步骤③ 套件申请并选择版本
选择对应应用appkey，进行套件申请：媒体商品详情页(套件ID:99)
页面类型分三类，媒体业务需要选择对应版本，一次可以申请多个版本；
提交申请后将进入审核流程，在审核流程结束之前，无法发起新的审核流程，请等待；
重要说明：在选择前，请先复制链接，了解套件详细介绍。套件权限申请只能叠加，不能取消。
- 审核通过则会显示“查看套件页面”，若审核拒绝则恢复正常，可重新申请
步骤④ 版本配置管理
选择对应的商详版本，点击进入套件配置（注意：根据媒体申请且审核通过的版本，会在此处出现版本配置入口）
- 基础配置：点击页面中的“修改”按钮，打开配置修改。各按钮说明和示例图，可查看??（注意：如果底部自定义icon不展示，目前也需要配置文案和链接信息，但不会展示）
- 高级配置：高级配置为必须配置项。高级配置主要针对数据和页面联动的样式进行管理
(以下以导购版本举例。不同版本高级配置内容有所不同，以后台显示为准)
步骤⑤ 发布至线上
修改完成后点击“提交”按钮，相关的配置会提交运营审核。审核成功后，可发布至线上，也可以点击取消，重新发起修改配置完毕。
重要说明：发布至线上必须点击“发布”按钮，否则线上配置不会做任何修改。
2.媒体入参说明【接口配置】
2.1 AlibcTaokeParams跟踪相关参数
| 字段 |
说明 |
备注 |
| pid |
1.PID是淘客广告位； 2.取消了原来adzoneId + appkey的方式。 3.如果不传，则不进行会转链，采用原链接打开。 |
|
| relationId |
渠道id |
|
| materialSourceUrl |
官方物料来源url(s.click、uland) |
|
2.2 AlibcBizParams里的扩展参数(extParams)业务相关参数说明
在媒体打开媒体商品详情页业务上需要入参的说明列表
| 字段 |
是否必填 |
参数说明 |
| couponActivityId |
否 |
券id |
| vegasCode |
否 |
淘礼金vegas_code（淘礼金创建API(tbk_dg_vegas_tlj_create)I生成的返回字段中的vegas_code值），注意生成的淘礼金pid和打开详情页的pid需要保持一致，不然会导致淘礼金领取失败 |
| pageType |
是 |
媒体设置的当前页面类型：导购版本为guide、渠道管理版本为agent、返利版本为rebate |
| flRate |
如返利版必填 |
当前用户返利比例，乘以10000后小数点可保留6位，例如：33.33333333%可以传入3333.333333 |
| dlRate |
如渠道管理版必填 |
当前用户渠道比例，乘以10000后小数点可保留6位，例如：33.33333333%可以传入3333.333333 |
| maxDlRate |
否 |
当前用户最高渠道比例，乘以10000后小数点可保留6位，例如：33.33333333%可以传入3333.333333 |
| 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.商业逻辑说明
该媒体商品详情页支持转链跟踪。
转链计划为该媒体对应账号下，当前最优转链逻辑。
三、接入说明
试用期，暂不开放申请。以邀请制为准。
四、FAQ
Q：一个appkey应用，可以同时获得多个商品详情页的版本吗？审核时间长吗？
A：可以申请，但平台会根据媒体对应已有功能进行审批。目前导购版本不做限制，返利版本仅支持具备会员运营管理权限的媒体对应淘宝客账号申请，渠道管理版本仅支持具备渠道管理权限的媒体对应淘宝账号申请。当前为人工审核，会尽可能保证按周审核完毕。
Q：如果更换同一个账号下的百川appkey，媒体商品详情页功能还能用吗？
A：如果更换的appkey并无商品详情页套件权限，则功能不能调用，点击商品时会自动唤醒到手淘的商品详情页，所以请务必核对好appkey。
Q：媒体商品详情页，和淘宝商品详情页有什么区别？
A：媒体商品详情页，是指可在媒体端内打开展示的商品详情页，此页面更适合媒体推广需要，为消费者做购前参考，页面上会提供定制优惠区块对消费者进行优惠展示和操作提示，同时推荐商品均为淘宝客商品。此商品详情页可实现淘宝客跟踪。
Q：媒体商品详情页，支持天猫、天猫国际、聚划算、天猫超市、飞猪等商品，以及预售类商品的展示吗？
A：本商品详情页，支持天猫商品、天猫国际、聚划算、淘抢购、天猫超市的商品样式展示，含预售状态，但目前还不支持飞猪商品的展示；若媒体推广飞猪商品，在百川SDK环节下，会引导至手淘端内浏览飞猪商品。
Q：优惠区块，展示逻辑是什么样子的？
A：不同版本提示的优惠内容不同。具体说明如下：
- 导购版本：“淘礼金红包+优惠券”的展示，媒体可自行决定是否对该消费者展现淘礼金红包，若无红包，则红包部分不显示；媒体可自行决定是否指定优惠券展示，如有则指定优惠券优先展示，若无则联盟提供该商品当前SKU下最优优惠券展示。
- 返利版本：“淘礼金红包+优惠券”的展示逻辑，同导购版本。返利版本增加返利金额和比率的透出，媒体可在套件配置的高级配置去内，选择到手价是否包含返利金额。
- 渠道管理版本：“淘礼金红包+优惠券”的展示逻辑，同导购版本。渠道管理版本增加渠道方分享所赚金额的透出，媒体可在套件配置的高级配置去内，选择到手价是否包含渠道分享所赚金额。
Q：媒体配置后台，是可以随时修改的吗？
A：媒体基础配置部分，如果有调整，会进入审核环节，高级配置部分，若修改则不需要审核。修改完成，媒体确认修改参数无误后，必须点击“发布”按钮，才会在线上生效。在点击发布前，可以随时修改信息。