SDK使用说明
什么是sdk?
sdk是一个写好代码的代码包，客户可以加到自己的App里，转化事件发生时，直接执行写好的代码，快手服务器就可以收到相应的转化数据。
对接监测步骤
1.申请App ID(SDK初始化时的必需字段)
进入快手广告后台，如下图所示操作路径，点击"工具”→“转化跟踪”→“追踪应用”→“管理App ID"→"申请App ID”，按照提示完成App ID的申请
2.下载安卓监测SDK包，内含对接说明文档、示例代码等
进入快手广告后台，如下图所示操作路径，点击"工具"→“转化跟踪”"→“追踪应用"→点击下载Android监测SDK
将下载的文件夹(包括SDK使用文档，SDK程序包，SDK DEMO）和申请好的app id,android 包名和app name发给负责接入SDK的工程师
3.按文档说明完成SDK在应用内的集成
1)按照下载的SDK文档，开始接入SDK。
2)重度游戏需要接入注册、创角、等级、时长、付费等事件。3）休闲游戏需要接入注册、活跃、次留、七留等事件。
4.联调:创建SDK转化追踪、并对数据上报进行联调通过后，该转化追踪即被激活
1）在正式联调之前，需要对接SDK的工程师先测试一下打印日志是否正常，看初始化和其他事件是否能正常打印
2）如果日志输出正常，投放同学可以在快手广告后台开始联调3)联调步骤演示图如下
具体步骤如下:
上一步完成以后，进入正式联调界面，注意，这一步需要先点击去激活，才能安装app然后打开，否则联调会失败。如果测试手机已经安装，需要先把APP卸载，重新安装。
输入测试联调的手机IMEI，双卡手机输入*个IMEl，Android 10需要输入OAID，OAID可以在设置，隐私，广告隐私里面查看
这个时候，需要把联调的测试包发送到测试手机，可以通过qq或者下载链接，然后安装，打开激活并试玩。
试玩以后，点击"以上已经操作，开始监测”，进入检测，几秒钟会弹出检测成功(右图)，代表初始化成功。
在快手广告后台如果过了一分钟没有测试成功，可能有2个原因，*初始化失败，需要工程师检查日志，是否显示register sdk success，如果没有，代表初始化代码部署有问题，需要检查代码部署。第二，如果日志显示初始化成功，但是联调不能通过，可能是联调测试的手机获取权限问题，需要换手机测试，如果换多部手机仍然不成功，需要工程师把初始化代码放在获取手机权限之后。
上一步完成之后，开始检测SDK事件上报，如果深度转化选择了付费，这一步需要先在APP付费成功，付费成功之后，点击"以上已经操作，开始监测”，如果测试成功，会显示激活和付费“已经成功上报”。
截止到这一步联调结束，可以开始正式投放。
注意事项
1.申请APPID时，同一账户内，“应用中文名"和"App Name”不可重复(包含历史邮件申请已提交的部分)，如重复会有错误提示，自行在后面拼接序号即可;
2．申请APPID后，对接开发完成后可以直接进行投放，但如果不创建SDK转化追踪，无法联调并验证数据是否能够正确上报，所以建议广告主务必创建SDK转化追踪;
3.新建SDK转化目标时，APPID可跨账户使用，即可以直接使用“已经在其他账户创建好的APPID"进行转换目标的创建，创建后进行联调，联调成功后可投放使用;
4.联调转化目标时，需要保证App安装后从未打开，即必须要先点击“去激活”，再*启动App，否则联调*步无法通过;
5. 创建应用时，集成了SDK的安装包务必勾选页面上已安装SDK的选项，且不能和API对接方式混合使用，否则报表数据异常;
6.投放时，广告组在选择完投放的应用后，建议选择对应的已激活的转化追踪，这样可以在转化追踪模块看到某一转化目标的各项投放数据，不选择的不会影响投放报表统计;
7.投放时，使用SDK的安装包，不建议添加监测链接，如有需求，需要提前联系快手运营确认链接能否添加。
常见问题
Q:联调的*步“监测SDK初始化”为什么不成功?
A:请检查申请App ID时填写的Android包名、App Name，和SDK初始化方法中相应的参数值，是否完全一致，不一致会导致初始化失败
Q:为什么广告平台展示的SDK转化数，和自己后台监测到的转化数有较大误差?
A:可以检查以下几个方面:
1、投放嵌了监测SDK的应用时，创意层级不需要填写监测链接，因为SDK上报的转化数据是由投放平台做归因处理，否则会出现重复上报的情况。如果广告主确实有填写监测链接的需求，填写时请勿携带”_CALLBACK_”，避免重复上报转化数据导致报表数据异常。
2、创建应用时，务必勾选“该应用已接入快手广告监测SDK”(如下图)，否则会影响数据正常归因匹配;
3、投放嵌了监测SDK的应用时，建议新建unit，不要在老的对接了API回传的unit上进行修改，以免影响转化数据正确回传
Q:快手支持ioS SDK吗?
A:暂不支持
Q:快手SDK转化数据去重周期是多少?
A:激活以应用初始化为准，表单、完件、授信事件根据30天内上报的数据进行去重，其他事件不去重。
Q:快手SDK转化数据追溯周期是多少?
A:快手根据去重等数据清洗规则处理转化数据后，会根据“应用包名+设备信息”，追溯近30天的勾选了SDK选项的广告组的广告数据，匹配成功后计入报表。
Q:联调第—步不通过怎么办?
A:确认安装包的app_id、app_name等内容和后台创建时的信息完全一致，并且先点击“去激活”后，才能*启动App;另外，可能存在无法获取设备信息导致联调失败的情况，建议尝试更换设备联调。
Q:联调第二步不通过怎么办?
A:需要确认事件成功上报，建议广告主先自行开启日志打印测试，如果初始化或转化时无日志打印，则说明SDK安装异常。
Q:使用SDK的安装包，可以添加监测链接吗?
A:如果需求可以添加，但需特殊处理。*方监测链接需删掉”_CALLBACK_”，第三方监测链接需在第三方后台关闭转化回调。安装了快手SDK的安装包，投放时禁止使用API对接。
Q: SDK数据Gap原因?
A:安装了SDK的包投放时误使用了API的对接方式;应用上线一段时间后集成了快手SDK，历史的激活数据快手无法获得导致未去重。
Q:激活、注册等转化数据，快手后台多于广告主数据的原因?
A:快手后台SDK转化去重周期为近30天，如果用户在“30天前”或“广告开启投放前”产生过转化，快手由于“去重窗口”或“未获取历史数据”等原因导致无法去重过滤，*终广告平台转化数据有可能多于广告主数据。建议广告主可自行上传历史用户人群包进行排除。
Q:激活数据基本—致，次留数据快手后台多于广告主后台?
A:快手统计次留数据依赖广告主上报，因此需要广告主控制，仅激活次日*启动App上报「次留」事件。如果每次启动均触发「次留」事件上报，会导致快手后台数据多于广告主后台。
Q:联调通过，但报表为什么没有记录激活数?
A:应用创建时未勾选SDK选项，导致转化数据无法归因到广告组。
本文标题：快手广告后台线索类Xpath上报 | 快手磁力引擎广告平台
本文链接：https://www.eatui.cn/xinxiliu/25623.html
