UC广告超级汇川转化追踪-SDK技术文档

一、接入方法

1、 导入SDK

说明:需提前通过UC广告平台申请并下载SDK，目前使用aar引用的方式接入，若接入方需要jar包方式，则只需解压aar 包后分别导入jar 包和so库即可。

(1)导入Android Studio(推荐)

将 aar 包放到工程的libs目录下，接着在模块的build.gradle 中添加:

再在模块的build.gradle 的dependencies 中添加:

(2)导入Eclipse

解压 aar 包，拷贝jar 包和so 库到UC广告工程下的libs目录下，引用即可。

2 、权限配置

找到您的App所在module的目录，修改AndroidManifest.xml文件，添加权限:

SDK 要求最低系统版本为API 14(Android 4.0).

3、 混淆配置

如果您开启了UC广告后台混淆，请加入下面的配置:

4 、SDK初始化

在Application#onCreate时进行SDK初始化，如下例子所示:

如果您没有办法在Application初始化，那我们建议您在您APP的第一个Activity#onCreate 中初始化,初始化时机越晚，UC广告对事件的统计行为越不准确。

注意:UC广告平台所有的事件统计行为，都需要在初始化操作之后进行，否则会抛出异常。

5、事件统计

所有的事件统计都是通过接口GismSDK#onEvent(lGismEvent eventInfo)进行回传，其中UC广告参数为事件信息体，而事件信息体由统一的构造器GismEventBuilder进行生成。例如升级事件:

二、接口说明

1 、对外交互管理类:GismSDK

业务方所有交互都是通过GismSDK进行交互，该类提供了UC广告初始化、事件回传、debug 模式设置等5个接(都是静态方法):

2 、初始化配置信息:GismConfig

通过 builder 模式构造配置信息，通过GismConfig.newBuilder(Application)创建配置信息构造器，配置信息如下:

3、事件信息构造器生产类:GismEventBuilder

所有手动回传事件的信息体通过GismEventBuilder创建对应的信息构造器，目前有:

（1）注册事件

（2）支付事件

(3)角色创建事件

暂无参数要求

自定义事件

三、常见 Q&A

1 、SDKID相关

（1）appname、应用中文名如何命名，对UC广告投放有影响吗?

A:UC广告主可以根据需要自定义命名，SDK技术对接时需要保证sdkid、appname、包名保持一致。

（2）不同游戏是否可以使用相同的sdkid?

A:不可以。超级汇川以sdkid作为唯一标识识别一款游戏，不同游戏需要申请不同的sdkid 作为区分，以免影响效果。

（3）不同UC广告账户是否可以推广相同游戏?

A:可以。申请该游戏sdkid的广告主UC账户，可以向同公司主体的其他UC账户授权，授权完成后即可使用同一个sdkid创建转化追踪并投放UC广告。

（4） sdkid 申请后能否删除?

A:sdkid 一经生成，无法删除。UC广告如果遇到信息重复的情况，可以加后缀区分，例如:game2019、game2019、com.xxx.xxx2019。

2、 SDK对接问题

（1）如何接入SDK?

A:目前使用 aar 引用的方式接入，若UC广告接入方需要jar包方式，则只需解压aar 包后分别导入jar 包和so库即可

（2）SDK1.3.X版本与之前的版本有何区别?

A: SDK v1.3.X为最新版本的SDK，兼容安卓10使用oaid作为设备标识，可用于广告归因。目前支持华为、小米、OPPO、VIVO、一加、联想等厂商的 OAID。对于已接入v1.2版本的UC广告主，升级v1.3仅需替换 aar 包，并在UC广告汇川平台“SDK联调”页面测试确保数据上报正常。对于已接入更早版本的UC广告主(如v1.1)，升级v1.3需增加应用启动回调、应用退出回调接口，并替换8aar包，并在汇川平台“SDK联调”页面测试确保数据上报正常。

（3）SDK1.3.x 与信通院SDK有冲突，如何处理?

A:SDK1.3.x 开始支持oaid的获取，已接入各大厂商提供的OAID SDK，而信通院SDK也是通过接入厂商SDK支持OAID 获取，SDK1.3.x已解决引用包名冲突，另外您也可以使用SDK1.3.1开始提供的接口获取OAID(参见接口说明)

