> For the complete documentation index, see [llms.txt](https://docs.targetpick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.targetpick.io/ios-sdk/inst-banner.md).

# 전면 배너

## 1. **전면배너 삽입**

* 전면 형태의 배너 광고물이 노출됩니다.
* 전면 배너의 종류로는 전면 확장, 전면 팝업(배경 투명, 배경 회색), 전면 동영상이 있습니다.

{% hint style="info" %}
아래와 같은 전면 형태의 배너 노출
{% endhint %}

<div align="left"><figure><img src="/files/v6XiFF54TmZAnTTKOtkZ" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/GwmwFZWFaF117K7fugf3" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/aLM9qcfwgPlRwyDVi3eC" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/y3jjU4iyOZSWbchYSedq" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/iJIBrGeNsUDMwDMuhrK6" alt="" width="153"><figcaption></figcaption></figure></div>

## **2. 전면 광고 연동**

{% hint style="info" %}
Interstitial 광고 객체 설정 (필수 세팅)
{% endhint %}

{% code lineNumbers="true" %}

```swift
//Model
let model = ADMZInterstitialModel(withPublisherID: 100,
    withMediaID: 200,
    withSectionID: 804313,
    withKeywordParameter: "KeywordTargeting",
    withOtherParameter: "BannerAdditionalParameters",
    withMediaAgeLevel: .under13Age,
    withAppID:"appID",
    withAppName: "appName",
    withStoreURL: "StoreURL",
    withSMS: true,
    withTel: true,
    withCalendar: true,
    withStorePicture: true,
    withInlineVideo: true,
    withPopupType: .FullSize)
```

{% endcode %}

{% hint style="info" %}
전면광고 이용자 정보 입력(선택 세팅)
{% endhint %}

{% code lineNumbers="true" %}

```swift
// 유저 정보 세팅                                          
model.setUserInfo(withGenderType: .Male,
    withAge: 15,
    withUserID: "mezzomedia",
    withEmail: "mezzo@mezzomedia.co.kr",
    withUserLocationAgree: false)
```

{% endcode %}

{% hint style="info" %}
전면 광고 요청 시작 및 이벤트 Handler설정&#x20;
{% endhint %}

{% code lineNumbers="true" %}

```swift
// 전면 광고 요청 시작 및 이벤트 Handler설정
ADMZInterstitialLoader.presentAd(fromViewController:self,withModel: model,withSuccessHandler: { code in
}, withFailedHandler: { code in
}, withOtherEventHandler: { code in
})       
```

{% endcode %}

## **3. 코드 설명**

| 코드                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 설명                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>let model = ADMZInterstitialModel(withPublisherID: 100,<br>     withMediaID: 200,<br>     withSectionID: 804313,<br>     withKeywordParameter: “KeywordTargeting”,<br>     withOtherParameter: “BannerAdditionalParameters”,<br>     withMediaAgeLevel: .under13Age,<br>     withAppID:”appID”,<br>     withAppName: “appName”,<br>     withStoreURL: “StoreURL”,<br>     withSMS: true,<br>     withTel: true,<br>     withCalendar: true,<br>     withStorePicture: true,<br>     withInlineVideo: true,<br>     withPopupType: .FullSize)</p> | <p>요청할 정보를 가지고있는 모델을 생성합니다.<br>- PublisherID: 퍼블리셔 ID<br>- MediaID: 미디어 ID<br>- SectionID: 섹션 ID<br>- KeywordParameter: 검색어<br>- OtherParameter: 기타 파라미터<br>- MediaAgeLevel: 사용자 연령대<br>- AppID: 앱 ID<br>- AppName: 앱 이름<br>- StoreURL: 앱스토어 URL<br>- SMS: 문자 사용 여부<br>- Tel: 전화번호 사용 여부<br>- Calendar: 캘린더 저장 사용 여부<br>- StorePicture: 스토어 이미지 사용 여부<br>- InlineVideo: 인라인 비디오 사용 여부<br>- PopupType: 전면 광고 팝업 타입</p> |
| <p>ADMZInterstitialLoader.presentAd(fromViewController:self,<br>    withModel: model,<br>    withSuccessHandler: { code in<br>               },<br>     withFailedHandler: { code in<br>               },<br>     withOtherEventHandler: { code in<br>               })</p>                                                                                                                                                                                                                                                                         | <p>전면 팝업광고 요청을 시작합니다.<br>- fromViewController : 성공시 팝업으로 올라올 Target ViewController<br>(null일경우 현재 최상단의 ViewController를 체크후 해당 ViewController위에 Popup으로 띄웁니다.)<br>- Model: 요청정보를 설정한 ADMZInterstitialModel<br>- SuccessHandler : 성공시 성공코드를 code 변수로 리턴합니다.<br>- FailHandler : 실패시 실패코드를 code 변수로 리턴합니다.<br>- OtherHandler : 성공 실패 외의 이벤트코드를 code 변수로 리턴합니다.<br>(ex: 광고 선택, 로고 선택 등)</p>                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.targetpick.io/ios-sdk/inst-banner.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.