内容发布更新时间 : 2024/11/13 12:54:47星期一 下面是文章的全部内容请认真阅读。

多盟广告主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后小写值 固定值，用来区分点击来源渠道