# SKOverlay Support

* Chartboost supports SKOverlay starting from iOS SDK 9.1 and above, and is eligible to be used with full-screen ads on iOS14+.
* **Important**: Displaying the SKOverlay generates a SKAN `fidelity:1` engagement event for SKAN attribution, but clicks on the SKOverlay itself cannot be detected by the SDK, since Apple does not provide any click callback or event emissions. This means `ClickThrough`, `ClickTracking`, `CompanionClickThrough`, and `CompanionClickTracking` are not fired when SKOverlay is shown nor when the user clicks on the SKOverlay.

## BidRequest.imp[].ext.skadn.ext.skoverlay (Attribute)

Chartboost will signal whether an impression is eligible for SKOverlay or not by passing a custom `skoverlay` field in the `imp[].ext.skadn.ext` object. For eligible requests the `skoverlay` field will denote a `1`. The `skoverlay` field will be omitted if not an eligible bid request.


| Field       | Type |  Description | Example |
|-------------|------|--------------|---------|
|<span style="font-family:Courier New">skoverlay</span> | Integer | Indicates whether SKOverlay is supported. Value is `1` if eligible, otherwise omitted from the bid request.  | `1` |

**Example**
```json
{
  "ext": {
    "skoverlay": 1
  }
}
```

## BidResponse.seatbid.bid.ext.skadn.ext.skoverlay (Object)

For creatives using SKOverlay, Chartboost requires at minimum the `seatbid.bid.ext.skadn.ext.skoverlay.show` field within the bid response.


| Field       | Type | Required |  Description | Example |
|-------------|------|----------|--------------|---------|
| <span style="font-family:Courier New">delay</span> | Integer | Optional | Time in seconds to delay before showing the SKOverlay, where 0 means immediate. If this field is not set, the overlay will not be shown. | `5` |
| <span style="font-family:Courier New">autoclose</span> | Integer | Optional | Time in seconds before automatically dismissing SKOverlay, where 0 = SKOverlay is not automatically dismissed. Maximum value is 60. | `0` |
| <span style="font-family:Courier New">dismissible</span> | Integer | Optional | Indicates whether the SKOverlay can be dismissed by the user, where 0 = no and 1 = yes. | `1` |
| <span style="font-family:Courier New">pos</span> | Integer | Optional | Position of SKOverlay, where 0 = bottom and 1 = bottomRaised. | `1` |

**Example**
```json
{
  "skoverlay": {
    "delay": 5,
    "autoclose": 0,
    "dismissible": 1,
    "pos": 1
  }
}
```

### Display and Behavior

#### Display Conditions

- SKOverlay can be displayed over the video ad and end card.
- SKOverlay is visible upon showing the ad if it's supported in the ad response.

#### Dismissal and Reappearance

- If the user dismisses the SKOverlay and then clicks on the video, the user will be redirected to the App Store, firing the MMP click.
- [`autoclose`](/en/partners/exchange/skoverlay-support/#bidresponseseatbidbidextskadnextskoverlay-object) can be used to automatically close the SKOverlay after a specified number of seconds.
- Upon dismissal by the user, the SKOverlay will not reappear if clicked again. Instead, the [StoreKit](https://developer.apple.com/documentation/storekit){:target="_blank"} will be displayed.