媒体API接入文档

一、接入流程

  1. 您在获取到Testin云测互动广告媒体平台的账号后,登录媒体主管理端。
  2. 在对接人指导后创建媒体和广告位;在广告位通过审核后,即可获得游戏URL;如果您需要素材,请将要求提交给对接人,随后我们会根据要求进行设计并在您确认后上传到素材管理中,此时您在获取游戏链接的地方就可以获取素材URL了。
  3. 根据实际需求在您的客户端集成素材URL和游戏URL。
  4. 测试联调。
  5. 上线运营,并通过媒体平台查看运营数据,收益等。

二、接口参数说明

素材URL接口

参数 是否必填 类型 参数说明
appKey String 唯一标识媒体产品,广告位URL连接中自动携带
adSeatId String 广告位id
deviceId String 设备id

注意:为避免图片缓存导致素材URL请求一次后不再被请求,可在素材URL后拼接随机参数。确保每一次请求素材URL是不相同的,可绕过缓存。

游戏URL接口

参数 是否必填 类型 参数说明
appKey String 唯一标识媒体产品,广告位URL连接中自动携带
adSeatId String 广告位id
reqTime Long 请求时间戳
deviceInfo String 用户设备信息经过处理后的参数
sign String 签名
deviceInfo设备信息说明
字段 类型 说明 格式 类型
deviceId String 唯一标识媒体产品,广告位URL连接中自动携带 设备信息
app_list String app安装列表,逗号分隔并且是非系统应用的app应用名称 设备信息
net_type String 网络类型:wifi/2G/3G/4G wifi,2G,3G,4G 设备信息
os String 操作系统: Android,iOS,H5 设备信息
longitude String 经度 100.78 设备信息
latitude String 纬度 30.23 设备信息
page_content_keywords String 页面关键字 教育,现金,分期 页面信息
page_type String 页面类型 教育,育儿,汽车,房地产,测试 页面信息
gender String 性别 男,女 用户信息
age String 年龄 0-10,10-15 用户信息
prof String 职业 医生,护士,程序员,学生 用户信息
interests_content String 用户浏览频率最高内容类目关键词,以逗号分隔的类目关键词 股票,彩票 用户信息
location String 位置标签 商场,学校,火车站,机场,酒店,家 用户信息
edu String 学历 小学及以下,初中,高中,大学本科,硕士及以上 用户信息
hobby String 爱好 参见兴趣爱好对照表 用户信息
income String 收入 低,中,高 用户信息
consume String 消费能力 低,中,高 用户信息
marriage String 婚姻 未婚,已婚 用户信息
use_period String 使用时段 09-11,20-22 用户信息
has_car String 是否有车 是,否 用户信息
has_house String 是否有房 是,否 用户信息
has_child String 是否有小孩 是,否 用户信息

将上面表格中的所有字段转换为json字符串,进行url_encode

sign(签名)生成步骤
  1. 签名通过媒体方的adSeatId,appKey,appSecret, deviceInfo,reqTime 按字典排序。
  2. 将参数按&adSeatId=?&appKey=?&appSecret=?&deviceInfo=?&reqTime=?的形式拼接成的字符串进行Md5加密。注意:deviceInfo加密时不需要进行url-encode处理,只在url拼接时使用
  3. Testin云测互动广告服务器获取加密串后与sign参数比对,校验媒体方是否是授信方。

    样例

  4. 素材URL https://t.testin.cn/sspserver/adSeat?appKey=?&adSeatId=?&deviceId=?

  5. 游戏URL

    • 设备信息:{\"deviceInfo\":\"ccf76c4a-b737-41e3-a613-7a21453193f0\",\"nt\":\"4G\"}

    • appKey: ddbefc27-04cc-48fd-9f70-95825803ad83

    • adSeatId: W20920482

    • reqTime:1519800315000

    • appSecret:b0f4bfab-2f06-4dc8-b509-cbf0bdead26c

    • 以上信息加密后sign值为:1a371374d73288d6da70b97845d02795

    • 将deviceInfo进行url_encode后最终连接如下:

      https://t.testin.cn/sspserver/gameView?appKey=ddbefc27-04cc-48fd-9f70-95825803ad83&adSeatId=W20920482&reqTime=1519800315000&deviceInfo=%7B%22deviceId%22%3A%22ccf76c4a-b737-41e3-a613-7a21453193f0%22%2C%22nt%22%3A%224G%22%7D&sign=1a371374d73288d6da70b97845d02795

      三、兴趣爱好参照表

类目 明细
金融理财类偏好 网贷,p2p,彩票,保险,信用卡用户,投资理财,炒股
游戏类偏好 休闲游戏,棋牌,网络游戏,儿童教育,体育,竞速,动作射击,角色扮演
购物类偏好 网购,海淘,酒水,服装,食品…
旅游类偏好 商务出行,休闲旅游,酒店住宿,周边游,出国游
网络社交偏好 聊天类,单身社交,婚恋
运动健康类偏好 运动健身,减肥,健康医疗
教育类偏好 学前教育,中小学教育,成人教育,英语,其他外语,出国,it,其他培训
新闻阅读类偏好 新闻,杂志,小说,听书,漫画,搞笑,体育,财经,健身
摄影类偏好 使用美颜类相机,图片分享,摄像爱好
丽人母婴 化妆品...

results matching ""

    No results matching ""