（4）aar中有 arm64-v8a、x86 等平台的so库，但是接入方不需要所有平台的so，如何过滤?

例如只保留armeabi-v7a平台的so，在build.gradle中添加如下代码:

在gradle.properties 中添加

（5）接入SDK 需要哪些初始化参数?如何获取?

A:SDK 初始化需要sdkid、appname、appchannel等参数。sdkid(即appid)由接入方在UC广告超级汇川广告平台申请，提供appname、包名、应用中文名后自动生成。appname与申请appid时使用的appname一致appchannel 由接入方自定义即可，支持英文或数字。

（6） 接入SDK需要上报哪些数据?

A:SDK 接入必须上报的数据包括激活、注册、支付、使用时长。SDK 自动上报的数据包括激活、使用时长。接入方务必参照对接文档正确初始化，并进行退出游戏回调，以保证数据准确上报。接入方手动上报的数据包括注册、支付，以及角色创建、升级、自定义等。必须上报字段已在文档标注，未标注的可以不上报或者上报固定值，由于UC广告超级汇川广告模型依赖SDK上报数据，因此尽量多上报用户行为事件，使得UC用户理解更加精准，获得更好的UC广告投放效果。

（7） 用户激活事件上报是否依赖IMEI?

A:启动游戏接口(onLaunchApp)只要调用了，即使SDK没获取到imei，也会上报激活。但是，汇川依赖IMEI、OAID 等设备号进行UC广告归因。特别注意:当SDK上报的激活缺失IMEI时，很可能无法成功进行广告点击归因，从而导致汇川平台披露的转化数(激活数)低于UC广告主自己后台的激活数。因此，

(1)对于必须UC用户授权才能进入的游戏，建议在进入游戏后回调启动接口

(2)对于其他适配Android6.0以上(API{>}=23)的APP，建议在获得动态权限后回调启动接口，即当提示UC用户授权“获取手机识别码”并在用户点击弹框后回调(无论是否授权)。当激活IMEI缺失时可能会导致超级汇川平台数据偏少..

（8）注册方式有多种，是否支持自定义?

A:文档里列举了属性值示例，如mobile\weixin。如果存在其他UC广告注册方式，接入方可以自定义其他属性值。

（9）付费数据(支付事件)支持服务端上报的方式吗?

A:目前只支持UC客户端的接入方式。

（10）退出游戏onExitAPP()应当在什么时机调用?

A:在UC广告用户确认退出应用时调用，例如弹出退出游戏确认弹框时，UC广告用户点击确定按钮后调用;另外，需要在调用系统退出接口System.exit()或Process.killProcess()等强杀进程前，先调用SDK退出接口onExitApp()。

3、SDK测试及联调相关

（1）如何查看 GISM的日志?

在Application的onCreate中添加如下代码:

过滤TAG=GISM-LOGGER的logcat

（2） 如何判断 SDK初始化成功了?

A:设置 Gism.debug() 进入debug模式，过滤tag为"GISM-LOGGER"的log信息，看到"initsdk success"信息，则为初始化成功;另外，SDK初始化时，会进行相关校验，若校验失败会抛出异常，而异常信息会提示对应的错误。特别注意:debug模式只能在测试阶段，发布上线必须关闭

（3） 如何对 SDK 包进行联调测试?

A:首先确保根据技术文档，完成接入，可通过debug查看测试手机本地日志是否正常。然后进入超级汇川平台“UC广告推广工具~优化工具-转化追踪-SDK-SDK联调页面”,测试手机安装游戏包并试玩10分钟，

并完成注册、支付(支付成功)等操作，在SDK联调页面输入该手机IMEI检查数据上报是否符合预期。

（4） sdkid 包已测试通过，重新打包有什么注意事项，需要重新测试吗?

A:SDK 接入已经测试通过的包,重新打包时请不要修改包内的配置!尤其不要改动sdkid,appname,包名等关键参数及对应关系，函数调用方法也务必不要做任何改动。重新打包之后，务必在UC广告汇川

平台“SDK联调”页面测试确保数据上报正常。

