媒体接入百川说明-iOS&Android(4.0.0.2版本)

更新时间:2019/09/18 访问次数:7972

原百川SDK使用媒体:请先阅读百川SDK4.0.0.2升级指南

新接入百川SDK媒体:请依次阅览以下内容 

  

百川电商SDK4.0.0.2功能介绍:

百川电商SDK4.0.0.2版本是基于电商SDK4.0.0.0的基础上,针对部分功能点做了优化:

 

Android SDK版本:

(1)优化用户授权&免登功能;

 

iOS SDK版本:

(1)优化用户授权&免登功能;

(2)修复部分页面拦截失效;

(3)更新适配iOS13

 

百川电商SDK4.0.0.0功能介绍:

(1)唤醒手淘:

(1-1)任何投放都可直接唤醒手淘打开。当消费者无手淘时,默认引导手淘下载,但开发者可自行调整为退回到H5页面打开(请注意此时登录态不再支持透传);

(1-2)部分页面可支持在开发者APP内打开,可以默认不唤醒手淘。这部分页面,新版百川SDK将通过套件功能对外开放,在套件内会包含相应可被调用的页面。

(2)登录:

支持媒体APP里面使用淘宝账号登录,媒体使用百川SDK提供的能力时,百川SDK会透传用户登录态。

(3)授权:

用户可将某些功能/能力同意给媒体使用,媒体可通过获取用户的授权,访问页面/API等数据。

(4)投放页面开放:

新版百川SDK,通过“套件”功能,为媒体提供可直接调用的页面。当前可支持在媒体APP内打开的页面,将会包在套件内,提供给媒体,媒体可获得套件的权限,从而获得调用套件内页面的权限,具体开放页面请以当前套件内支持的页面为准。

(5)交易环节:

百川SDK4.0暂不支持闭环交易,交易环节需唤醒手淘,当消费者无手淘时,默认引导手淘下载,但开发者可自行调整为退回到H5页面打开(请注意此时登录态不再支持透传)。

 

一、前期准备

 (1)注册百川应用

(2)获取安全图片

   目前接入百川平台提供的新版SDK均需重新申请安全图片。安全图片选择V5版本

 

   

 

 

(3)开通电商业务产品权限

image.png

 

 

二、百川电商SDK

(1)接入百川电商SDK

(2)百川电商SDK接入及使用说明

 

        iOS 电商SDK4.0.0.2接入说明

        Android 电商SDK4.0.0.2接入说明

 

(3)电商SDK接口使用

1、业务配置API

API名(iOS/Android) 功能 描述
setIsSyncForTaoke/setSyncForTaoke
提供配置文件和全局接口两种形式,全局接口优先,没有配置时以服务端下发的配置为准
设置是否使用同步淘客打点。true:使用淘客同步打点;false:关闭同步打点,使用异步打点;
注意:初始化完成后调用才能生效
 
setChannel 用于配置ttid  
setIsvVersion 设置三方app版本,可用于标识app版本  

2、开发配置API

API名(iOS/Android) 功能 描述
setShouldUseAlipay/turnOnDebug(turnOffDebug) 设置是否开启日志调试功能  

3、电商组件API

主要提供两类API :

一、通过电商套件平台申请的电商套件code,打开对应的电商套件页面

二、通过电商套件平台为自己的页面地址配置业务身份标识,运用电商页面API 打开url

详细请见上面: iOS&Android开发接入文档

 

三、百川webView JSBridge能力

在页面引入百川JSBridge  https://g.alicdn.com/mtb/lib_BC/0.1.0/p/index/index.js

通过百川API 打开相关页面 可调用百川提供的基础JS API能力

参考:https://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.1a37be48Qxmzff&treeId=129&articleId=105646&docType=1

 

JSBridge接口描述

百川JSBridge提供的方法挂载到了window.Baichuan上,属性和方法通过该对象来调用

 

1.Baichuan.closeWebView(callback)

回调参数:

回调参数将会在回调方法中传递

输入输出参数 无

2.Baichuan.getDeviceInfo(callback)

回调参数:

回调参数将会在回调方法中传递,如果成功获取设备信息,则进入 success 回调,否则进入 failure 回调。

类型 名称 描述
string brand 设备品牌,例如 "Apple" 或 "Google"。
string model 设备型号,例如 "iPhone" 或 "iPod touch" 或 "Nexus 5"。

 

3.Baichuan.isInstalled(params, callback)

输入参数

类型 名称 描述
array apps 是否安装的app列表, 例如['TB', 'TM']

回调参数

apps的map 例如{"taobao://": true}

iOS 平台的应用程序标记,使用的是 schema,例如 'taobao://'。

Android 平台的应用程序标记,使用的是包名,例如 'com.taobao.taobao'。

 

4.Baichuan.isTaobaoInstalled(callback)

输入参数

回调参数

true 或 false

 

5.Baichuan.isTmallInstalled(callback)

输入参数

回调参数

true 或 false

 

6.Baichuan.isLogin(callback)

回调参数:

回调参数将会在回调方法中传递,如果判断当前用户已经登录,则进入 success 回调,否则进入 failure 回调。

类型 名称 描述
string isLogin

是否登录 “true” or “false”

 

7.Baichuan.login(callback)

回调参数:

回调参数将会在回调方法中传递,如果当前用户登录成功,则进入 success 回调,否则进入 failure 回调。

类型 名称 描述
string userId

登录成功 userId

string

nick

登录成功 nick

 

8.Baichuan.logout(callback)

回调参数:

回调参数将会在回调方法中传递,如果当前用户登录成功,则进入 success 回调,否则进入 failure 回调。

类型 名称 描述
string isSuccess

登出成功 "true"

 

附:百川SDK升级FAQ

FAQ

关于此文档暂时还没有FAQ
返回
顶部