广点通移动app多种转化类型数据统计-api上报方案对接文档api.pdf

广点通移动APP多种转化类型数据统计-API上报方案对接文档 （API方案二 ） 未分类 广点通移动APP多种转化类型数据统计-API上报方案对接文档 （API方案二 ） 1 文档介绍 2 API功能逻辑介绍 3 接入流程 4 转化数据上报接 口 4 1 转化数据上报接 口介绍 4 2 转化数据上报接 口格式 4 3 转化数据上报接 口参数介绍 4 4 转化数据上报接 口响应信息 4 5 转化数据上报接 口加密组装流程 4 6 加密密钥和签名密钥 4 7 data加密方案 4 7 1 data加密流程 4 7 2 组合参数生成query_string 4 7 3 利用query_string构造page 4 7 4 将page进行urlencode得到encode_page 4 7 5 将encode_page组装成property 4 7 6 利用property生成signature 4 7 7 利用signature和query_string生成base_data 4 7 8 利用base_data和encrypt_key生成data 4 8 组装请求 4 8 1 构造attachment 4 8 2 构造最终请求 4 9 muid加密方法 5 接入多种转化类型 5 1 多种转化类型介绍 5 2 接入多种转化类型 6 附录 6 1 转化数据上报接 口异常信息 6 2 muid加密代码示例 6 2 1 muid加密代码示例(Python) 6 2 2 muid加密代码示例(Java) 6 2 3 muid加密代码示例(PHP) 6 3 简单异或加密代码示例 6 3 1 简单异或加密代码示例(Python) 6 3 2 简单异或加密代码示例(Java) 6 3 3 简单异或加密代码示例(PHP) 6 4 关于文档 1 文档介绍 此文档面向广告主开发人员 ，用于描述API方案二的接入流程。 2 API功能逻辑介绍 3 接入流程 分工职责 开发人员 投放端操作人员 具体工作 1 完成转化数据上报接 口的开发 1 创建转化规则 2 提供转化规则相关信息给开发人员 ，包括 ：Appid ，账户id ，密钥 3 启用转化规则 4 转化数据上报接 口 转化数据上报接口用于用户将检测到的APP转化数据上报给广点通。 转化数据上报接口需广告主按照广点通提供的接 口格式补齐全部参数后将数据上传给广点通后台。 4 1 转化数据上报接 口介绍 在用户产生某种转化行为时 ，广告主上报对应的转化类型数据 ，广点通在收到数据后 ，关联点击数据和广告主上报的 转化数据。 广点通后台服务核对转化数据 ，在通过规则去重和防作弊后 ，数据将被记录为有效数据 ，并在广点通投放端展示该数 据。 ※广告主必须在检测到 PP发生该转化类型后实时将数据上报给广点通 ，以免出现统计无效的情况。 4 2 转化数据上报接 口格式 http :///conv/app/{appid}/conv?v={data}conv_type={conv_type}app_type= {app_type}advertiser_id={advertiser_id} 4 3 转化数据上报接 口参数介绍 名称 类型 描述 appid int Android应用为应用宝移动应用的id ，或者iOS应用在Apple App Store的id ；创建转化时 ， 需填入此appid 名称 类型 描述 data string