> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/sdk/ios/ios-2.x.x/undefined-3.md).

# 전면 비디오 광고

 

## 1. 인스턴스 생성

{% tabs %}
{% tab title="Objective-C" %}
광고를노출하고자 하는 ViewController.m에 AdPopcornSSPInterstitialVideoAd.h를 import 하고 인스턴스 변수를 선언 합니다.

```objectivec
#import <AdPopcornSSP/AdPopcornSSPInterstitialVideoAd.h>
					
@interface AdPopcornSSPInterstitialVideoADViewController () <AdPopcornSSPInterstitialVideoAdDelegate>	
{										
    AdPopcornSSPInterstitialVideoAd *_sspInterstitialVideoAd;					
} 										
@end	

```

{% endtab %}

{% tab title="Swift" %}
광고를 노출하고자 하는 ViewController.swift 에 AdPopcornSSPInterstitialVideoAd 인스턴스 변수를 생성합니다.

```swift
class ViewController: UIViewController, APSSPInterstitialVideoAdDelegate
{	
    // InterstitialVideoAd
    var interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!
}

```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Objective-C" %}
ViewController.m 을 수정하여 생성한 인스턴스를 구현 합니다.

```objectivec
@implementation AdPopcornSSPInterstitialVideoADViewController () 					
- (void) viewDidLoad									
{										
    _sspInterstitialVideoAd = [[AdPopcornSSPInterstitialVideoAd alloc] initWithKey: @"YOUR_APP_KEY" placementId: @"YOUR_PLACEMENT_Id" viewController:self];							
} 
@end
```

{% endtab %}

{% tab title="Swift" %}
ViewController.swift 을 수정하여 생성한 인스턴스를 구현합니다.

```swift
class ViewController: UIViewController, APSSPInterstitialVideoAdDelegate
{	
    // InterstitialVideoAd
    var interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!
    
    override func viewDidLoad() {
        super.viewDidLoad()
	interstitialVideoAd= AdPopcornSSPInterstitialVideoAd.init(key: "YOUR_APP_KEY", 
	placementId: "YOUR_PLACEMENT_Id", viewController: self)        
    }
}

```

{% endtab %}
{% endtabs %}

### 1) Placement ID 변경

전면 비디오 인스턴스 생성 시 사용한 placementID를 변경하고자 할 경우, 아래와 같은 방식으로 변경합니다.

{% tabs %}
{% tab title="Objective-C" %}

```objectivec
_sspInterstitialVideoAd.placementId = @"변경하고자 할 ID";
```

{% endtab %}

{% tab title="Swift" %}

```
interstitialVideoAd.placementId = @"변경하고자 할 ID"
```

{% endtab %}
{% endtabs %}

## 2. 전면 비디오 광고 요청

<mark style="color:red;">`loadRequest`</mark> API를 호출 하여 전면 비디오 광고를 불러옵니다.

{% tabs %}
{% tab title="Objective-C" %}

```objectivec
[_sspInterstitialVideoAd loadRequest];
```

{% endtab %}

{% tab title="Swift" %}

