快手广告后台线索类 Xpath 上报机制 | 快手磁力引擎广告平台

SDK 是一个预先编写好代码的代码包，客户能够将其添加到自己的 App 中。当转化事件发生时，直接执行既定代码，快手服务器便能接收相应的转化数据。

1. 申请 App ID（SDK 初始化的必备字段）

在快手广告后台，按照如下图所示的操作路径：点击“工具”→“转化跟踪”→“追踪应用”→“管理 App ID”→“申请 App ID”，依据提示完成 App ID 的申请。

在快手广告后台，依照如下图所示的操作路径：点击“工具”→“转化跟踪”→“追踪应用”，点击下载 Android 监测 SDK。

将下载的文件夹（涵盖 SDK 使用文档、SDK 程序包、SDK DEMO）以及申请好的 app id、android 包名和 app name 交付给负责接入 SDK 的工程师。

1）依据下载的 SDK 文档，着手接入 SDK。

2）重度游戏需接入注册、创角、等级、时长、付费等事件；休闲游戏需接入注册、活跃、次留、七留等事件。

1）在正式联调前，负责对接 SDK 的工程师需先测试打印日志是否正常，查看初始化和其他事件能否正常打印。

2）若日志输出正常，投放人员可在快手广告后台开始联调。联调步骤演示图如下。

完成上一步后，进入正式联调界面，需注意，此步需先点击去激活，才能安装 app 并打开，否则联调将失败。若测试手机已安装，需先卸载 APP，重新安装。

输入测试联调的手机 IMEI，双卡手机输入第一个 IMEl，Android 10 需输入 OAID，OAID 可在设置、隐私、广告隐私中查看。

此时，需将联调的测试包发送至测试手机，可通过 qq 或下载链接，而后安装、打开激活并试玩。

试玩后，点击“以上已经操作，开始监测”，进入检测，数秒后若弹出检测成功（右图），则代表初始化成功。

在快手广告后台若一分钟后仍未测试成功，可能存在两个原因：第一，初始化失败，需工程师检查日志，看是否显示“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 选项，导致转化数据无法归因到广告组。