电商服务
百川SDK升级FAQ
百川SDK升级，请先查看百川SDK升级指南，更多问题咨询百川小开
百川通用问题FAQ
1、新百川SDK进行了哪些升级?
新百川SDK针对用户的安全隐私进行了全面加固，保障了用户使用电商功能服务时隐私的安全性。
2 、老百川SDK不升级有影响吗？
为了平滑升级，旧版百川电商SDK（版本号3.x.x.x及以下版本）会保留到2019年9月30日（不含）。
自2019年9月30日起（含），阿里百川电商SDK的旧版本服务将逐步停止。
3、升级新版百川SDK，媒体的安全图片需要重新生成吗？
新版百川SDK安全图片不论之前是否是V5版本的安全图片。都需登录百川平台，重新生成V5版本安全
图片，并替换应用內的现有图片。
4、原来百川提供强制H5展示功能，为何现在没有了？
通过百川输出阿里系的H5页面，如有外部输出诉求，需经过阿里业务对接，方可对外输出。
如媒体以前有阿里业务同学进行对接，可对其进行反馈，经过业务评估进行对外输出。若无对接同学，则
百川目前提供详情、购物车(电商高级功能)等H5页面应用內打开。后续将开放更多H5页面对外输出。
5、用户未安装手淘、用户行为是什么？
媒体可以自定义将H5页面在应用内降级打开，但不建议此操作，原则上淘宝不支持开发者在端内完成H5的完整购物链路，降级H5打开，后续页面链路很可能出现流程错误的情况，导致消费者使用出现问题。
如果引导下载手淘，如果触达消费者多维淘宝新用户，媒体可以自行考虑将为消费者打开：新人福利社 https://mos.m.taobao.com/activity_newer (此页面在套件“淘宝客基础页面包”中)，引导手淘拉新，会有相应的拉新奖励哦！(以实际当月拉新公告为准)https://tbk.bbs.taobao.com/list.html?topicId=0&page=0&size=20&type=1&order=0
设置示例：
iOS
Android
6、新百川电商SDK提供API与以前有什么变化？
使用电商API打开媒体开发页面，仍然保持应用內打开，使用方法是openByUrl。
openByUrl 中的identity作为业务标识，目前支持传入"trade"，后续会有平台申请。
目前开放商品详情（部分场景）及购物车使用百川API，支持在媒体应用內打开，使用方法是
openByBizCode。API 中的 bizCode 目前支持传入 "detail" "cart"，后续会逐步开放其他bizCode。
7、淘宝客私域用户管理能力相关API授权流程说明
一：标准版SDK授权参考以下流程
1）在百川控制台申请“淘宝客基础页面包”套件
2）申请通过后，在确保百川授权成功后，使用百川的openByUrl接口加载私域用户授权URL，具体查看无线端授权规范文档拼接URL（AlibcTrade.openByUrl，请使用最新版本的SDK）
3）回跳url的code，4.0需要从服务端获取，是到媒体自己的服务器，由回跳的媒体服务端自己接收处理。
二：旗舰版SDK授权参考客户端文档，使用Top Native授权
注意：旗舰版（Android：5.0.0.13、iOS：5.0.0.4及以后）不再支持URL方式授权，改为Top Native授权。
8. 联盟私域授权页面（Oauth），点击授权无反应
应该是授权URL拼接的问题，建议按照文档的两种拼接方式分别尝试下 https://open.taobao.com/doc.htm?docId=105590&docType=1 ,也可以尝试更换拼接的URI。
9. 授权的时候不能跳转手淘，提示或报错“API未授权”
按照正常流程申请AppKey，参考文档媒体接入百川说明-iOS&Android开通电商业务产品权限，电商SDK开通后尝试过段时间再试
10. code获取方式
1.标准版SDK中的 bizCode 目前支持传入 "detail" "cart"
2.旗舰版SDK中的code需要在套件平台查看，具体可参考新版百川套件平台使用说明
11. 授权时应用图标设置
电商SDK授权应用图标在百川控制台--系统设置--应用设置--应用图标设置中添加，点击保存
联盟二次授权应用图标，需要在淘宝联盟开放平台进入后台，在后台应用管理-应用设置-基本信息，上传应用图标即可
Android版本百川电商SDK问题：
1、H5授权登录错误：406 服务竟然出错了
接入SDK最新版本时需在套件平台生成V6版本的安全图片
在以上场景确认无误的情况下，请检查下后台的电商业务产品权限是否开通，开通教程在接入指南文档上有说明，开通后可能会有延迟，请过段时间再试。
2、没有手淘，H5加载优惠券页面，显示宝贝不见了
目前该类页面只支持唤端 如果没有安装手淘会跳转引导下载页（设置失败模式为H5会导致错误页面） 后续会逐步支持应用内h5打开
3、初始化失败 AlibcSecurity init ErrorCode = 203
这个错误是因为找不到安全图片的报错，建议按照下面方法检查处理下：
1）打包后报的，shrinkResources false//设置为false，true的话，安全图片可能会被删除；
2）在Android studio中报错，有可能是instant run导致；
3）可能是资源被混淆了；
4）4.0.0.15版本开始，Android安全图片更名为：yw_1222_baichuan.jpg，需开发者手动修改。
4、通过电商SDK唤起手淘后，没有显示返回小把手
请认真阅读下4.0开发文档，需要设置backURL
5、初始化失败 AlibcSecurity init ErrorCode = 123
1）请先对照下4.X版本开发文档，看依赖是否为最新的
2）Android studio版本在3.5.0以上时可能会出现这个问题，可以把gradle plugin版本降到3.5.0 以下关闭instantrun即可
3）如果保持用3.5.0 android studio运行调试，可以卸载app，然后第一次通过 ./gradlew assembleDebug 打出完整apk，并安装运行，后面再使用android studio IDE中 debug按钮运行。
4）高版本目前只支持V1签名，需要在 build. gradle里指定V1签名
6、初始化失败 AlibcSecurity init ErrorCode = 202
安全图片的问题，请确保获取安全图片的APK包名、签名文件与使用的项目一致
7、上传APK失败，怎么解决？
请尝试以下方法：
1）降低APK大小
2）退出重新登录
3）使用空包，包名、签名信息和正式项目保持一致
4）平台目前仅支持RSA算法签名，请检查签名算法
8、授权时返回code：111 ,msg： busy control
这个是正常的，建议不要频繁调用登录。
9、msg:安全初始化失败 code:1
初始化失败需要提供具体的日志，可以使用"AlibcSecurity"进行过滤。依据日志，对照Android部分的相关建议进行排查解决该问题。
10、授权报错：loginService对象为空
一般是初始化失败导致的，请检查初始化。
11. 初始化失败，报错AlibcSecurity init ErrorCode = 212
当前安全图片的版本太低，请升级新版本图片，V6的安全图片可在百川套件平台获取
iOS版本百川电商SDK问题：
1、iOS升级SDK因安全图片问题初始化报错Error Domain=com.baichaun code=100101加载身份图片失败
集成最新版本的SDK按照iOS集成文档集成，安全图片放到工程目录下即可，安全图片已升级，下载下来的安全图片需要改一下名字，yw_1222_baichuan.jpg，如集成'securityGuard','5.5.50'或之后的版本请使用V6的安全图片，在套件平台下载，初始化的方法走成功的回调就算初始化成功
2、跳转到手淘点击小把手没有反应
尝试不要设置backURL，URL Types按照文档设置，AppKey为百川对应应用的
3、升级SDK之后初始化崩溃
需要按照文档在项目中新建一个mtopsdk_configuration.plist文件，也可以下载demo，将demo中的文件拷贝到自己的项目，具体参考iOS集成文档，demo下载
4、pod下的SDK编译不过问题
需要添加编译参数-ObjC -lstdc++
按照文档检查所有库的版本均与文档一致，具体查看iOS集成文档
5、授权不能拉起手淘，H5授权提示“缺少协议参数x-sign”
一般是安全图片的问题， 在套件平台重新下载，更换安全图片，如集成'securityGuard','5.5.50'或之后的版本请使用V6的安全图片，按照iOS集成文档将SDK升级至最新版本
6、授权的时候不能跳转到手淘，提示“未知APP应用”
按照正常流程申请AppKey，参考文档媒体百川接入说明，电商SDK开通后尝试过段时间再试
7、到手淘授权失败，报104的错误
一般是国行手机的用户第一次安装app时因为没有网络权限，初始化SDK失败 需要加上网络权限判断了，保证有网络后再初始化百川SDK，处理应用跳转部分的代码写的有问题，参考iOS开发文档应用跳转部分；
也有可能是手淘没有登录，用户取消授权，或者手淘版本低，建议升级到最新版本的手淘。
8、授权的时候不能跳转到手淘授权，提示“亲，你的网络不太顺畅哦”
一般是初始化失败导致的，在确定初始化成功后再完成授权的过程，.最好是在获取到网络权限之后再做初始化
9、不能跳转手淘授权，H5授权提示“错误的响应，服务端下发数据为空或数据不是mtop格式的数据”
初始化的问题，电商SDK要先初始化，在保证初始化成功之后再做授权
10、iOS跳转到手淘授权失败，报错AlibabaAuthSDK code=1003“（null）”
跳转手淘授权失败，报1003的错误，一般出现在xcode11新创建的项目中，将处理回跳的方法放到sceneDelegate即可，具体参考iOS集成文档XCode 11 ，iOS 13 适配部分
11、iOS授权的时候提示“请求失败”
需要配置ATS, 允许HTTP请求. 具体配置可参考iOS集成文档
12、iOS用openByURL方式打开应用授权链接出现页面加载不全，或者授权报错client_id is empty
参考iOS集成文档将SDK升级至最新版本，用isLogin判断在登录状态下再调用应用授权，绑定自己webview 的情况，要在客户端自己webview 创建的时候开启这个功能[WVURLProtocolService setSupportWKURLProtocol:YES]; webview 关闭的时候关闭这个功能[WVURLProtocolService setSupportWKURLProtocol:NO];，文档URL调用电商API红色字体部分也有说明