```swift
interstitialVideoAd.loadRequest()
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
loadRequst 호출에 대한 결과로 광고 수신에 실패한 경우에는 loadAd 재호출을 하시면 안됩니다. 과도한 광고 요청 api 호출은 block 사유가 됩니다.
{% endhint %}

## 3. 전면 비디오 광고 노출

{% tabs %}
{% tab title="Objective-C" %} <mark style="color:red;">`presentFromViewController`</mark> API를 호출하여 전면 비디오 광고를 불러옵니다.

```objectivec
[_sspInterstitialVideoAd presentFromViewController:self];
```

{% endtab %}

{% tab title="Swift" %} <mark style="color:red;">`present`</mark> API를 호출하여 전면 비디오 광고를 불러옵니다.

```swift
interstitialVideoAd.present(from:self)
```

{% endtab %}
{% endtabs %}

## 4. 델리게이트 설정

전면 비디오 광고에서 발생하는 이벤트에 대한 델리게이트를 제공 합니다. 델리게이트를 사용하기 위해서는 <mark style="color:red;">`APSSPInterstitialVideoAdDelegate`</mark>를 추가 하여야 합니다.

\_sspInterstitialVideoAd 인스턴스에 delegate를 설정하고 구현하여야 합니다.

{% tabs %}
{% tab title="Objective-C" %}

| delegate                                | 설명                                                                 |
| --------------------------------------- | ------------------------------------------------------------------ |
| APSSPInterstitialVideoAdLoadSuccess     | 비디오광고 로드 성공                                                        |
| APSSPInterstitialVideoAdLoadFail, error | 비디오광고 로드 실패. [에러코드 값](/ssp-sdk/sdk/ios/ios-3.1.0+/undefined-13.md) |
| APSSPInterstitialVideoAdShowSuccess     | 비디오광고 노출 성공                                                        |
| APSSPInterstitialVideoAdShowFail        | 비디오광고 노출 실패                                                        |
| APSSPInterstitialVideoAdClosed          | 비디오광고 닫기                                                           |
| {% endtab %}                            |                                                                    |

{% tab title="Swift" %}

| delegate                                | 설명                                                                 |
| --------------------------------------- | ------------------------------------------------------------------ |
| apsspInterstitialVideoAdLoadSuccess     | 비디오광고 로드 성공                                                        |
| apsspInterstitialVideoAdLoadFail(error) | 비디오광고 로드 실패. [에러코드 값](/ssp-sdk/sdk/ios/ios-3.1.0+/undefined-13.md) |
| apsspInterstitialVideoAdShowSuccess     | 비디오광고 노출 성공                                                        |
| apsspInterstitialVideoAdShowFail        | 비디오광고 노출 실패                                                        |
| apsspInterstitialVideoAdClosed          | 비디오광고 닫기                                                           |
| {% endtab %}                            |                                                                    |
| {% endtabs %}                           |                                                                    |

{% tabs %}
{% tab title="Objective-C" %}

```objectivec
#import "AdPopcornSSPInterstitialVideoADViewController.h
						
@interface AdPopcornSSPInterstitialVideoADViewController() <APSSPInterstitialVideoAdDelegate>		
@end											
											
@implementation AdPopcornSSPInterstitialVideoADViewController						
											
- (void)viewDidLoad {																			
    [super viewDidLoad];												
    // 전면 비디오 광고 델리게이트 설정								
    _sspInterstitialVideoAd.delegate = self;								
}											
											
// 전면 비디오 광고 델리게이트 구현									
- (void)APSSPInterstitialVideoAdLoadSuccess:(AdPopcornSSPInterstitialVideoAD *)interstitialVideoAd;						
{													
   [_sspInterstitialVideoAd presentFromViewController:self];						
}											
											
- (void)APSSPInterstitialVideoAdLoadFail:(AdPopcornSSPInterstitialVideoAd *)interstitialVideoAd error:(AdPopcornSSPError)error			
{														
}	
										
- (void)APSSPInterstitialVideoAdShowSuccess:(AdPopcornSSPInterstitialVideoAD *)interstitialVideoAd				
{													
}		
									
- (void)APSSPInterstitialVideoAdShowFail:(AdPopcornSSPInterstitialVideoAd *)interstitialVideoAd							
{												
}	
										
- (void)APSSPInterstitialVideoAdClosed:(AdPopcornSSPInterstitialVideoAD *)interstitialVideoAd							
{													
}													
@end	
```

{% endtab %}

{% tab title="Swift" %}

```swift
class ViewController: UIViewController, APSSPInterstitialVideoAdDelegate
{	
    // InterstitialVideoAd
    var interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!
    
    override func viewDidLoad() {
	super.viewDidLoad()
	interstitialVideoAd= AdPopcornSSPInterstitialVideoAd.init(key: "YOUR_APP_KEY", 
	placementId: "YOUR_PLACEMENT_Id", viewController: self)        
    }

    // InterstitialVideoAd Delegate
    func apsspInterstitialVideoAdLoadSuccess(_ interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!) {
    }
    func apsspInterstitialVideoAdLoadFail(_ interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!, error: AdPopcornSSPError!) {
    }
    func apsspInterstitialVideoAdShowSuccess(_ interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!) {
    }
    func apsspInterstitialVideoAdShowFail(_ interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!) {
    }
    func apsspInterstitialVideoAdClosed(_ interstitialVideoAd: AdPopcornSSPInterstitialVideoAd!) {
    }
}
```

{% endtab %}
{% endtabs %}