三，深度对接问题
1. API
API(Application Programming Interface，应用程序接口)是一些预先定义的函数，或指软件系统不 同组成部分衔接的约定。 目的是提供应用程序与开发 人员基于某软件或硬件得以访问一组例程的能力，而 又无需访问原码，或理解 内部工作机制的细节。快手广告监测 API：为满足快手广告主对广告效果的监测需求，监测从快手广告渠道分发的应用 内转化数据，并回传给快手广告管理平台，帮助广告主跟踪快手电商广告转化效果。适用于 Android 和 iOS。
详细内容请阅读:《快手广告管理平台应用下载类广告转化数据 API 接口文档》
注意:若客户使用第三方友盟监测链接，需要问清客户使用的是 Apptrack or Uapp。快手后台与 Apptrack 无 GAP。此问题可能会导致联调成功，客户友盟监测有激活回传，但后台不显示激活数。
Q:如何对接 API?
A：API 对接基本流程大致为:接口一是客户的监测链接接口，快手将快手信息流广告投放的详细信息(设备信息及对 应的 callback)实时上报到接口一;接口二是快手转化数据回收接口，形式是监测链接中"__CALLBACK__"对 应的 URL，客户归因后， 将快手带来的激活设备所对应的 callback 链接，服务端请求一次即可。
Q:API 对接过程中，最常见问题有哪些?如何解决? 常见问题主要有如下三点:
【问题一】广告主反馈 URL 填写到后台时，系统提示有误，无法保存;
【问题二】广告主反馈收不到快手上报的快手广告监测数据;
【问题三】广告主反馈自己后台的数据和快手后台报表中的转化数据不一致。
【问题四】广告主在账户联调中，反馈监测链接不可用，如下图:
解决方法:
【解答一】
1. 仅支持 https;
2. 系统会校验占位符是否填写正确，所以务必拼写正确，且不能使用不在列表里面的占位符，比如:__OS__。
【解答二】
1. 证书不能不受信任，可在 PC 浏览器中尝试直接访问监测链接，如果出现下 图提示，即需要更新 https 证书;
2. iOS 的监测链接，需要满足苹果的 ATS 要求，且 TLS 版本要在 1.2 及以上;
3. 快手广告主监测链接渠道参数有误使用 A 参数的点击监测，但查看的 B 参数的上报数据;
4. 快手广告主监测链接的接口无法访问，包括 404 等多种情况，如下图。
【解答三】
快手广告平台如何展现转化数据排查转化数据 Gap 前，首先需要了解快手后台转化数据是如何统计并展现的。
快手广告平台只记录转化数据，归因由广告主或第三方完成。 快手广告平台根据广告主或者第三方上报的转化 callback 来实时记录转化数据，每个 callback 对应着 35 唯一的广告计划/组/创意，快手收到 callback 数据后，实时展现在报表中。(例:广告主或第三方在 1 号 18 时上报一条转化数据，广告平台根据 callback 信息，记录在 1 号 18 时对应的广告计划/组/创意报表数据下， 不关注 callback 对应的广告的展示或点击时间和真实转化时间。)
Q:为什么我自己后台的数据和快手视频广告营销平台的核对不上，而且有的日期我的后台转化数据多，有的日期 广告平台转化数据多?
A：最常见原因是快手广告主没有实时上报转化数据，导致双方比对数据的周期无法对应上，产生数据 Gap。
1.首先检查链接格式，http 是否加了 s，如果未加，需加上;
2. 上 一 步 无 效 后 ， 请 检 查 是 否 填 写 参 数 ， 如 下 图 。 也 可 参 考 以下文档： https://yiqixie.com/d/home/fcAA20a3_jN265xtjzJPmNg4r
Q:为什么我自己后台的数据和广告平台的核对不上，快手广告平台记录的转化数据比我自己后台记录的多很多?
第一种原因：最常见原因是快手广告主自己后台的统计逻辑和给快手上报转化的逻辑不一致，快手广告主自己后台只按渠道 包统计数据，但上报快手的逻辑是只要设 备号匹配成功即回传，这种情况需要广告主确认自己后台的统计 逻辑，保持自己内部逻辑统一，或者客户自己后台统计转化的追溯期和上报给快手的追溯期 不一致;
第二种原因：是客户重复上报，比如把激活设备对应的全部 callback 均上报或多次上报，这种情况需要广告主归 因后上报时进行控制，避免上报无效的重复数据;
第三种原因：快手广告主同时投放多款产品，由于广告主内部多款产品统一做归因，广告主误把其他产品 的转化数据匹配并回传。
Q:为什么我自己后台的数据和快手广告平台的核对不上，快手广告平台记录的转化数据比我自己后台记录的少?
A：最常见原因：是广告主或第三方未全量上报，上报快手广告平台转化数据基于广告主或第三方上报，需要广 告主或第三方先确认上报给快手的数量，如果确认快手广告后台展示数据比上报数量少，提供【完整 callback 上 报 URL、上报时间、快手的接口返回值】，快手协助排查; 第二种原因：是快手广告主上报的转化 callback 实际上对应多个账户/计划/组/创意，这种情况下，建议客户通过 点击监测同时收集并记录计划/组/创意这三个 层级的 callback，这样在上报时就可以清楚的知道自己的转化 最终会披露在 哪个计划/组/创意，避免上报的 callback 分散在多个计划/组/创意，但后台查看报表时，漏看 了部分计划/组/创意的数据，误认为广告平台记录的转化数据比自己后台记录的少。
Q:快手广告平台会对上报的转化数据进行去重吗?
A：会基于数据的反作弊清洗进行一定维度的去重，但要求快手广告主务必确保上报的数据真实且准确，否则 仍然会出现数据 Gap 等情况，影响广告投放效果。
2. SDK
Q:什么是 SDK，如何对接快手广告监测 SDK?
A：SDK 是指由第三方服务商提供的实现软件产品某项功能的工具包，此处特指 用于实现快手广告监测数 据实时回传的 SDK。广告监测 SDK 对比 API 回传方 式收集字段参数更全面，收集频次更及时，适合对 oCPC 效果追求更高的广告主。目前 SDK 对接已全量线上自助操作，快手 SDK 暂时仅支持安卓。 详细内容请阅读: 《快手 Android SDK 对接及使用流程》 《快手监测 SDK 解决方案》 《快手广告监测 SDK 使用说明》
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：常见原因有如下几点:
1. 安装了 SDK 的包投放时误使用了 API 的对接方式，监测链接没有去掉 callback;
2. 排重窗口期不一致，快手 SDK 是按照【IMEI+APK 包名】 30 天去重;
3. 归因方式不一致，快手 SDK 是优先根据 IMEI 匹配，匹配不到，然后匹配OAID，匹配不到 OAID
4. 会匹配 Android ID，如果都匹配不到，则不记录一次激活，快手广告主测如果 按照渠道包归因，不会涉及到设 备号问题.
Q:联调通过，但报表为什么没有记录激活数?
A：应用创建时未勾选 SDK 选项，导致转化数据无法归因到广告组。 37
Q:市场上目前最多的对接方式是 API，客户对 SDK 的认可度并不高。在推SDK 的过程中，遇到的 阻力都有哪些?都是如何解决的呢?
A：主要卡点是 SDK 部署所需的技术投入比 API 高，且广告主对数据安全有担 心。 快手的方法是引导客户部署，告知客户部署 SDK 回传数据比 API 回传更及时、数据打点更多，因此更 有助于模型实时优化效果。
3. Marketing API
Q:什么是 marketing API，如何对接?
A：快手 Marketing API 是一套投放平台功能的接口服务，通过 MarketingAPI 可以帮助快手营销平台客户构建数据 闭环，客户可接入 Marketing API 将自有平 台与快手广告投放平台整合打通，并且实现广告投放过程中的各 项功能，含: 报表查询、账户查询、创建快手广告、修改快手广告、人群管理、建站工具信息查询功能等。
Q:创建/修改限制是什么?
A：由于各项功能均为投放平台先行上线，待使用稳定后，Marketing API 根据客户使用情况进行补齐。为 了避免因未知字段的默认值导致 Marketing API 创建异常的计划/组/创意，目前将投放平台和 Marketing API 的创建/修改功 能隔离。即:
1. 平台创建的计划下不能通过 Marketing API 创建组/创意，平台创建的组下不能通过 Marketing API 创建创意;
2. 如果在平台操作了 Marketing API 未开发的功能字段，不可再通过Marketing API 进行修改;
3. 平台创建的计划/组/创意，Marketing API 只支持使用单独的接口进行 单字段修改状态、出价，预
4. 算，其他信息不支持修改。如果触发限制条件，会返回相应报错信息。
Q:signature 部分为空原因?
A：由于 signature 为新增字段，历史上传的图片/视频无此信息。通过Marketing API 上传的图片，signature 有值，其他途径上传的图片均为空。
Q:视频列表返回内容不全原因?
A：视频列表接口只返回通过投放平台或 Marketing API 上传的视频，其他途径(如手机客户端)上传的视频 不返回。
Q:授权失败原因?
A：进入最终的投放平台首页后，将授权 URL 复制粘贴到浏览器中访问，勿从邮件直接点击链接跳转。
Q:返回“无数据权限”原因?
A：通常原因是 advertiser_id 和 access_token 未正确对应，有可能开发者多线程刷新 token 时导致存储有 误。
Q:快手开屏广告封面图片因“分辨率满足要求”不可用原因?
A：如果创意的封面是由系统自动生成，非自定义上传，则不可重新复用。
