快手广告管理平台：应用下载类广告转化数据的 API 接口说明文档

接口一能够助力广告主获取快手服务器所提供的广告投放数据，此接口由快手广告主或者第三方监测平台进行开发，并最终以监测链接的形式填写至广告投放后台。

请求方为快手 App 广告客户端。

处理方是快手广告主所提供的监测平台服务器。

请求协议采用 HTTPS 协议（仅支持 HTTPS，不支持 HTTP）

请求快手 APP 广告的方式是 GET。

请求地址为快手广告主在快手广告平台所设置的监测 URL。

在监测链接 URL 中，快手通过【__参数__】（例如：imeiMD5=__IMEI2__，需注意参数前后均为双下划线) 的形式来设定所需上报的数据，常见链接示例如下：

iOS 格式示例（快手参数名可自定义）：

Android 快手推广开户的格式示例（参数名可自定义）：

由于当前不支持动态上报操作系统信息，建议 iOS 和 Android 各自使用一套独立的快手信息流广告监测链接。

其中：

1. www.example.com 是快手广告主接收点击上报数据的地址，需要广告主自行修改替换。

2. xxx=XXXX 是快手广告主自定义的参数信息，可由广告主自行设定，快手在上报时会原样返回，不作任何修改。

3. idfaMD5/imeiMD5/callback 这几个参数名称仅作参考，最终使用的参数名称可由广告主自行设定。

4. __IDFA2__/__IMEI2__在快手进行上报时，会替换为相应的 md5 加密设备号，其他参数也可获取，例如在链接地址中添加&mac2=__MAC2__，能够获取 md5 加密的 mac 信息，具体可支持的参数列表可查看下方快手短视频广告的参数说明。

5. __CALLBACK__为必填参数，快手客户端在上报时会替换成 http 形式的地址（已编码一次），广告主在接收到上报数据后，需要保存该地址，当用户在应用内完成相应转化事件时，请求该地址来上报转化数据（需要拼接相应参数，详见下方接口二）。

以下是快手所支持的参数值及其对应说明。其中，无对应值或快手未获取到值的占位符，不进行替换或替换为空字符串（非空格），需注意：占位符前后均为双下划线。

iOS 上报示例：

https://www.example.com?xxx=XXXX&idfaMD5=D4C00E03AC3BFAFE392A310E5D35807F&mac=&callback=http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd

Android 上报示例：https://www.example.comxxx=XXXX&imeiMD5=ec40a3448a16fe01f23ea60efdcb5c77&androidid=__ANDROIDID2__&callback=http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDUKFQQ3NGFyk1uCKBYCyXp-ApCU-r7FG_a3TeY40C4wxmWqv46Pmr1q0wfwU3IPB

采用 JSON 数据格式。

为 HTTP 标准状态码，对响应内容不作要求。

1、占位符必须全部大写，且不可使用不在上述列表中的占位符（如：__GEO__等），后台会进行拼写校验。

2、监测链接中参数的命名无需与上述示例完全一致，但含义及用途需完全符合上述定义。

3、监测链接长度不得超过 500 字节。

4、监测链接不能是下载链接。

接口二用于广告主将应用内的转化数据上报给快手广告服务器，快手会将收到的转化数据与广告计划、广告组、广告创意相关联，追踪每个广告创意的转化效果。

请求方是广告主提供的监测平台服务器。

处理方为快手广告服务器。

请求协议是 HTTP。

请求方式为 GET。

请求地址是监测方通过接口一接收的__CALLBACK__替换后的 http 地址（需要拼接相应参数）。

参数：

• callback，即接口一接收的__CALLBACK__替换后的 http 地址中的 callback 参数（参考下方示例中标红处）。

• event_type，事件类型，转化事件和参数值的对应关系见下表，建议对接前与快手广告运营同学沟通确认。

• event_time，事件时间，13 位毫秒级时间戳。若在请求快手推广的资质中携带 event_type 参数，则必须同时携带 event_time 参数。

• purchase_amount，金额。当 event_type 为{3,12,13,14,15}时，必须同时回传消费金额参数 purchase_amount，单位为元，可保留两位小数。

<

回调的请求 URL（接口一中__CALLBACK__的对应值，快手 UrlDecode 后再拼接相关参数）示例如下：

1）激活

http://ad.partner.gifshow.com/track/activate?event_type=1&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd （快手标红区域字段的字符，仅作为样例，不可用于联调）。

2）注册

http://ad.partner.gifshow.com/track/activate?event_type=2&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd （快手标红区域字段的字符，仅作为样例，不可用于联调）。

3）付费

http://ad.partner.gifshow.com/track/activate?event_type=3&event_time=1536045380000&purchase_amount=10.88&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd （快手标红区域字段的字符，仅作为样例，不可用于联调）。

回调后的 response 为 JSON 格式，result=1 代表回调请求上报成功，其他参数及参数值无需关注。

为提升投放效果，快手期望广告主能够将归因至其他渠道的转化数据也回传至快手，以助力优化深度转化模型训练。上报此类转化数据时，需要增加参数“&is_direct_match=false”，表示“该用户看过快手广告，但转化归因到了其它平台”，此类数据不会计入投放报表展现。上报样例：

广告主可在快手广告投放后台的“工具-转化追踪-追踪应用”中，新建转化目标，填写相关内容后，依照页面说明进行联调。

强烈建议广告主通过监测链接收集并记录账户/计划/组/创意这四个层级的 ID，如此一来，便能清晰知晓转化 callback 最终上报后，会在哪个账户/计划/组/创意下进行披露。

在对接过程中倘若遇到问题，广告主通常可关注以下几点来排查问题：

1. 是否正确收到监测请求上报。

2. 转化归因匹配是否正常。

3. 是否成功回调转化 callback。

若遇到其他问题，可查看 Q&A 文档。该文档涵盖了对接期间的注意事项、快手常见问题的排查方向，以及产生数据差异时，双方的协作流程。

！！