# AP 미디에이션(Unity iOS)

## 1. 미디에이션 Adapter 다운로드

아래 링크를 통해 iOS 미디에이션 Adapter 를 다운로드 받으세요.

[\[애드팝콘 SSP iOS Mediation UnityPlugin Adapter\]](https://github.com/IGAWorksDev/AdPopcornSDK/raw/refs/heads/master/AdPopcornSSP/02-ios-sdk/MediationAdapter_Unity/APSSPMediationAdapter_Unity_260302.zip)

## 2. 미디에이션 적용

#### 2.1 Podfile

* Unity Tool에서 iOS 빌드 후, 생성되는 Xcode 프로젝트에 아래와 같이 Podfile을 추가 합니다.

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2F0KwgcviZS3kXkdLGiJOK%2Fimage.png?alt=media&#x26;token=2c4a8878-e231-4f1f-b9ec-79204742e586" alt=""><figcaption></figcaption></figure>

* PodFile 내, 사용하고자 하는 업체의 Pod 정보 입력합니다.

<pre><code>platform :ios, '14.0'

target 'UnityFramework' do
 pod 'Google-Mobile-Ads-SDK', '12.14.0'  # AdMob
 pod 'Ads-Global', '7.8.0.3'             # Pangle
 pod 'AppLovinSDK', '13.5.1'             # AppLovin
 pod 'UnityAds', '4.16.4'                # UnityAds
<strong> pod "VungleAds", '7.6.2'                # Vungle
</strong> pod 'Fyber_Marketplace_SDK', '8.4.2'    # Fyber
 
 # Meta(FAN) ==============> 수동 설치 필요 <a data-footnote-ref href="#user-content-fn-1">링크</a> (Static)
end

target 'Unity-iPhone' do
  inherit! :search_paths
end

</code></pre>

* pod update

터미널을 열고, 해당 프로젝트 폴더에서 pod update 명령을 통해 각 업체의 framework를 추가합니다.

#### **2.1-1 Meta 수동 설치 방법**

{% embed url="<https://developers.facebook.com/docs/audience-network/setting-up/platform-setup/ios/add-sdk?locale=ko_KR>" %}

해당 링크에 들어가서 '**수동 다운로드'** 를 통해 framework를 다운로드 해주세요.

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2Fl7Jy3CD96UdVHKupAWM4%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-01-21%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.21.15.png?alt=media&#x26;token=e22ba522-7e26-4575-a47e-f964cca37f88" alt=""><figcaption></figcaption></figure>

**Static Framework** Project 안에 넣어주세요.\
넣을 때 Target을 UnityFramework로 설정해주세요.

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FfaaEkk5Gj7YPC8v1RqHN%2Fimage.png?alt=media&#x26;token=562dbf6b-3a96-4646-ba38-1656b29de469" alt=""><figcaption></figcaption></figure>

#### 2.2 Unity-iPhone.xcworkspace 파일로 프로젝트 오픈

Unity-iPhone.xcworkspace 파일을 통해 프로젝트를 Xcode로 open 합니다. 반드시 <mark style="color:red;">`xcworkspace`</mark>로 open 해야, pod를 통해 다운로드 한, framework가 정상적으로 추가됩니다.

#### 2.3 Adapter 파일 추가

위 다운로드 파일에서 사용하고자 하는 ap-ssp-ios-mediation-adapter > CocoaPod 폴더 안에 있는 .h, .m 파일들을 프로젝트에 추가하면 됩니다.

반드시 아래와 같이 target을 UnityFramework로 설정하여 추가합니다.

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FWptY6zK6nFV4Eo14gjT5%2Fimage.png?alt=media&#x26;token=23e260a0-23bf-43f9-ad93-4d4ab0157c83" alt="" width="563"><figcaption></figcaption></figure>

## 3. Info.plist 설정

#### 3.1 SDK Key 값 설정

Info.plist 내 Admob 사용 시에는 아래와 같이 Key 값을 추가해 주어야 합니다.

{% tabs %}
{% tab title="Admob" %}

```
<key>GADApplicationIdentifier</key>
<string>Your Admob appid</string>
```

{% endtab %}
{% endtabs %}

Unity-IPhone, UnityFramework 두곳에 모두 추가해 주셔야 합니다.

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2F4rT8XR8J3c8wAMWqDcC9%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-01-21%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.10.40.png?alt=media&#x26;token=7048229f-7d80-4d79-b03e-869cec64cbcd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FR2UKPGcQAMSDfQXqDv9z%2Fimage.png?alt=media&#x26;token=8d6aa4b5-258f-4d67-9da3-8b409f2cf586" alt="" width="217"><figcaption></figcaption></figure>

## 4. 미디에이션 SDK 초기화

일부 업체의 경우 앱 시작 시, 초기화 코드를 삽입하라고 안내 하고 있습니다. 이에 UnityAppController.m 파일 내 아래메소드에서 각 업체별 초기화 코드를 삽입하시기 바랍니다.

```objective-c
#import "GoogleMobileAds/GoogleMobileAds.h" // Admob
#import "AppLovinSDK/AppLovinSDK.h" // AppLovin
#import "FBAudienceNetwork/FBAudienceNetwork.h" // Meta
#import "IASDKCore/IASDKCore.h" // Fyber
#import "PAGAdSDK/PAGAdSDK.h" // Pangle
#import "VungleAdsSDK/VungleAdsSDK-Swift.h" // Vungle
#import "UnityAds/UnityAds-Swift.h" // Unity
#import "UnityAds/UnityAds.h"       // Unity

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
{
    ...
    // Admob
    [[GADMobileAds sharedInstance] startWithCompletionHandler:nil]; 
    // UnityAds
    [UnityAds initialize:@"your_game_id" testMode:NO initializationDelegate:self];
    // Vungle
    [VungleAds initWithAppId:@"app_id" completion:^(NSError * _Nullable error) {

    }];
    // AppLovin
    ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey:
     @"Your AppLovin Sdk Key" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
        builder.mediationProvider = ALMediationProviderMAX;
    }];

    // Initialize the SDK with the configuration
    [[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
    }];
    
    // Meta
    [FBAudienceNetworkAds initializeWithSettings:nil completionHandler:nil];
    [FBAdSettings setAdvertiserTrackingEnabled:YES];
    
    // Fyber
    [[IASDKCore sharedInstance] initWithAppID:@"fyber_code"
                 completionBlock:^(BOOL success, NSError * _Nullable error) {
                   // handle result
                 }
                 completionQueue:nil];
  };
    
    // Pangle
    PAGConfig *config = [PAGConfig shareConfig];
    config.appID = @"pangle_code"; // pangle test code
    [PAGSdk startWithConfig:config completionHandler:^(BOOL success, NSError * _Nonnull error) {
        if (success) {
            //load ad data
        }
    }];
}
```

#### UnityAds SDK 초기화 설정 (주의)

```objective-c
#import "UnityAds/UnityAds-Swift.h" // Unity
#import "UnityAds/UnityAds.h"       // Unity


// 2-1. .m 파일 내부에 UnityAdsInitializationDelegate 연결 (아래 코드 직접 작성해야 함)
@interface UnityAppController () <UnityAdsInitializationDelegate> {    
}
@end

...

// 2-2. UnityAdsInitializationDelegate 연동연동으로 필수 함수 구현
@implementation UnityAppController
- (void)initializationComplete {
    
}

- (void)initializationFailed:(UnityAdsInitializationError)error withMessage:(nonnull NSString *)message {
    
}
```

## 5. 추가 설정 사항

Enmable Modules(C and Objecitve-C) 를 'Yes' 로 설정해주셔야 됩니다.

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2Fx9IAbSVLp8RNwOXRikMS%2Fimage.png?alt=media&#x26;token=a4653512-0e4c-4771-b382-7de57154bb67" alt=""><figcaption></figcaption></figure>

[^1]: <https://developers.facebook.com/docs/audience-network/setting-up/platform-setup/ios/add-sdk?locale=ko_KR>