IOS积分墙 接入手册

1.前言

• 用于区别统计不通渠道的用户来源和数量；

2.使用说明

2.1.要求

• 每个ios渠道商需要有一个渠道编号(channelcode)和secretkey，然后请求我们的时候传上来并进行签名，以便我们区分是哪个渠道商的数据。

2.2. 流程

• 用户点击渠道商广告。

• 渠道商附带一些参数将用户302到美娱平台的用户点击页面。

• 平台统计消息之后跳转到下载页面。

• 当用户下载并注册之后，平台调用渠道商提供的注册通知接口通知渠道。

• 流程图示意：

  

2.3. 签名方法：

• 签名说明
  

  1) 调用方首先需要将请求的参数根据参数的key(ASCII码值)进行升序排序；
  

  2) 将排序好的接口请求参数和参数值按key=val&key2=val2…这样得格式拼装成一个字符串，并在最后加上渠道的secretkey；
  

  3) 对上述拼接好的字符串进行md5编码，获得最终的签名串；
  

• 代码示例（PHP）：

public function sign ($params, $secretkey) { // $params数组必须包含timestamp
$in = ksort($params);
$pairs = array();
foreach($in as $k => $v){
$pair[] = $k. '=' .$v;
}
$str = implode('&', $pair); // 拼接字符创
$str = $str.$ secretkey ; // 把secretkey补充到最后
return md5($str);
}

3.平台广告导入接口

• 说明：
  

  广告商的流量导入接口；

• 点击页面：
  

  地址： https://adv.sdo.com/v1/ioschannel/click

• 请求方式:
  

  GET

3.1.参数说明

• 参数列表：
  

  gameid: 游戏id；
  

  mac: 发起点击的客户端mac地址：格式E8:8D:28:D6:4A:B6
  

  idfa: 发起点击的客户端idfa；格式CBC62782-0788-4069-BD33-AA6302697992；idfa值请传递大写;
  

  channelcode: 渠道编号channelcode；
  

  timestamp: 请求时间，unix时间戳；
  

  extend: 扩展参数，回调时原样返回；
  

  idfaType: IDFA设备类型,不传递：表示使用明文idfa，传2：表示idfa=toupper(md5(toupper(idfa)))；
  

  callback_url: 回调链接，根据配置选择回调时是否回调此链接；
  

  sub_pub_id : 子渠道id，一个渠道下面细分的子渠道；
  

  sign: 签名；

• 签名参数：
  

  gameid, mac, idfa, channelcode, timestamp；

• 返回结果：
  

  302跳转到游戏下载地址；

• 接口说明：
  

  用户点击广告商广告之后附带参数302跳转到该地址， 美娱平台保证提供的页面不会包含相关参数名。

4.平台注册通知接口

• 说明
  

  注册成功后美娱通知接口；
  

  提供方：渠道；
  

  请求方：平台；
  

  地址：渠道商提供；
  

• 请求方式：
  

  GET

4.1.参数说明：

• 参数列表
  

  gameid: 游戏id
  

  mac:
  

  idfa:
  

  timestamp: 请求时间
  

  sign: 签名
  

  extend:如果点击的时候有extend,此时原样返回
  

• 签名参数：
  

  gameid, mac, idfa, timestamp

• 返回结果：
  

  success为成功，其他为失败