# SKOverlay

> 在 Unity Exchange 广告中实现 Apple 的 SKOverlay 功能，从而显示 App Store 覆盖层，促进 iOS 环境中的应用安装。

> **Note:**
>
> SKOverlay 仅适用于 iOS 应用。

SKOverlay 是一种动态广告格式，类似于屏幕底部的原生横幅。它提示用户立即下载所提供的应用，无需重定向到 App Store 或 Storekit 页面，因此可以使用更新版 SDK 为支持的发布者提高广告效果并增加每千次展示量 (IPM)。SKOverlay 还支持 SKAdNetwork 回传。

## 广告请求##bid-request

如果每个特定会话允许 SKOverlay，则 Unity 会在广告请求中进行标记，因为某些发布者会为其应用禁用 SKOverlay 功能。

如果允许 SKOverlay，Unity 将发送一个扩展以进行标记：`bidRequest.imp.ext.skadn.skoverlay: 1`。

## 广告返回##bid-response

对于使用 `bidRequest.imp.ext.skadn.skoverlay: 1` 发送的会话，Unity 允许 DSP 控制其是否要启用该功能。

Unity 希望读取在应用中启用还是禁用 SKOverlay 的广告返回，如下所示：

| 状态 | 广告返回                                                                                |
| -- | ----------------------------------------------------------------------------------- |
| 禁用 | 不要在广告返回中添加扩展                                                                        |
| 启用 | **resp.seatbid\[0].bid\[0].ext.skadn.skoverlay.show:1**，然后从 SKOverlay 控件表中选择受支持的选项。 |

### SKOverlay 控件##skoverlay-controls

| 属性           | 类型 | 示例 | 描述                                  | 值                                                |
| ------------ | -- | -- | ----------------------------------- | ------------------------------------------------ |
| show         | 整数 | 1  | 指示是否显示                              | `0` = no，`1` = yes                               |
| position     | 整数 | 1  | 覆盖层的位置                              | `0` = bottom，`1` = bottomRaised，默认值为 0           |
| dismissable  | 整数 | 5  | 指示用户是否可以关闭 SKOverlay                | `0` = no (static)，`1` = yes (dismissable)，默认值为 1 |
| video\_delay | 整数 | 5  | 显示 SKOverlay 前的延迟时间（以秒为单位），0 表示立即显示 | `0` = immediate，`60` = maximum，默认值为 5            |

如果 DSP 没有 SKOverlay 控件，Unity 将显示默认行为，其中包括：

* `0` = Position
* `1` = Dismissible
* `5` = Video\_delay