‍uc头条——游戏行业SDK深度转化常见问题

QA

Q：SDK回传相比API服务端回传有什么优势？

A：SDK 能够同时回传更全面的转化数据（如付费、留存等多种行为）模型可以更全面的理解用户，支持付费等深度转化的投放优化，提升roi

Q：什么情况下适合开启深度单目标出价？

A：如果老计划当前投放效果比较满意，希望获取更多深度转化（如付费）并且允许放开浅层转化成本（如激活），那么可以将“二三阶段出价”切换为“深度单目标出价”。功能开启后， 系统将会专注于优化深度转化效果，放开浅层成本限制，为您更多获量，带来深度转化数和消费的提升。 注意：如果当天每天的深度转化数<5个，效果容易波动、深度转化成本可能会超，此时建议您先使用“深度双目标出价”投放和优化，待稳定后再切换功能。

Q：新账户、新计划是否可以开启深度单目标出价？

A：由于新账户、新计划深度数据（如付费）积累较少，如果直接开启深度单目标出价，深度转化效果容易波动。因此，建议您先使用“深度双目标出价” 投放，在数据积累较充分、效果较稳定后再切换为“深度单目标出价”。 如果您可接受深度成本波动，希望直接测试深度单目标出价，汇川平台上支持开启功能更。 此时，建议您同时开启安心投，在OCPC二阶段依旧保障您的转化成本（如激活）可控； 当进入深度优化阶段（三阶段）时自动理赔前7天的转化成本，后续不再生效安心投

Q：SDK投放广告，深度单目标出价应该如何设置？

A：1) 第一阶段出价、转化出价(激活)依旧根据历史操作习惯设置，设置深度转化出价可根据心理预期的深度转化率折算。 2) 例如：广告主心理预期激活成本100、付费率为5%，那么，转化出价(激 活)设为100 元，深度转化单出价(付费)设为500 元.

Q：接入SDK需要哪些初始化参数？如何获取？

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

QA

Q：appname、应用中文名如何命名，对广告投放有影响吗？

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

Q：不同游戏是否可以使用相同的sdkid？

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

Q：不同账户是否可以推广相同游戏的？

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

Q：appid申请后能够删除？

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

Q：注册方式有多种，目前文档只有mobile\\weixin，如何处理？

A: 文档里列举了属性值示例，如果存在其他注册方式，接入方可以自定义其他属性值，并告知汇川平台。

Q：激活时间是init吗？是否依赖IMEI？

A: 激活时间是用户在当前设备首次打开页面的时间，不是init的时间， 不依赖IMEI

Q： 如何接入SDK？

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

QA

Q：如何判断SDK初始化成功了？

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

Q：接入SDK需要上报哪些数据？

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

Q：付费数据支持服务端上报的方式吗？

A: 目前只支持客户端的接入方式，如有特殊需求，请联系汇川相关同学。

Q：退出游戏onExitAPP()应当在什么时机调用？

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

Q：如何对sdk包进行联调测试？

A：首先确保根据技术文档，完成接入。测试时需要真机试玩10 分钟， 并完成注册、支付(支付成功)等操作。

QA

Q：sdkid包已测试通过，重新打包有什么注意事项，需要重新测试吗？

A: SDK 接入已经测试通过的包，重新打包时请不要修改包内的配置！尤 其不要改动 sdkid、appname、包名等关键参数及对应关系，函数调用方法也务必不要做任何改动。重新打包之后，可根据SDK联调页面提示再次验证。

Q：SDK检测不到数据上报，怎么处理？

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

Q：SDK检测不到激活和使用时长，怎么处理？

A: 设置 Gism.debug() 进入 debug 模式，然后做如下 3 步跟进：a) 过滤 tag 为 "GISM-LOGGER" 的 log 信息，查看 Activity 生命 周期是否有回调，即是否有 "onActivity***" 字样 log 信息，若没 有，则需要广告主技术同学确认初始化 SDK 时，传入的 Application 对象是否为AndroidManifest 中注册的 Application 对象，而不是 new 出来的对象；若有，则进入第 2 步；b) 过滤 tag 为 "GISM-LOGGER" 的 log 信息，查看事件回调是否 正常（激活事件：ev_ac=open`type=active/openpage、使用时长 事件：ev_ac=use），即是否有 "call onEvent() success" 字样， 若没有，则看 log 信息确认失败信息；若有，则执行第 3 步； c) 过滤 tag 为 "TagentUploader" 的 log 信息，可以查看到数据上 报相关信息，从而进一步确认上报问题。 部分广告主的 APP 在退出时，会杀掉当前进程，导致使用时长信息被 丢失，此情况可通过：在退出 APP 时，优先调用 GismSDK.onExitApp()接口，则可减少该问题发生。

Q：测试阶段如何查看日志？

A: 开启 debug 模式可以查看日志，但务必在正式投放的版本关闭。在Application 的 onCreate 中添加如下代码: public class MainApplication extends Application { @Override public void onCreate() { super.onCreate(); GismSDK.debug();//注意在 Debug 模式下才执行 } }