API方式接入广告位
最后更新于
最后更新于
以下关于广告位展示顺序的说明，非常重要，请仔细阅读
广告位上展示创意顺序的处理流程如下：
选出该广告位上需要展示的广告计划上，eCPM最高的创意；
选出的创意，再根据每个创意的eCPM值，进行排序；
广告位按排序完的创意顺序，由高到低进行逐一展示，用户点击过后，切换至下一个创意；
若是同时展示多个创意的广告位，例如多icon广告位，则展示的顺序也是按创意的排序的顺序进行展示，api方式接入的，请查看下方的返回值中创意的排序规则说明。
通过接口请求到的返回值中创意的处理流程如下：
收到下发创意的请求；
服务器通过对广告位需要展示的创意，按eCPM从高到低进行排序后，按排序的顺序返回；
游戏客户端根据返回的创意顺序，进行广告渲染；
因此，对于通过api方式接入的广告位，我们返回的创意都是按顺序返回，希望广告位上创意展示在具体某个位置上，请根据广告位的形式，作实际的调整，我们强烈建议将高eCPM的创意放置在最吸量的位置上。
广告位上的同一个创意，单个用户，在一天内 4 次点击以及有过一次二次确认后，该创意所在的广告计划当天不会再下发创意。
目前天幕广告位接入的方式有两种：
组件化的方式接入（仅支持cocos、laya引擎）
api的方式接入，也就是本次内容说明的接入方式
我们建议使用组件化的方式接入广告位，若你的游戏引擎非cocos，laya，或是有其他特殊的需求，SDK组件无法满足，则可通过API的方式接入。
下面将会针对API的接入的方式进行详细说明。
涉及到的接口：
当你需要在游戏中展示广告的时候，可以通过调用SDK的getFlowConfig接口，传入广告位ID，获取广告位的配置。 注意：在调用SDK的getFlowConfig接口前，请先初始化。
当你调用了getFlowConfig，有几个返回值是需要特别注意的，要根据这些值来确定广告位的类型，并根据不同类型的广告位采用对应的处理方式。
如果创意列表creatives中有fps，那么对应的广告类型是浮动窗的多帧动图，返回的多个图片素材则需渲染为动态图片，按照fps的值进行图片轮播。
该广告创意实现的效果类似GIF。
type为7时，positionId对应的是猜你喜欢类型，图片尺寸为：200*200，请注意，猜你喜欢拥有多个创意，需要全部渲染处理。
这里有个非常重要的注意事项需要说明：
接口返回的创意数组，是根据预估收益从高到底进行排序，请将排序靠前的创意展示在游戏中点击率高（开发者根据游戏实际情况确定）的位置，以获取最大收益。
为了能使猜你喜欢广告展示效率达到最高，请按上述说明的需求对展示的猜你喜欢创意进行排序，位置需根据游戏实际情况确定，若未能确定或无特殊需求，可使用我们返回的创意顺序展示即可。
根据auto_change的返回值，自动刷新广告内容；
每次调用getFlowConfig，根据auto_change的返回值，设置一个Timer，调用getFlowConfig，展示接口返回的广告配置。
观察游戏中的广告，是否按照接口的返回值自动切换，可通过观察广告图片上的文字内容得知是否切换了广告。
根据在上述自动刷新说明的auto_change返回值设定的时间内，点击广告，自动刷新广告内容。
实现方法
点击后调用flowNavigate，使用flowNavigate接口的返回值，展示接口返回的广告配置。
执行了此刷新后，自动刷新中的timer重新计时。
点击游戏中的广告，可通过观察广告图片上的文字内容得知是否切换了广告。
点击后跳转的功能由SDK实现，开发者只需调用SDK中的flowNavigate接口，传入对应的广告位ID和创意ID即可。
在天幕-流量主后台的广告位管理页面，可找到对应广告位ID。
在调用了getFlowConfig后，返回的creativeId的值即为创意ID。
此功能的使用前提：调用了获取广告推广配置的getFlowConfig；
这个接口是用于在用户点击了广告位上的创意后，实现跳转到该创意指定的落地页功能。
例如，用户在a游戏某广告位上点击了推广b产品的创意，那么在用户点击后，可以跳转至b产品，这个跳转需要通过flowNavigate接口来实现。
这里需要注意：请提前将需要跳转的appid添加只game.json配置列表中，若对此不了解请参阅微信小程序跳转的规则文档，否则会导致跳转不成功
需要获取广告位的开启状态，请参阅以下接口：
若返回值type为1时，positionId对应的广告位类型是浮动窗类型中的静态图，图片尺寸为：190*270 如果创意列表creatives的show_config中，只有image，则只需渲染该静态图。