（5）SDK检测不到数据上报，怎么处理?

A:设置Gism.debug()进入debug模式，然后做如下2步跟进:过滤 tag 为"GISM-LOGGER"的log信息，查看对应功能路径是否正常，若有"call onEvent()success"字样则为正常;过滤tag 为"TagentUploader”的log 信息，可以查看到数据上报相关信息，从而进一步确认上报问题。

（6） SDK检测不到激活和使用时长，怎么处理?

A:设置Gism.debug()进入debug模式，然后做如下3步跟进:过滤tag为"GISM-LOGGER”的log 信息，查看Activity生命周期是否有回调，即是否有onActivity字样log 信息，若没有，则需要广告主技术同学确认初始化SDK 时，传入的Application 对象是否为AndroidManifest中注册的Application 对象，而不是new 出来的对象;若有，则进入第2步;过滤tag为“GISM-LOGGER"的log信息，查看事件回调是否正常(激活事件:

ev_ac=open'type=active/openpage、使用时长事件:ev_ac=use)，即是否有"call onEvent() success"字样，若没有，则看log信息确认失败信息;若有，则执行第3步;过滤tag为"TagentUploader"的log 信息，可以查看到数据上报相关信息，从而进一步确认上报问题。

特别注意:部分广告主的APP在退出时，会杀掉当前进程，导致使用时长UC信息被丢失，此情况可通过:在退出APP 时，优先调用GismSDK.onExitApp()接口，则可减少该问题发生。

4、SDK数据不一致自查方法

SDK联调通过后，UC广告主投放广告时可能会遇到数据不一致问题，比如超级汇川平台披露的转化数少于广告主自身统计的数据。自查方法如下

1.UC广告计划投放SDK游戏，检查落地页链接是否是嵌入SDK的游戏包。如果UC广告投放的包并没有嵌入SDK，那么超级汇川平台转化数一般表现为持续为0或者突降为0。您可以在手机上打开该链接，下载游戏包并试玩，进入汇川平台“UC广告推广工具-优化工具-转化追踪-SDK-SDK联调页面“，输入该手机IMEI 检查数据上报是否符合预期。可能原因:UC广告投放人员链接使用错误，或者游戏包上传没有使用SDK方案的包(数据变化可能受链接缓存影响有延迟)

2.SDK游戏包在技术对接时，启动游戏接口onLaunchApp未调用启动游戏接口onLaunchApp每次APP启动时必须回调，否则会漏报激活和启动，导致广告主后台统计数据与超级汇川对不上。

3.SDK游戏包在技术对接时，启动游戏接口onLaunchApp调用时机偏早，尚未获取到IMEI启动游戏接口(onLaunchApp)只要调用了，即使SDK没获取到imei，也会上报激活。但是，汇川依赖IMEI、OAID 等设备号进行广告归因。当SDK上报的激活缺失IMEI时，很可能无法成功进行UC广告点击归因，从而导致汇川平台披露的转化数(激活数)低于UC广告主自己后台的激活数。因此，

(1)对于必须用户授权才能进入的游戏，建议在进入游戏后回调启动接口

(2)对于其他适配Android6.0以上(API{>}=23)的APP，建议在获得动态权限后回调启动接口，即当提示用户授权“获取手机识别码”并在用户点击弹框后回调(无论是否授权)..

4.UC广告计划投放SDK游戏，落地页链接是嵌入SDK的游戏包，但是“绑定转化”时没有绑定SDK创建的转化追踪UC广告推广SDK游戏，请在推广计划层级使用SDK创建的转化追踪，否则可能会导致数据差异，并且无法使用付费双出价功能。

以上就是《UC广告超级汇川转化追踪-SDK技术文档》的内容，如果有什么不懂的，比如：账户是否搭建、平台的优势、运营是否收费、多久能出效果等问题我们的专业网络客服都可以帮您解答，或者拨打我们的电话：4009602809！！！UC广告开户只需5000元，广告主投放广告时可能会遇到数据不一致问题，比如超级汇川平台披露的转化数少于广告主自身统计的数据。这个可以自查的，以上内容九讲过啦，想了解的快拨打我们的电话吧！