미디에이션 Unity iOS

미디에이션은 디스플레이 광고 지면에 타 광고 네트워크의 광고를 라이브 할 수 있는 기능을 의미하며, 내부/자체 광고의 운영 및 여러 국내/해외의 외부 광고를 노출 시킬 수 있어 수익 극대화에 효과적입니다.

주의사항

• 애드팝콘 SSP 미디에이션 연동하기 전에 반드시 애드팝콘 SSP 연동이 진행 되어야 합니다. [애드팝콘 SSP SDK 연동 (iOS Unity)]

• 각 업체별 호환 버전은 아래 가이드 바로가기 링크에 기재가 되어 있으니 확인 부탁 드립니다.

1. iOS ATS 정책 관련

iOS ATS 정책이란?

https://developer.apple.com/documentation/bundleresources/information_property_list/nsapptransportsecurity/

일부 미디에이션 제공 업체의 경우 https 를 제공하지 않고 있습니다. 또한 WebView를 사용하기 때문에 특정 도메인을 등록하는데 어려움이 있습니다.

따라서 아래와 같이 ATS를 전체 예외로 설정해주셔야 합니다.

SSP 미디에이션의 경우 상세 내용은 각 광고네트워크의 애플 ATS 지원 정책을 확인해주세요.

2. 미디에이션 Adapter 다운로드

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

[애드팝콘 SSP iOS Mediation UnityPlugin Adapter]

• SDK 호환성 체크 정보

Adapter 버전	설명
AdPopcornSSPMediationUnityPluginAdapter_250327.zip	AdMob, AppLovin, UnityAds, Vungle, Pangle, Fyber, FAN 업데이트
AdPopcornSSPMediationUnityPluginAdapter_240205.zip	AdMob, AppLovin, UnityAds, Vungle, Pangle framework 최신화
AdPopcornSSPMediationUnityPluginAdapter_230308.zip	AdMob, AppLovin, UnityAds, Vungle, Pangle 지원
AdPopcornSSPMediationUnityPluginAdapter_230226.zip	AdMob, AppLovin, UnityAds, Vungle 지원

3. 미디에이션 적용

1) Adapter 압축 풀기

다운로드 받은 SSP iOS Mediation UnityPlugin Adapter를 압축을 풀어줍니다. 압축을 풀 경우 아래와 같이 Adapter 폴더와 Podfile 이 포함되어 있습니다.

• AdPopcornSSPUnityMediationAdapter

  • 애드팝콘에서 지원하는 Mediation Adapter

• Podfile

  • 애드팝콘에서 지원하는 Mediation 업체의 Pod 설정 파일

  • 현재는 위 폴더에 포함되어 있는 버전을 사용하셔야 하며, 다른 버전을 사용하고자 할 경우, 애드팝콘 사업팀에 문의해 주시기 바랍니다.

2) Podfile 추가

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

3) 각 업체 framework 추가

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

4) Unity-iPhone.xcworkspace 파일로 프로젝트 오픈

Unity-iPhone.xcworkspace 파일을 통해 프로젝트를 Xcode로 open 합니다. 반드시 xcworkspace로 open 해야, pod를 통해 다운로드 한, framework가 정상적으로 추가됩니다.

5) AdPopcornSSPUnityMediationAdapter 폴더 추가

1번 단계에서 다운로드한 AdPopcornSSPUnityMediationAdapter 폴더를 아래와 같이 프로젝트에 추가합니다. 반드시 아래와 같이 target을 UnityFramework로 설정하여 추가합니다.

4. Info.plist 설정

1) SDK Key 값 설정

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

Admob

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

2) SKAdNetwork

일부 미디에이션 업체의 경우 SKAdNetwork 지원을 위해 info.plist 파일 내에 SKAdNetworkIdentifier 를 추가해 주어야 합니다. 이 부분은 각 업체의 가이드 문서에서 확인 후 추가해 주시기 바랍니다.

5. 미디에이션 SDK 초기화

일부 업체의 경우 앱 시작 시, 초기화 코드를 삽입하라고 안내 하고 있습니다. 이에 UnityAppController.m 파일 내 - (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions 메소드에서 각 업체별 초기화 코드를 삽입하시기 바랍니다. 자세한 사항은 하단 표에 연결된 각 업체별 가이드 문서를 참고해 주시기 바랍니다.

Admob

Objective-C

#import <GoogleMobileAds/GoogleMobileAds.h>

[[GADMobileAds sharedInstance] startWithCompletionHandler:nil];

UnityAds

@import UnityAds;
[UnityAds initialize:@"your_game_id" testMode:NO initializationDelegate:self];

Vungle

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
[VungleAds initWithAppId:@"app_id" completion:^(NSError * _Nullable error) {

}];

AppLovin

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
...
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) {
    // Start loading ads
}];

FAN(Meta)

#import <FBAudienceNetwork/FBAudienceNetwork.h>

[FBAudienceNetworkAds initializeWithSettings:nil completionHandler:nil];

// Pass user's consent after acquiring it. For sample app purposes, this is set to YES.
[FBAdSettings setAdvertiserTrackingEnabled:YES];

Fyber

#import <IASDKCore/IASDKCore.h>
ASDKCore.sharedInstance initWithAppID:@"fyber_code"
    completionBlock:^(BOOL success, NSError * _Nullable error) {}
    completionQueue:nil];

Pangle

#import <PAGAdSDK/PAGAdSDK.h>
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
        }
    }];

Mintegral

#import <MTGSDK/MTGSDK.h>

[[MTGSDK sharedInstance] setAppID:@"appid" ApiKey:@"appkey"];

6. 미디에이션 업체 리스트

업체 명	호환 버전	지원 포멧	가이드
Admob	11.10.0	배너 전면 네이티브 전면 비디오 리워드 비디오	https://developers.google.com/admob/ios/quick-start?hl=ko
UnityAds	4.12.5	전면 비디오 리워드 비디오	https://github.com/Unity-Technologies/unity-ads-ios
Vungle	7.4.1	전면 비디오 리워드 비디오	https://publisher.vungle.com/sdk/sdks/ios
AppLovin	13.0.1	배너 전면 전면 비디오 리워드 비디오	https://dash.applovin.com/docs/integration#iosIntegration
Mintegral	7.7.1	배너 네이티브 전면 비디오 리워드 비디오	http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-ios&lang=en
Fyber(FairBidSDK)	3.47.0	리워드 비디오	https://developer.fyber.com/hc/en-us/articles/360010915618-Integrating-the-iOS-SDK
Pangle	6.2.0.5	전면 비디오 리워드 비디오	https://www.pangleglobal.com/kr/integration/integrate-pangle-sdk-for-ios
Facebook Audience Network	6.14.0	전면 비디오 리워드 비디오	https://developers.facebook.com/docs/audience-network/guides/adding-sdk/ios