多点广告PLAY红包对接文档

一、试玩流程

1. 用户领取PLAY任务的时候多点广告调用广告主提供的查询接口来判断该用户之前是否下过该app,允许老用户进行下载
2. 用户通过网页拉起该app,并且联网打开

二、接口说明

三、对接流程

1. 广告主开发查询接口。
2. 在自助对接页面配置后，模拟测试流程走通后提交即可。

注意事项

• 查询/排重接口多点广告每次只提交一个idfa，以6FD79122-8308-4804-A497-5D7BFE7FB554为例，请求广告主查询接口后，返回值必须是下载过{“6FD79122-8308-4804-A497-5D7BFE7FB554”:1} 或未下载过{“6FD79122-8308-4804-A497-5D7BFE7FB554”:0}这种格式，其中1表示安装过，0表示未安装过可以领任务。特别注意同一个idfa重复请求查询接口时,只要未激活一直返回0，激活后就返回1。
• 接口的超时时间为1秒，并发量每秒不低于300+次为宜。

四、例子

• 查询/排重、点击接口：如下图

  1. http请求方法：支持GET POST 两种任选一种。
  2. url地址：支持restful风格，不过参数需要手动填写，变量可以在多点广告内置变量中选取。
  3. Content-Type：目前暂时支持两种，application/x-www-form-urlencoded application/json
  4. 参数：参数名、参数值一一对应，参数名称可以根据自己需求调整，参数值目前分为自定义、多点广告内置变量两种，自定义顾名思义就是自己填写的固定值，多点广告内置变量是与广告投放相关的变量，在实际执行接口时，多点广告会统一替换内置变量为实际参数值。参见后面的表格。

  5. 解析类型目前支持以下三种格式

     • 标准格式 返回值为多点广告统一格式即：{“6FD79122-8308-4804-A497-5D7BFE7FB554”:1} 或{“6FD79122-8308-4804-A497-5D7BFE7FB554”:0}

       查询/排重接口返回1表示该idfa已经存在，返回0表示该idfa不存在，用户可以领取任务。

       点击接口返回1表示请求成功，返回0表示请求失败

     • httpCode

       查询/排重接口 httpcode返回200 表示该idfa已经存在，返回非200表示该idfa不存在，用户可以领取任务。

       点击接口httpcode返回200表示请求成功，返回非200表示请求失败

     • json

       目前json格式解析仅支持两层解析，例如返回格式为如下格式，这种是需要解析的结果中含有变量，稍微复杂一些，需要解析data层级内idfa对应的value 为1的情况
       >

       {
       "data": {
       "83F06F55-00F8-4B70-A25C-CF27A6323DCE": "0"   
       },
       "rtn_code": "0",
       "rtn_msg": "success"
       }
       

       配置如下图
       

     当例如返回格式为如下格式，一层解析，并且不含有变量，比较简单，仅解析rtn_msg 为success的时候
     >

         {
     "rtn_code": "0",
     "rtn_msg": "success"
        }
     

     配置如下图
     

     查询/排重接口当匹配到解析返回值的情况下认为idfa已经存在，当无法匹配的时候认为idfa不存在，用户可以领取任务。

     点击接口当匹配到解析返回值认为请求成功，当无法匹配的时候认为请求失败。