多Icon广告位 - 支持“多帧动图200*200”

阅读者:游戏开发人员

概述:

天幕卖量助手中,多Icon广告位之前一直只支持展示静态图片(单张图片);

SDK在v2.6.8版本后(2020.04/02上线),支持在多Icon广告位上展示动态图片(即多帧动图200*200类型的创意),如需要使用此功能,需要游戏开发者进行接入

具体接入方式,请根据自身情况参照下方的不同接入方案。

另:此种类型的创意只会在SDKv2.6.8及以上版本中下发,之前的历史版本的接口不会出现此类创意,所以,接入的时候,无需担心与线上版本的兼容问题。

接入:

情况1:老游戏(2020/04/02之前接入天幕),通过API方式接入多Icon广告位

如果您的游戏之前通过.getFlowConfig 接口接入了多Icon广告位,需要做如下处理:

1、更新最新的SDK文件

SDK版本v2.6.8及以上——2020/04/02号之后从天幕下载的即可

2、游戏代码针对新功能做兼容:

这是之前接口返回,有且只有静态图片(image只有一张图片)

{
    "creatives":[
        {
            "creativeId":162,
            "positionId":"1013280",
            "show_config":{
                //单张图片
                "image": "https://cdn.kuaiyugo.com/appprogram/tiger/admin/2018-11-06_6fe2c240-e1a7-11e8-bc47-27d9eee1c822.png",
                "title": '游戏名' 
            }
        }
    ]
}

现需要在代码中增加对动态图片的处理逻辑

当需要展示的是动态图片时,SDK接口的返回

{
    "creatives":[
        {                    
            "creativeId":162,
            "positionId":"1013280",
            "show_config":{
                //多张图片拼接成动态图片
                "images":[
                    "https://cdn.kuaiyugo.com/test/tianmu/2020-03-20_e16178806a5411eaa39ff9aa2d973067.png",
                    "https://cdn.kuaiyugo.com/test/tianmu/2020-03-20_e545dea06a5411eaa992514bb3382df2.png"
                ],
                "fps":5,
                "title":'游戏名' ,
                //同时依旧会返回image,可忽略
                "image": "https://cdn.kuaiyugo.com/appprogram/tiger/admin/2018-11-06_6fe2c240-e1a7-11e8-bc47-27d9eee1c822.png"
              },
        },
    ]  
}
  • 如果创意列表creatives中,有fps,且返回多张图片(images为list),则多个图片素材需渲染为动态图片——按照fps循环渲染每张图片

  • 示例:fps=5,意味着每秒播放5张图片,即0.2秒切换一张(并不是每5s切换一张图片!!)

  • 通过上述方式,在游戏中实现类似gif动图的效果

  • 同时接口返回中仍会有image(单张图片)返回(此为避免部分游戏SDK直接更新&&未做此部分处理,可能导致游戏异常而做的保险机制),可忽略。(SDK2.6.9-2020-04-22更新)

  • 关于点击后的跳转:即使是多张图片,仍旧是归属于同一个创意(creativeID),也就是说,跳转的时候,只会跳转到同一个游戏。参考跳转接口:.flowNavigate

  1. 静态图片和动态图片在同一个多Icon广告位上都有可能下发,所以两种情况都要做兼容。

  2. 记得需要对游戏中所有的多Icon广告位进行处理。

情况2:老游戏,通过组件化方式

如果您的游戏之前已经通过.flowNavigate 接口接入了猜你喜欢广告位,则只需更新SDK即可,无需额外处理(SDK版本v2.6.8及以上——2020/04/02号之后从天幕下载的即可)

情况3:新游戏(2020/04/02之后接入天幕)

只需要下载最新SDK,按照接入文档,完整接入天幕——卖量助手——广告位功能即可。

确认当前游戏完成接入后,请告知运营人员, 可在天幕——卖量助手后台上架“多帧动图200*200”类型的创意

最后更新于