API方案二 - 智汇大学.PDFVIP

智汇推 APP 下载广告 激活转化数据统计客户使用指南_API 方案二 （2017.2 ） 2017 年 2 月 目录 一、 对接方案概述3 二、 API 方案二详述 4 三、 名词解释6 四、 接口说明7 五、 常见问题11 一、 对接方案概述 激活数是 APP 广告主衡量转化效果的重要指标。为了更加方便、准确的统计到广告主 所推广的 APP 的激活数据，智汇推为广告主提供了移劢APP 激活统计的方案：分为 API 方 案一与 API 方案二，适用于 Android 和 iOS。如下为API 方案一与 API 方案二区别的区别：  API 方案一：广告主自建服务以接收智汇推点击数据与自身APP 激活数据相关  API 方案二：智汇推搭建服务接收广告主 APP 激活数据与自身点击数关联 本文档介绍 API 方案二 ，API 方案一请见文档： 《智汇推APP 下载广告_激活转化数据 统计客户使用指南_API 方案一》 注：由于SDK 方案成本过高，在稳定性、兼容性、集成性上与各类 APP 集成均存在一 定的维护和升级风险，且仅支持 Android 应用 ，因此智汇推仅提供 API 方案进行接入。 二、 API 方案二详述 API 方案二：智汇推搭建服务接收广告主 APP 激活数据与自身点击数关联 1. 数据流示意图： 2. 流程说明： 1) 当广告主收到用户激活数据后，第一时间（准实时 ，小时级）将 APP 激活数据回传给 智汇推接收接口 2 ； 2) 智汇推系统根据广告主上传的 APP 激活数据与点击数据进行关联对比计算出智汇推带 来的激活量 3) 将激活数据与广告系列、广告组、广告创意匹配后，在智汇推运营系统进行展示。 3. 操作界面示意图 三、 名词解释 1. 激活：用户安装 APP 之后第一次联网； 2. 激活时间：用户安装 APP 之后第一次联网的时间； 3. 激活量：智汇推统计的激活量是广告点击后N 天内带来的激活（N=15 ）； 4. sign_key : 从智汇推投放平台创建转化规则，自助获取密钥，⽤于加密的参数签名； 5. encrypt_key ：从智汇推投放平台创建转化规则，自助获取密钥，⽤于加密的参数加密； 6. click_id ：智汇推点击追踪 ID ，智汇推系统中标识用户每次点击生成的唯一标识； 7. appid ：移动应用id ，android 为开放平台移动应用 id （非应用宝 id ），ios 为AppleID ； 8. app_type ：app 类型，取值为 android 或 ios ；注意是小写 ； 9. advertiser_id ：广告主账户id ； 10. muid ：设备标识 ID ，是后台上报方案对比激活数据的依据； a) Android 设备-muid 加密规则：IMEI 号(需转小写) ，进行md5sum 以后得到的 32 位 全小写 MD5 表现字符串。 b) IOS 设备-muid 加密规则：IDFA 码（需转大写），进行 md5sum 以后得到的 32 位 全小写 MD5 表现字符串。 11. conv_type 转化类型 ，取值为 MOBILE_APP_ACTIVITE 12. conv_time 转化发生时间标准时间戳（秒级别）； 13. client_ip 用户转化时发生的外网IP 四、 接口说明 4.1 接口 2 ：智汇推接收广告主APP 激活数据 由于 APP 激活效果统计有时间期限限制，目前暂定 15 天。因此，广告主必须在收到 APP 激活后第一时间 （准实时，小时级 ）将数据上报给智汇推，以免出现统计无效的情况。 智汇推收到广告主发送的用户设备标识 ID 后 ，通过自建服务反查出具体效果数据，此 时便可以记录APP 激活效果。 接口概要 A、请求方：广告主 APP 激活数据后台 B、处理方：智汇推后台 C、请求协议：http D、请求方式：GET E、请求地址：智汇推提供的请求地址，比如：/conv/app/{appid}/conv 请求格式 /conv/app/{appid}/