# SKOverlay

> Apple の SKOverlay 特徴を Unity Exchange 広告に実装して、iOS 環境内でのアプリケーションのインストールを促進する アプリストア オーバーレイをディスプレイします。

> **Note:**
>
> SKOverlay は iOS アプリのみで利用可能です。

SKOverlay は、画面下部のバナーな広告形式です。提供されるアプリを アプリストア や Storekit ページにリダイレクトせずに即座にダウンロードするようユーザーに促すことで、広告のパフォーマンスが向上し、インプレッション単価（IPM）が向上するため、更新された SDK を使用してパブリッシャーをサポートします。SKOverlay は SKAdNetwork ポストバックもサポートします。

## 入札リクエスト##bid-request

Unityは、特定のセッションごとにSKOverlayが許可されているかどうかを入札リクエストでフラグを立てます。これは、パブリッシャーによってはアプリケーションのSKOverlay特徴が無効になっているためです。

SKOverlay が許可されている場合、Unity はフラグ `bidRequest.imp.ext.skadn.skoverlay: 1` に単一の拡張子を送信します。

## 入札反応##bid-response

`bidRequest.imp.ext.skadn.skoverlay: 1` で送信されるセッションでは、Unity は DSP がこの機能を有効にするかどうかをコントロールできるようにします。

Unity は、アプリケーションで SKOverlay を有効または無効にする入札反応を次のように読み取ります。

| status  | 入札反応                                                                                                     |
| ------- | -------------------------------------------------------------------------------------------------------- |
| 無効      | 入札反応に拡張子を追加しないでください                                                                                      |
| 有効にするには | **resp.seatbid\[0].bid\[0].ext.skadn.skoverlay.show:1** を選択し、SKOverlay コントロールテーブルからサポートされているオプションを選択します。 |

### SKOverlay コントロール##skoverlay-controls

| 属性           | Type (タイプ) | 例 | 説明                                       | 値                                        |
| ------------ | ---------- | - | ---------------------------------------- | ---------------------------------------- |
| show         | 整数         | 1 | 表示するかを示します。                              | `0` ＝ no， `1` ＝yes                       |
| position     | 整数         | 1 | オーバーレイの位置                                | `0` = bottom、`1` = bottomRaised、デフォルトは 0 |
| 却下可能         | 整数         | 5 | SKOverlayをユーザーが削除できるかどうかを示します。           | `0` = no (静的)、`1` = yes (破棄可能)、デフォルト値は 1 |
| video\_delay | 整数         | 5 | SKOverlay が表示されるまでの遅延時間 (秒)。0 は即時を意味します。 | `0` ＝ immediate、`60` ＝ maximum、デフォルト値は 5 |

DSP に SKOverlay コントロールがない場合、Unity は以下のようなデフォルト動作を表示します。

* `0` = Position (位置)
* `1`= 却下
* `5` = Video\_delay