【加密简化api方案二】腾讯社交广告转化追踪

《【加密简化api方案二】腾讯社交广告转化追踪》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、【加密简化API方案二】腾讯社交广告转化追踪API上报方案对接文档v2.0【加密简化API方案二】腾讯社交广告转化追踪API上报方案对接文档v2.01.文档介绍2.API功能逻辑介绍3.分工职责4.转化数据上报接口4.1转化数据上报接口介绍4.2转化数据上报接口格式4.3参数处理流程4.4拼接参数介绍4.5构造post参数4.6加密密钥和签名密钥4.7muid加密方法5.附录5.1常用转化类型介绍5.2接入多种转化类型5.3接入加入购物车、付费行为的金额5.4转化数据上报接口异常信息5.5muid加密代码示例5.5.

2、1muid加密代码示例(Python)5.6注意事项5.7咨询渠道1.文档介绍此文档面向广告主开发人员，用于描述API方案二的接入流程。本文档简化了之前的加密流程，已经对接成功旧的（需要对data进行简单异或加密的版本）API方案二的用户无需再次对接。2.API功能逻辑介绍3.分工职责分工职责开发人员投放端操作人员具体工1.完成转化数据上报接口1.创建转化规则作的开发2.提供转化规则相关信息给开发人员，包括：Appid，账户id，密钥3.启用转化规则4.转化数据上报接口转化数据上报接口用于用户将检测到的APP转化数据

3、上报给腾讯社交广告。转化数据上报接口需广告主按照腾讯社交广告提供的接口格式补齐全部参数后将数据上传给腾讯社交广告后台。4.1转化数据上报接口介绍在用户产生某种转化行为时，广告主上报对应的转化类型数据，腾讯社交广告在收到数据后，关联点击数据和广告主上报的转化数据。腾讯社交广告后台服务核对转化数据，在通过规则去重和反作弊后，数据将被记录为有效数据，并在腾讯社交广告投放端展示该数据。广告主必须在检测到APP发生该转化类型后，实时将数据上报给腾讯社交广告，以免出现统计无效的情况。4.2转化数据上报接口格式https://t.

4、gdt.qq.com/conv/app/{appid}/conv整体请求采用https，post的方式进行第一版data加密方案不受影响（第一版继续使用http，get和旧的加密方式）4.3参数处理流程选取特定参数拼接成字符串后进行md5,输出32位小写字符串使用x-www-form-urlencoded方式构造post参数。4.4拼接参数介绍名称类型描述app_typestringapp类型；iOS应用取值为IOS，Android应用取值为ANDROID，联盟Android应用取值为UNIONANDROID，建议为

5、大写（已兼容大小写）click_idstring点击ID，腾讯社交广告采用API方案二对接的广告主和应用宝KA客户此参数为空client_ipstring转化发生用户的客户端IP，可以为空conv_timestring转化发生时间，取值为标准时间戳，秒级别muidstring设备id，由IMEI（Android应用）md5生成，或是由IDFA（iOS应用）md5生成；具体加密方案在muid加密方案有详细说明sign_keystring腾讯社交广告用户签名密钥，在腾讯社交广告秘钥有详细说明处理规则：按顺序拼接成一个字符

6、串最终输出字符串：app_type=ANDROID&click_id=007210548a030059ccdfd1d4&client_ip=10.11.12.13&conv_time=1422263664&muid=0f074dc8e1f0547310e729032ac0730b&sign_key=08ebe39d34c421b8注意：如果有的字段值为空，也需要填写，保证是这6个参数。例如click_id为空，字符串为：app_type=ANDROID&click_id=&client_ip=10.11.12.13&

7、conv_time=1422263664&muid=0f074dc8e1f0547310e729032ac0730b&sign_key=08ebe39d34c421b8顺序需与示例保持一致。对字符串md5示例示例字符串：app_type=ANDROID&click_id=&client_ip=&conv_time=1422263664&muid=0f074dc8e1f0547310e729032ac0730b&sign_key=08ebe39d34c421b8md5输出为：8d3fb6477b01827dc2f635

8、a5b45a7fdd4.5构造post参数参数名称类型描述click_idstring空白参数muidstring设备id，由IMEI（Android应用）md5生成，或是由IDFA（iOS应用）md5生成；（必填）具体加密方案在muid加密方案有详细说明参数名称类型描述appidintAndroid为应用宝ID，iOS为AppStore的ID