# Interstitial Ad

## 1. 기본 요건

* [<mark style="color:blue;">ADX iOS SDK</mark>](/adx/ios/integrate.md#adxlibrary-cocoapods)를 프로젝트에 추가합니다.
* Interstitial Ad용으로 발급받은 Ad Unit ID를 사용합니다.
* 광고를 요청하기 전에 [<mark style="color:blue;">SDK 초기화</mark>](https://platform-business.gitbook.io/adx/ios/sdk-integration/ad-formats/pages/O5ozkJcMAyY6hEZgu6km#1.-initialize-and-gdpr-content-ui)를 먼저 진행합니다.
  * **SDK 초기화는 앱 실행 시 한 번만 호출**하여 주시고, **광고 요청은 초기화가 완료된 후**에 이뤄져야 합니다.
  * iOS 14 이상 지원하는 경우, [<mark style="color:blue;">ATT(App Tracking Transparency)</mark>](/adx/ios/supporting-ios-14/app-tracking-transparency.md) 권한 요청 완료 후 광고를 요청해주세요.

## 2. 구현

1. `initWithAdUnitId:` 메서드를 사용하여 `ADXInterstitialAd`를 인스턴스화하고 `ADXInterstitialAdDelegate` callback을 등록합니다.
2. `loadAd`를 호출하여 광고를 로드합니다.
3. `isLoaded` 로 표시할 광고가 있는지 확인 후, `showAdFromRootViewController:`로 광고를 표시합니다.

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

```objectivec
#import <ADXLibrary/ADXInterstitialAd.h>

@interface InterstitialViewController () <ADXInterstitialAdDelegate>

@property (strong) ADXInterstitialAd *interstitialAd;

@end

@implementation InterstitialViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.interstitialAd = [[ADXInterstitialAd alloc] 
        initWithAdUnitId:@"<ADX_INTERSTITIAL_AD_UNIT_ID>"];
    self.interstitialAd.delegate = self;
}

- (IBAction)loadAd:(id)sender {
    [self.interstitialAd loadAd];
}

- (IBAction)showAd:(id)sender {
    if (self.interstitialAd.isLoaded) {
        [self.interstitialAd showAdFromRootViewController:self];
    }
}

#pragma mark - ADXInterstitialAdDelegate

- (void)interstitialAdDidLoad:(ADXInterstitialAd *)interstitial {
    NSLog(@"interstitialAdDidLoad");
}

- (void)interstitialAd:(ADXInterstitialAd *)interstitialAd didFailToLoadWithError:(NSError *)error {
    NSLog(@"interstitialAd:didFailToLoadWithError: %@", error);
}

- (void)interstitialAd:(ADXInterstitialAd *)interstitialAd didFailToShowWithError:(NSError *)error {
    NSLog(@"interstitialAd:didFailToShowWithError: %@", error);
}

- (void)interstitialAdWillPresentScreen:(ADXInterstitialAd *)interstitialAd {
    NSLog(@"interstitialAdWillPresentScreen");
}

- (void)interstitialAdWillDismissScreen:(ADXInterstitialAd *)interstitialAd {
    NSLog(@"interstitialAdWillDismissScreen");
}

- (void)interstitialAdDidDismissScreen:(ADXInterstitialAd *)interstitialAd {
    NSLog(@"interstitialAdDidDismissScreen");
}

- (void)interstitialAdDidClick:(ADXInterstitialAd *)interstitialAd {
    NSLog(@"interstitialAdDidClick");
}

@end
```

{% endtab %}

{% tab title="Swift" %}

```swift
import UIKit
import ADXLibrary

class InterstitialViewController: UIViewController {
    fileprivate var interstitialAd: ADXInterstitialAd!
    
    override func viewDidLoad() {
        super.viewDidLoad()

        interstitialAd = ADXInterstitialAd(adUnitId: 
            "<ADX_INTERSTITIAL_AD_UNIT_ID>");
        interstitialAd.delegate = self
    }
    
    @IBAction func loadAd(_ sender: Any) {
        interstitialAd.load()
    }
    
    @IBAction func showAd(_ sender: Any) {
        if interstitialAd.isLoaded {
            interstitialAd.show(fromRootViewController: self)
        }
    }
}

extension InterstitialViewController: ADXInterstitialAdDelegate {
    func interstitialAdDidLoad(_ interstitialAd: ADXInterstitialAd) {
        print("interstitialAdDidLoad")
    }
    
    func interstitialAd(_ interstitialAd: ADXInterstitialAd, didFailToLoadWithError error: Error) {
        print("interstitialAd didFailToLoadWithError")
    }
    
    func interstitialAd(_ interstitialAd: ADXInterstitialAd, didFailToShowWithError error: Error) {
        print("interstitialAd didFailToShowWithError")
    }
    
    func interstitialAdWillPresentScreen(_ interstitialAd: ADXInterstitialAd) {
        print("interstitialAdWillPresentScreen")
    }
    
    func interstitialAdWillDismissScreen(_ interstitialAd: ADXInterstitialAd) {
        print("interstitialAdWillDismissScreen")
    }
    
    func interstitialAdDidDismissScreen(_ interstitialAd: ADXInterstitialAd) {
        print("interstitialAdDidDismissScreen")
    }
    
    func interstitialAdDidClick(_ interstitialAd: ADXInterstitialAd) {
        print("interstitialAdDidClick")
    }
}
```

{% endtab %}
{% endtabs %}

## 3. Callback

`ADXInterstitialAdDelegate`를 설정하여 특정 이벤트를 수신할 수 있습니다.

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

```objectivec
- (void)interstitialAdDidLoad:(ADXInterstitialAd *)interstitialAd;
- (void)interstitialAdWillPresentScreen:(ADXInterstitialAd *)interstitialAd;
- (void)interstitialAdWillDismissScreen:(ADXInterstitialAd *)interstitialAd;
- (void)interstitialAdDidDismissScreen:(ADXInterstitialAd *)interstitialAd;
- (void)interstitialAdDidClick:(ADXInterstitialAd *)interstitialAd;
- (void)interstitialAd:(ADXInterstitialAd *)interstitialAd 
    didFailToLoadWithError:(NSError *)errorr;
- (void)interstitialAd:(ADXInterstitialAd *)interstitialAd 
    didFailToShowWithError:(NSError *)error;
```

{% endtab %}

{% tab title="Swift" %}

```swift
func func interstitialAdDidLoad(_ interstitialAd: ADXInterstitialAd) 
func interstitialAdWillPresentScreen(_ interstitialAd: ADXInterstitialAd) 
func interstitialAdWillDismissScreen(_ interstitialAd: ADXInterstitialAd)
func interstitialAdDidDismissScreen(_ interstitialAd: ADXInterstitialAd)
func interstitialAdDidClick(_ interstitialAd: ADXInterstitialAd)
func interstitialAd(_ interstitialAd: ADXInterstitialAd, 
    didFailToLoadWithError error: Error)
func interstitialAd(_ interstitialAd: ADXInterstitialAd, 
    didFailToShowWithError error: Error)
```

{% endtab %}
{% endtabs %}

## 4. Ad Revenue (paidEventHandler)

광고 노출에 대한 예상 광고 수익을 확인할 수 있습니다.

{% hint style="info" %}

* 아래 예제와 같이' `paidEventHandler`' 를 사용하여 예상되는 eCPM 값을 확인할 수 있습니다.
* 미디에이션 설정 과정에서 수동적으로 설정한 값과 정확한 값이 섞여 있어서 **예상 값으로 사용**하시는 것을 권장드립니다.
* eCPM의 통화(Currency) 단위는 USD입니다.
* 광고 매출 데이터를 MMP와 연동할 수 있습니다. 자세한 사항은 아래 SDK 연동 가이드를 참조해 주십시오.
  * [애드저스트(Adjust)의 AD(X) SDK 연동 가이드](https://dev.adjust.com/ko/sdk/ios/integrations/adx)
  * [에어브릿지(Airbridge)의 AD(X) SDK 연동 가이드](https://help.airbridge.io/ko/developers/ad-x-ad-revenue-integration#sdk-%EC%97%B0%EB%8F%99%ED%95%98%EA%B8%B0-ios)
    {% endhint %}

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

```objectivec
#import <UIKit/UIKit.h>
#import <ADXLibrary/ADXInterstitialAd.h>
#import <FirebaseAnalytics/FirebaseAnalytics.h>
#import <AppsFlyerAdRevenue/AppsFlyerAdRevenue.h>

@interface InterstitialViewController () <ADXInterstitialAdDelegate>
@property (strong) ADXInterstitialAd *interstitialAd;
@end

@implementation InterstitialViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    self.interstitialAd = [[ADXInterstitialAd alloc] 
        initWithAdUnitId:@"<ADX_INTERSTITIAL_AD_UNIT_ID>"];
                        
    self.interstitialAd.delegate = self;    
        
    __weak typeof(self) weakSelf = self;
    self.interstitialAd.paidEventHandler = ^(double eCPM) {
        __strong typeof(self) strongSelf = weakSelf;
        if(!strongSelf) { return; }
        NSNumber * revenue = [NSNumber numberWithDouble:eCPM/1000];
        [strongSelf handleAdRevenue:revenue];
    };
}

- (void)handleAdRevenue:(NSNumber *)revenue {
    // 1) Firebase Analytics
    [FIRAnalytics logEventWithName:kFIREventAdImpression parameters: @{
        kFIRParameterAdPlatform: @"AD(X)",
        kFIRParameterAdFormat: @"InterstitialAd",
        kFIRParameterAdUnitName: @"ADX Interstitial Ad",
        kFIRParameterCurrency: @"USD",
        kFIRParameterValue: revenune
    }];
        
    // 2) AppsFlyer
    NSDictionary * adRevenueParams = @{
        @"AdUnitName" : @"ADX Interstitial Ad",
        @"AdType" : @"InterstitialAd",
    };
    
    AppsFlyerAdRevenue * appsFlyerAdRevenue = [AppsFlyerAdRevenue shared];
    [appsFlyerAdRevenue 
        logAdRevenueWithMonetizationNetwork:@"AD(X)"
        mediationNetwork:AppsFlyerAdRevenueMediationNetworkTypeCustom
        eventRevenue:revenune
        revenueCurrency:@"USD"
        additionalParameters:adRevenueParams];
}

#pragma mark - ADXInterstitialAdDelegate
- (void)interstitialAdDidLoad:(ADXInterstitialAd *)interstitial {}
- (void)interstitialAd:(ADXInterstitialAd *)interstitialAd didFailToLoadWithError:(NSError *)error {}
- (void)interstitialAd:(ADXInterstitialAd *)interstitialAd didFailToShowWithError:(NSError *)error {}
- (void)interstitialAdWillPresentScreen:(ADXInterstitialAd *)interstitialAd {}
- (void)interstitialAdWillDismissScreen:(ADXInterstitialAd *)interstitialAd {}
- (void)interstitialAdDidDismissScreen:(ADXInterstitialAd *)interstitialAd {}
- (void)interstitialAdDidClick:(ADXInterstitialAd *)interstitialAd {}

@end
```

{% endtab %}

{% tab title="Swift" %}

```swift
import UIKit
import ADXLibrary
import FirebaseAnalytics
import AppsFlyerAdRevenue

class InterstitialViewController: UIViewController {
    var interstitialAd: ADXInterstitialAd!
    
    override func viewDidLoad() {
        super.viewDidLoad()

        interstitialAd = ADXInterstitialAd(adUnitId: 
            "<ADX_INTERSTITIAL_AD_UNIT_ID>")
        interstitialAd.delegate = self
        
        interstitialAd.paidEventHandler = { [weak self] eCPM in
            let revenue:NSNumber = (eCPM / 1000) as NSNumber
            self?.handleAdRevenue(revenue: revenue)
        }
    }
    
    func handleAdRevenue(revenue:NSNumber) {
        // 1) Firebase Analytics
        Analytics.logEvent(
            AnalyticsEventAdImpression,
            parameters: [
                AnalyticsParameterAdPlatform: "AD(X)",
                AnalyticsParameterAdUnitName: "ADX Interstitial Ad",
                AnalyticsParameterAdFormat: "InterstitialAd",
                AnalyticsParameterValue: revenune,
                AnalyticsParameterCurrency: "USD",
            ])
        
        // 2) AppsFlyer
        let adRevenueParams:[AnyHashable: Any] = [
            "AdUnitName" : "ADX Interstitial Ad",
            "AdType" : "InterstitialAd",
        ]
        
        AppsFlyerAdRevenue.shared().logAdRevenue(
            monetizationNetwork: "AD(X)",
            mediationNetwork: .custom,
            eventRevenue: revenune,
            revenueCurrency: "USD",
            additionalParameters: adRevenueParams)
    }
}

extension InterstitialViewController: ADXInterstitialAdDelegate {
    func interstitialAdDidLoad(_ interstitialAd: ADXInterstitialAd) {}
    func interstitialAd(_ interstitialAd: ADXInterstitialAd, didFailToLoadWithError error: Error) {}    
    func interstitialAd(_ interstitialAd: ADXInterstitialAd, didFailToShowWithError error: Error) {}    
    func interstitialAdWillPresentScreen(_ interstitialAd: ADXInterstitialAd) {}
    func interstitialAdWillDismissScreen(_ interstitialAd: ADXInterstitialAd) {}
    func interstitialAdDidDismissScreen(_ interstitialAd: ADXInterstitialAd) {}
    func interstitialAdDidClick(_ interstitialAd: ADXInterstitialAd) {}
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://platform-business.gitbook.io/adx/ios/sdk-integration/ad-formats/interstitial-ad.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.