一、SDK在深度模型中的应用案例
1、什么是SDK？
一个写好代码的代码包，客户可以加到自己的App里，转化事件发生时，直接执行写好的代码，快手服务器就可以收到相应的转化数据
和API对接的区别：API是客户自己的数据库统计到转化数据后，通过服务器发送至快手服务器，SDK是用户在App进行转化操作时，App客户端直接向快手的服务器上报转化数据，回传更及时
2、SDK为游戏广告主提供更全面更精准的深度优化
原理：相对于常规的API回传激活和付费行为，接入SDK以后，深度模型会根据注册、创角、时长、等级、活跃、次留等更多signal找到留存和活跃更好的付费用户，提升用户质量
3、接入全链路事件能提高模型调价的稳定性和精准性
重度游戏：需要接入注册，创角，等级，时长，付费 等事件
实时性/稳定性：SDK能保证数据回传的实时性，能够帮助模型能稳定的调价，提高跑量稳定性
休闲游戏：需要接入次留、七留、活跃、观看激励视频 等事件，可以使用次留双出价优化留存
二、如何对接监测SDK
1、对接监测SDK步骤
① 申请App ID（SDK初始化时的必需字段）
②下载安卓监测SDK包，内含对接说明文档、示例代码等，
③ 按文档说明完成SDK在应用内的集成
④联调：创建SDK转化追踪、并对数据上报进行联调通过后，该转化追踪即被激活
⑤ 将接入SDK的APK创建广告组进行投放，注意投放初期的设置问题
⑥以下有详细的步骤和说明
步骤一：申请APP ID
1.进入快手广告后台，如下图所示操作路径，点击“转化跟踪” → “追踪应用”→ “管理App ID”→ ”申请App ID”，按照提示完成App ID的申请
2. 按照提示完成App ID的申请，注意，如果同样的Android 包名（package name）只需要在一个账户申请一次，如果其他账户想投放此包，直接投放即可，不需要再次申请
3.优化同学把申请好的app id，android 包名和app name发给负责接入SDK的工程师
步骤二：下载Android监测SDK
1.进入快手广告后台，如下图所示操作路径，点击“转化跟踪” → “追踪应用”→ “管理App ID”→ 点击下载Android监测SDK
2.将下载的文件夹（包括SDK使用文档，SDK程序包，SDK DEMO）和申请好的app id，android 包名和appname发给负责接入SDK的工程师
步骤三：对接SDK，接入必要的事件，辅助模型优化
1.按照下载的SDK文档，开始接入SDK。
2.重度游戏需要接入 注册、创角、等级、时长、付费 等事件。
3.休闲游戏需要接入 注册、活跃、次留、七留 等事件。
步骤四：联调
1.在正式联调之前，需要对接SDK的工程师先测试一下打印日志是否正常，看初始化和其他事件是否能正常打印
2.如果日志输出正常，投放同学可以在快手广告后台开始联调
3.联调步骤如下
新建SDK回传----- 输入IMEI/OAID-----安装并打开APP-----检测上报是否正常
4.进入快手广告后台，如下图所示操作路径，点击“转化跟踪” → “追踪应用”→ “新建SDK回传
5.输入转化名称，添加应用，选择APP ID，深度转化目标根据是否需要测试付费，如果需要测试付费，选择付费，如果不测试付费，选择无
6.上一步完成以后，进入正式联调界面，注意，这一步需要先点击去激活，才能安装app然后打开，否则联调会失败。如果测试手机已经安装，需要先把APP卸载，重新安装。
7.输入测试联调的手机IMEI，双卡手机输入第一个IMEI，Android 10需要输入OAID，OAID可以在设置，隐私，广告隐私里面查看
8.这个时候，需要把联调的测试包发送到测试手机，可以通过qq或者下载链接，然后安装，打开激活并试玩。
9.试玩以后，点击“以上已经操作，开始监测”，进入检测，几秒钟会弹出检测成功（右图），代表初始化成功。如果过了一分钟没有测试成功，可能有2个原因，第一初始化失败，需要工程师检查日志，是否显示register sdk success，如果没有，代表初始化代码部署有问题，需要检查代码部署。第二，如果日志显示初始化成功，但是联调不能通过，可能是联调测试的手机获取权限问题，需要换手机测试，如果换多部手机仍然不成功，需要工程师把初始化代码放在获取手机权限之后。
10.上一步完成之后，开始检测SDK事件上报，如果深度转化选择了付费，这一步需要先在APP付费成功，付费成功之后，点击“以上已经操作，开始监测”，如果测试成功，会显示激活和付费“已经成功上报”。
11.截止到这一步联调结束，可以开始正式投放
2、为什么大部分客户卡在了第一步？
①了解这个问题，需要先知道快手联调的逻辑
②大部分手机联调的过程是怎么样的？
③Android 代码加载的先后顺序
④快手SDK对接文档没有强调初始化需要在权限之后，导致广告主参考demo写代码，放在Application里面，会导致初始化加载比READPHONESTATE 权限先发生
⑤产生GAP有哪些情况？
a.广告主比快手多，10%左右的算在合理范围，超过10%的case需要单独看
b.快手比广告主多接近一倍，这种需要排查监测链接设置是否正常
c.广告主比快手多超过20%的gap，可能是sdk初始化没有记录到imei
d.快手后台为0，检查配置是否正常，如果配置都正常，需要检查投放的包是否接了sdk
e.快手后台有数据，广告主数据为0，一般是投放的包跟api的包都接了sdk导致
三、创建SDK广告注意事项
注意事项一：上传应用列表需要勾选已经接入SDK
添加应用的时候，投放SDK的广告组需要勾选已经接入SDK，如果不勾选，会导致投放以后，广告后台没有转化数据
注意事项二：广告组是否需要选择转化目标
1.投放SDK的广告组需要新建，不能使用老广告组API切换成SDK，这样会导致数据错误。
2.创建广告组，选择对应的应用，转化目标不需要选择，直接跳过
注意事项三：创意层级是否需要加监测链接投放时，使用SDK的广告组，不建议添加监测链接，如果广告主需要加监测，在监测链接需要处理，去掉callback或者广告主的技术需要对链接做处理，目的是使用了监测链接，不会上报数据，否则广告账户后台数据会变多一倍。如果使用第三方监测，需要在第三方监测后台关闭回调。
注意事项四：关于OAID
SDK已经于2020年4月11日支持内部获取OAID，若之后出现激活对不齐的情况，可检查SDK是否对接OAID导致账 户中激活数量出现偏差
注意事项五：关于SDK对接文档
后台可下载的SDK文档是实时更新的最新版本文档，同步广告主直接下载即可
注意事项六：关于应用包名和与联调之间的关系
SDK通过android包名判断，同一个应用包名只需要联调一次（com.xxxx.xxxx.xxx)，同样应用包名更换账户直接投放即可
四、常见问题
Q：快手支持iOS SDK吗？
A：暂不支持
Q：快手SDK转化数据去重周期是多少？
A：激活以应用初始化为准，表单、完件、授信事件根据30天内上报的数据进行去重，其他事件不去重。
Q：快手SDK转化数据追溯周期是多少？
A：快手根据去重等数据清洗规则处理转化数据后，会根据“应用包名+设备信息”，追溯近30天的勾选了SDK选项的广告组的广告数据，匹配成功后计入报表。
Q：联调第一步不通过怎么办？
A：确认安装包的app_id、app_name等内容和后台创建时的信息完全一致，并且先点击“去激活”后，才能首次启动App；另外，可能存在无法获取设备信息导致联调失败的情况，建议尝试更换设备联调。如果更换设备还是不成功，需要工程师把初始化代码放在手机权限授权之后。
SDK常见问题
Q：SDK产生数据Gap，如何排查？
A：
一：先查看双方数据，激活数据是否产生gap，如果产生，则分为两种情况
1:媒体后台比客户多查看客户投放链接是否有去掉“__CALLBACK__”，对其双方对历史用户判定逻辑，快手sdk初始化30天去重，询问 客户对于历史排重逻辑是如何判定的
2:媒体后台比客户少查看sdk代码是否有放在“初始化之后”，查看是否对接oaid参数
二：激活数据可以对其，付费数据产生gap
1:查看账户，定位到，付费数据出问题的unitid，双方导出日志查看并定位到产生付费gap的设备，在针对激活时间，回传时间等定位具体问题所在
2:目前付费回传gap，有一部分出现在同一设备号，在短时间内，进行过多次大金额付费，如设备号1，在10:00的时候充值金额为1，在10:01分的时候充值金额为648，可优先排查是否有这种情况产生
SDK常见问题
Q：联调第二步不通过怎么办？
A：需要确认事件成功上报，建议广告主先自行开启日志打印测试，如果初始化或转化时无日志打印，则说明SDK安装异常。
Q：使用SDK的安装包，可以添加监测链接吗？
A：如果需求可以添加，但需特殊处理。第一方监测链接需删掉“__CALLBACK__”，第三方监测链接需在第三方后 台关闭转化回调。安装了快手SDK的安装包，投放时禁止使用API对接。
Q：联调通过，但报表为什么没有记录激活数
A：应用创建时未勾选SDK选项，导致转化数据无法归因到广告组，也可查看广告后台“安卓下载完成数”是否出现 数据异常，确定SDK包可以正常下载激活
评论列表