多盟广告主Android App API激活数据对接
多盟无限网络技术(北京)有限公司
（Version：1.0.2）
(更新时间:2016-02-29)
目录
一、 二、
1. 2. 三、 四、 五、
目的 ........................................................................................................................... 2 说明 ........................................................................................................................... 2 对接APP标识 ......................................................................................................... 2 对接用户标识 ........................................................................................................... 3 解决方案 ................................................................................................................... 3 注意事项（以下注意点必须满足，否则视为对接不成功） ............................... 5 联系我们 ................................................................................................................... 6
一、 目的
在多盟平台上，为了能更加方便的统计到广告主所推广的APP的下载、激活等数据，特需广告主配合多盟做一些相关的工作。
对于每个推广的应用，广告主提供一条点击汇报链接。
当用户点击推广应用时，会通过多盟服务器访问点击汇报链接向广告主上报一条点击信息。 当广告主接收到推广应用的激活报告，若核对上了通过多盟带过去的点击，则回调多盟提供的应用激活回调接口。
二、 说明
1. 对接APP标识
? ?
说明：在双方进行数据对接时的APP唯一标识。 生成策略： ? ?
用户自定义
生成规则： ?
长度：限定为128位英文字符串
2. 对接用户标识
? ?
说明：用户设备的唯一标识，标明是谁(用户)产生的这个激活。 生成策略：目前支持imei、imeimd5设备标识。如下：
支持系统 Android Android 标识 imei Imeimd5 描述 示例 原始IMEI（International Mobile Equipment Identity） 864103021667081 原始IMEI经过MD5加密后小写 603ec871afa1677fdc7584e820719e8b ? 注意 ? 广告主根据点击链接中提供的各种设备id进行激活核对时，应根据以上列表中的优先级，依次检
查设备id是否匹配；如果点击链接中的某个设备ID参数取值为空串或没有提供，请务必视为无效值，继续尝试使用更低优先级的设备ID进行核对，直到各种设备ID都尝试完成。
三、 解决方案
由于有些流量甚至只提供imeimd5而不提供imei明文，所以技术对接激活核对时需要广告主支持按不同设备ID类型的优先级核对，核对流程：
? 用户点击广告时，多盟会将点击相关的设备ID发送到广告主提供的点击汇报链接
? 用户激活发生时，激活的设备ID（imei、imeimd5等）通过App发给广告主。广告主依次根据之
前一段时间内点击汇报链接中可能提供的imei、imeimd5参数，按优先级与激活的实际设备ID值比对，任意一种设备ID对上，都视为核对成功。核对成功时，应及时回调多盟的激活反馈接口。
? 用户点击广告后，可能好多天后才激活，这是客观情况。广告主收到激活时，必须往回尝试核对
至少30天的点击，以客观的反馈激活效果。多盟收到广告主发出的激活回调，视为广告主认可本设备产生的激活来自多盟的点击。
【广告主提供应用的推广链接】
? ? ?
请求方：用户
请求方式：GET，暂不支持POST 接口地址： ? ?
广告主提供请求地址，比如：http://www.yourdomain.com/domob 请求参数：（可指定参数，但是参数值需说明生成规则） 参数 app标识 imei imeimd5 渠道来源 必须 Y Y Y N 描述 请广告主给出一个固定的值，作为App的唯一标识，参考说明中的对接APP标识 用户设备标识imei，参考说明中的对接用户标识 点击设备的imei md5后小写值 固定值，用来区分点击来源渠道