- Xcode 최소 사양 15.3
- BASE SDK : iOS
- iOS Deployment Target : 12.0
- Podfile 내부에 다음 코드 추가
platform :ios, "12.0"
target "Runner" do
use_frameworks!
# NECESSARY
pod 'BidmadSDK', '6.6.1'
pod 'OpenBiddingHelper', '6.6.1'
pod 'BidmadGoogleAdMobAdapter', '11.2.0.0'
pod 'BidmadGoogleAdManagerAdapter', '11.2.0.0'
pod 'BidmadAppLovinAdapter', '12.2.1.0'
pod 'BidmadUnityAdsAdapter', '4.9.3.0'
pod 'BidmadPangleAdapter', '5.8.0.7.0'
pod 'BidmadFyberAdapter', '8.2.6.0'
pod 'BidmadVungleAdapter', '7.2.2.0'
pod 'BidmadPubmaticAdapter', '3.2.0.3'
pod 'BidmadADOPCoupangAdapter', '1.0.0.3'
pod 'BidmadPartners/AdMobBidding', '1.0.3'
# OPTIONAL
pod 'BidmadTeadsAdapter', '5.0.27.3'
pod 'BidmadAtomAdapter', '1.0.0.3'
pod 'BidmadAdFitAdapter', '3.12.7.4'
pod 'BidmadIronSourceAdapter', '7.8.0.0.0'
- 6.4.0 이상 버전부터 BidmadAdapterFNC, BidmadAdapterFC, BidmadAdapterDynamic 을 지원하지 않습니다. 6.3.X 이하 버전에서 6.4.0 이상 버전으로 업데이트를 원하시는 사용자는 "BidmadAdapterFNC, BidmadAdapterFC, BidmadAdapterDynamic" 의존성을 제거하고, 위에 기재된 의존성을 추가해 어댑터를 추가해주세요.
- Terminal에서 다음 커맨드 입력
pod install
- Build Settings ( Target → Build Settings )
- Enable Bitcode 를 No로 설정
- Enable Bitcode 를 No로 설정
App Store에 애플리케이션을 제출할 때 다음 가이드를 참고하여 개인 정보 보호 정책 및 설문조사를 올바르게 설정하세요. Guide for Privacy Manifest & Privacy Survey
앱 초기 구성에 앞서, 4.6.0.1 이하 버전에서 5.0.0 버전으로 업데이트하는 경우 API Migration Guide 를 참고해 앱 업데이트를 진행하십시오. 이후, 아래 info.plist 내부 BidmadAppKey 추가 및 initializeSdk 메서드 추가 과정도 거치십시오.
5.3.0 버전 이하에서 6.0.0 버전 이상으로 업데이트하시는 네이티브 광고 인터페이스 사용자의 경우 NativeAd Migration Guide 6.0.0 를 참고해 앱 업데이트를 진행하십시오.
6.3.5 버전 이하에서 6.4.0 버전 이상으로 업데이트하시는 앱오픈 광고 / 네이티브 광고 인터페이스 사용자의 경우 AppOpen and NativeAd Migration Guide for 6.4.0를 참고해 앱 업데이트를 진행하십시오.
Xcode 프로젝트 info.plist 에 다음 키를 포함합니다.
- ADOP Insight 에서 확인할 수 있는 iOS 용 AppKey ("App Key 찾기" 가이드를 참고하십시오)
<key>BidmadAppKey</key>
<string>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</string>
- AdMob 대시보드 UI에서 확인 가능한 iOS 용 애드몹 ID ("App Key 찾기" 가이드를 참고하십시오)
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~xxxxxxxxxx</string>
- BidmadSDK에서 지원하는 광고 네트워크에 대한 SKAdNetworkIdentifier 값이 포함된 SKAdNetworkItems 키 (Preparing for iOS 14 를 참고하십시오)
<key>SKAdNetworkItems</key>
<array>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>xxxxxxxxxx.skadnetwork</string>
...
</dict>
</array>
BidmadSDK 실행에 필요한 작업을 수행합니다. SDK는 initializeSdk 메서드를 호출하지 않은 경우 광고 로드를 허용하지 않습니다.
초기화는 앱 실행 시 한번만 하는 것이 좋습니다. 다음은 initializeSdk 메서드를 호출하는 방법의 예시입니다.
// Objective C
[BidmadCommon initializeSdk];
// -- SWIFT --
BidmadCommon.initializeSdk()
또한, 아래 인터페이스를 통해 initializeSdk 성공 여부 콜백을 전달받을 수 있습니다.
// Objective C
[BidmadCommon initializeSdkWithCompletionHandler:^(BOOL isInitialized) {
NSLog(@"Bidmad Sample App: Initialized %@", isInitialized ? @"YES" : @"NO");
}];
// -- SWIFT --
BidmadCommon.initializeSdk { isInitialized in
print("Bidmad Sample App: \(isInitialized)")
}
- 배너를 노출시킬 UIView를 UIViewController 상에 추가합니다 (UIView bannerContainer).
- 배너 Initialize / ZoneID / Delegate 세팅 후, RequestBannerView를 호출해 배너를 로드 및 노출시킵니다.
Sample Code (Load)
// Objective C
@import OpenBiddingHelper;
@interface BannerViewController : UIViewController<BIDMADOpenBiddingBannerDelegate> {
BidmadBannerAd *bannerAd;
}
__weak IBOutlet UIView *bannerContainer;
@end
@implementation BannerViewController
- (void)viewDidLoad {
// Please set the Zone ID before calling a banner ad.
NSString *zoneID = @"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
bannerAd = [[BidmadBannerAd alloc] initWith:self containerView:self.BannerContainer zoneID:zoneID];
bannerAd.delegate = self;
[bannerAd setRefreshInterval:[@60 integerValue]];
[bannerAd load];
}
// -- SWIFT --
import OpenBiddingHelper
class BannerViewController: UIViewController, BIDMADOpenBiddingBannerDelegate {
var bannerAd: BidmadBannerAd!
@IBOutlet weak var bannerContainer: UIView!
override func viewDidLoad() {
super.viewDidLoad()
bannerAd = BidmadBannerAd(self, containerView: bottomView, zoneID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")
bannerAd.delegate = self
bannerAd.setRefreshInterval(60)
bannerAd.load()
}
}
Sample Code (Callback)
// Objective C
- (void)onLoadAd:(OpenBiddingBanner *)bidmadAd {
NSLog(@"Load")
}
- (void)onClickAd:(OpenBiddingBanner *)bidmadAd {
NSLog(@"Click")
}
- (void)onLoadFailAd:(OpenBiddingBanner *)bidmadAd error:(NSError * _Nonnull)error {
NSLog(@"LoadFail")
}
// -- SWIFT --
func onLoadAd(_ bidmadAd: OpenBiddingBanner) {
print("ad is loaded")
}
func onLoadFailAd(_ bidmadAd: OpenBiddingBanner, error: Error) {
print("ad failed to load with error \(error.localizedDescription)")
}
func onClickAd(_ bidmadAd: OpenBiddingBanner) {
print("ad is clicked")
}
- 전면 광고를 노출시키기 전, load 메서드를 호출합니다.
- onLoadAd 콜백 수신 이후, show(on:) 메서드를 호출해 미리 로드된 전면 광고를 디스플레이 합니다.
Sample Code (Load)
// Objective C
@import OpenBiddingHelper;
@interface InterstitialViewController () <BIDMADOpenBiddingInterstitialDelegate> {
BidmadInterstitialAd *interstitialAd;
}
@end
@implementation InterstitialViewController
- (void)viewDidLoad {
NSString *zoneID = @"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
interstitialAd = [[BidmadInterstitialAd alloc] initWithZoneID:zoneID];
[interstitialAd setDelegate: self];
}
-(void)loadAd {
[interstitialAd load];
}
...
-(void)showAd {
[interstitialAd showOnViewController:self];
}
// -- SWIFT --
import OpenBiddingHelper
class InterstitialController: UIViewController, BIDMADOpenBiddingInterstitialDelegate {
static let interstitialZoneID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
let interstitialAd = BidmadInterstitialAd(zoneID: interstitialZoneID)
override func viewDidLoad() {
super.viewDidLoad()
interstitialAd.delegate = self
}
func loadAd() {
interstitialAd.load()
}
func showAd() {
interstitialAd.show(on: self)
}
}
Sample Code (Callback)
// Objective C
- (void)onLoadAd:(OpenBiddingInterstitial *)bidmadAd {
NSLog(@"Load");
}
- (void)onLoadFailAd:(OpenBiddingInterstitial *)bidmadAd error:(NSError * _Nonnull)error {
NSLog(@"Load Fail");
}
- (void)onShowAd:(OpenBiddingInterstitial *)bidmadAd {
NSLog(@"Show");
}
- (void)onClickAd:(OpenBiddingInterstitial *)bidmadAd {
NSLog(@"Click");
}
- (void)onCloseAd:(OpenBiddingInterstitial *)bidmadAd {
NSLog(@"Close");
}
// onShowFailAd:error: 콜백은 v6.6.0 이상에서만 사용할 수 있습니다.
- (void)onShowFailAd:(OpenBiddingInterstitial *)bidmadAd error:(NSError *)error {
NSLog(@"Show Fail");
}
// -- SWIFT --
func onLoadAd(_ bidmadAd: OpenBiddingInterstitial) {
print("ad is loaded")
}
func onLoadFailAd(_ bidmadAd: OpenBiddingInterstitial, error: Error) {
print("ad failed to load with error \(error.localizedDescription)")
}
func onShowAd(_ bidmadAd: OpenBiddingInterstitial) {
print("ad is shown")
}
func onClickAd(_ bidmadAd: OpenBiddingInterstitial) {
print("ad is clicked")
}
func onCloseAd(_ bidmadAd: OpenBiddingInterstitial) {
print("ad is closed")
}
// onShowFailAd:error: 콜백은 v6.6.0 이상에서만 사용할 수 있습니다.
func onShowFailAd(_ bidmadAd: OpenBiddingInterstitial, error: Error) {
print("ad display failed")
}
- 보상형 광고를 노출시키기 전, load 메서드를 호출합니다.
- onLoadAd 콜백 수신 이후, show(on:) 메서드를 호출해 미리 로드된 보상형 광고를 디스플레이 합니다.
- onSkipAd (사용자가 광고를 스킵함) 혹은 onCompleteAd (사용자가 보상 지급 자격을 받음) 콜백에 따라 사용자에게 보상을 지급합니다.
Sample Code (Load)
// Objective C
@import OpenBiddingHelper;
@interface RewardViewController () <BIDMADOpenBiddingRewardVideoDelegate> {
BidmadRewardAd *rewardAd;
}
@end
@implementation RewardViewController
- (void)viewDidLoad {
NSString *zoneID = @"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
rewardAd = [[BidmadRewardAd alloc] initWithZoneID:zoneID];
rewardAd.delegate = self;
}
-(void)loadReward {
[rewardAd load];
}
-(void)showReward {
[rewardAd showOnViewController:self];
}
// -- SWIFT --
import OpenBiddingHelper
class RewardVideoController: UIViewController, BIDMADOpenBiddingRewardVideoDelegate {
static let rewardZoneID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
let rewardAd = BidmadRewardAd(zoneID: rewardZoneID)
override func viewDidLoad() {
super.viewDidLoad()
rewardAd.delegate = self
}
func loadAd() {
rewardAd.load()
}
func showAd() {
rewardAd.show(on: self)
}
}
Sample Code (Callback)
// Objective C
- (void)onLoadAd:(OpenBiddingRewardVideo *)bidmadAd {
NSLog(@"Load");
}
- (void)onLoadFailAd:(OpenBiddingRewardVideo *)bidmadAd error:(NSError * _Nonnull)error {
NSLog(@"Load Fail");
}
- (void)onShowAd:(OpenBiddingRewardVideo *)bidmadAd {
NSLog(@"Show");
}
- (void)onClickAd:(OpenBiddingRewardVideo *)bidmadAd {
NSLog(@"Click");
}
- (void)onCompleteAd:(OpenBiddingRewardVideo *)bidmadAd {
NSLog(@"Complete");
}
- (void)onSkipAd:(OpenBiddingRewardVideo *)bidmadAd {
NSLog(@"Skip");
}
- (void)onCloseAd:(OpenBiddingRewardVideo *)bidmadAd {
NSLog(@"Close");
}
// onShowFailAd:error: 콜백은 v6.6.0 이상에서만 사용할 수 있습니다.
- (void)onShowFailAd:(OpenBiddingRewardVideo *)bidmadAd error:(NSError *)error {
NSLog(@"Show Fail");
}
// -- SWIFT --
func onLoadAd(_ bidmadAd: OpenBiddingRewardVideo) {
print("ad is loaded")
}
func onLoadFailAd(_ bidmadAd: OpenBiddingRewardVideo, error: Error) {
print("ad failed to load with error \(error.localizedDescription)")
}
func onShowAd(_ bidmadAd: OpenBiddingRewardVideo) {
print("ad is shown")
}
func onClickAd(_ bidmadAd: OpenBiddingRewardVideo) {
print("ad is clicked")
}
func onCompleteAd(_ bidmadAd: OpenBiddingRewardVideo) {
print("ad reward is completed")
}
func onSkipAd(_ bidmadAd: OpenBiddingRewardVideo) {
print("ad reward is skipped")
}
func onCloseAd(_ bidmadAd: OpenBiddingRewardVideo) {
print("ad is closed")
}
// onShowFailAd:error: 콜백은 v6.6.0 이상에서만 사용할 수 있습니다.
func onShowFailAd(_ bidmadAd: OpenBiddingRewardVideo, error: Error) {
print("ad display failed")
}
App Open 광고는 사용자가 앱을 포그라운드로 가져올 때, 앱 로드 화면으로 수익을 올리는 광고 형식입니다. App Open 광고는 사용자가 해당 앱을 사용 중임을 알 수 있도록 상단에 앱 로고를 표기합니다. BidmadSDK는 더 쉬운 App Open 광고 로드를 위해 BidmadAppOpenAd init 시, 바로 AppOpenAd를 로드합니다. 사용자가 앱을 닫고 다시 열어 광고를 시청한 이후에도, 다시 AppOpenAd 광고를 로드합니다.
Sample Code (Load)
// Objective C
@interface AppOpenAdViewController () <OpenBiddingAppOpenAdDelegate>
@property (nonatomic, strong) BidmadAppOpenAd *appOpenAd;
@end
@implementation AppOpenAdViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.appOpenAd = [[BidmadAppOpenAd alloc] initWithZoneID:@"0ddd6401-0f19-49ee-b1f9-63e910f92e77"];
[self.appOpenAd setDelegate: self];
}
- (void)loadAd {
[self.appOpenAd load];
}
- (void)showAd {
if ([self.appOpenAd isLoaded]) {
[self.appOpenAd showOnViewController:self];
}
}
- (void)deregister {
// Disable App Open Ad automatically showing once your app moves to foreground
[self.appOpenAd deregisterForAppOpenAd];
}
@end
// -- SWIFT --
import OpenBiddingHelper
class AppOpenAdViewController: UIViewController, OpenBiddingAppOpenAdDelegate {
let appOpenAdZoneID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
var appOpenAd: BidmadAppOpenAd!
override func viewDidLoad() {
super.viewDidLoad()
appOpenAd = BidmadAppOpenAd(self, zoneID: appOpenAdZoneID)
appOpenAd.delegate = self
}
func loadAppOpenAd() {
appOpenAd.load()
}
func showAppOpenAd() {
if appOpenAd.isLoaded() {
appOpenAd.show(on: self)
}
}
func deregisterAppOpenAd() {
appOpenAd.deregisterForAppOpenAd()
}
}
Sample Code (Callback)
- (void)onLoadAd:(OpenBiddingAppOpenAd *)bidmadAd {
NSLog(@"Load");
}
- (void)onShowAd:(OpenBiddingAppOpenAd *)bidmadAd {
NSLog(@"Show");
}
- (void)onClickAd:(OpenBiddingAppOpenAd *)bidmadAd {
NSLog(@"Click");
}
- (void)onCloseAd:(OpenBiddingAppOpenAd *)bidmadAd {
NSLog(@"Close");
}
- (void)onLoadFailAd:(OpenBiddingAppOpenAd *)bidmadAd error:(NSError * _Nonnull)error {
NSLog(@"Load Fail");
}
// onShowFailAd:error: 콜백은 v6.6.0 이상에서만 사용할 수 있습니다.
- (void)onShowFailAd:(OpenBiddingAppOpenAd *)bidmadAd error:(NSError *)error {
NSLog(@"Show Fail");
}
// -- SWIFT --
func onLoadAd(_ bidmadAd: OpenBiddingAppOpenAd) {
print("ad is loaded")
}
func onLoadFailAd(_ bidmadAd: OpenBiddingAppOpenAd, error: Error) {
print("ad failed to load with error \(error.localizedDescription)")
}
func onShowAd(_ bidmadAd: OpenBiddingAppOpenAd) {
print("ad is shown")
}
func onClickAd(_ bidmadAd: OpenBiddingAppOpenAd) {
print("ad is clicked")
}
func onCloseAd(_ bidmadAd: OpenBiddingAppOpenAd) {
print("ad is closed")
}
// onShowFailAd:error: 콜백은 v6.6.0 이상에서만 사용할 수 있습니다.
func onShowFail(_ bidmadAd: OpenBiddingAppOpenAd, error: Error) {
print("ad display failed
7CB6
")
}
네이티브 광고는 애플리케이션에 맞는 고유한 방식으로 기획, 제작된 광고를 말합니다. 광고를 호출하기 앞서, 레이아웃 가이드에 따라 광고 UI 설정해주십시오. 광고 UI 설정 이후, 광고 데이터가 포함된 BIDMADNativeAd 를 로드한 뒤, setAdView:adView: 메서드를 실행합니다.
*5.3.0 버전 이하에서 6.0.0 버전 이상으로 업데이트하시는 네이티브 광고 인터페이스 사용자의 경우 NativeAd Migration Guide 6.0.0 를 참고해 앱 업데이트를 진행하십시오.
Sample Code (Load & Callbacks)
// Objective C
@import OpenBiddingHelper;
@interface NativeAdViewController ()
@property (strong, nonatomic) BidmadNativeAd * ad;
@end
...
- (void)viewDidLoad {
self.ad = [BidmadNativeAd adWithZoneID:@"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"];
[self.ad setDelegate:self];
[self.ad load];
}
#pragma mark Native Ad Delegate Methods
- (void)onClickAd:(BidmadNativeAd *)bidmadAd {
ADOPLog.printInfo(@"Native Ad Click");
}
- (void)onLoadAd:(BidmadNativeAd *)bidmadAd {
ADOPLog.printInfo(@"Native Ad Load);
UIView *loadedView = [NSBundle.mainBundle loadNibNamed:@"NativeAdView" owner:nil options:nil].firstObject;
BIDMADNativeAdView *adView = [BidmadNativeAd findAdViewFromSuperview:loadedView];
[self.view addSubview:loadedView];
[bidmadAd setRootViewController:self adView:adView];
}
- (void)onLoadFailAd:(BidmadNativeAd *)bidmadAd error:(NSError *)error {
ADOPLog.printInfo(@"Native Ad Fail: %@", error.localizedDescription);
}
// -- SWIFT --
let ad: BidmadNativeAd! = BidmadNativeAd(zoneID: "Native Ad Zone ID")
override func viewDidLoad() {
super.viewDidLoad()
self.ad.delegate = self
self.ad.load()
}
// MARK: BIDMADNativeAdDelegate
func onLoad(_ bidmadAd: BidmadNativeAd) {
if let loadedView = Bundle.main.loadNibNamed("NativeAd", owner: nil)?.first as? UIView,
let adView = BidmadNativeAd.findView(fromSuperview: loadedView) {
view.addSubview(loadedView)
self.ad.setRootViewController(self, adView: adView)
}
}
func onClick(_ bidmadAd: BidmadNativeAd) {
print("Native Ad Click")
}
func onLoadFail(_ bidmadAd: BidmadNativeAd, error: Error) {
print("Native Ad Fail")
}
세부사항
구글 애드네트워크를 위한 테스트 디바이스 설정은 다음과 같은 과정이 필요합니다.
광고 통합 앱을 로드하고 광고를 요청합니다. 콘솔에서 다음과 같은 메시지를 확인합니다.
<Google> To get test ads on this device, set: GADMobileAds.sharedInstance.requestConfiguration.testDeviceIdentifiers = @[ @"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ];
콘솔에 기록된 테스트 디바이스 ID를 다음 코드를 통해 세팅하십시오.
// ObjC
[BidmadCommon setTestDeviceId:@"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"];
// -- SWIFT --
BidmadCommon.setTestDeviceId("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
리스트
- Class Reference for BidmadSDK-iOS
- Apple privacy survey ([ENG] | [KOR])
- iOS GDPR Guide ([ENG] | [KOR])
- Preparing for iOS 14 ([ENG] | [KOR])
- 쿠팡 네트워크 광고 차단 인터페이스 가이드