Preparing your app for iOS 14 - adxcorp/ADXLibrary

IDFA (Identifier for Advertisers)

iOS 13 이전에는 '광고 추적 제한 (Limit Ad Tracking)'을 활성화하기 전에는 IDFA (Identifier for Advertisers) 값을 가져올 수 있었습니다.
iOS 14 부터는 사용자 권한 요청을 통해 사용을 허용한 경우에만 IDFA 값을 가져올 수 있습니다.
광고 수익이 줄어드는 것을 방지하려면 iOS 14에 대응하여 다음과 같이 변경해야 합니다.

ATT (AppTrackingTransparency) 사용

필요사항 : XCode 12.0+
iOS 14 이상에서 IDFA 와 같은 식별자에 대한 액세스 및 사용에 대한 권한을 요청하려면 ATT (AppTrackingTransparency) 알림을 사용해야 합니다.
자세한 내용은 아래의 단계에 따라 진행해야 합니다.

Step 1:SDK 준비

신규 및 업데이트 앱의 경우 iOS SDK 버전 1.8.5 이상을 준비하시고, 유니티의 경우 Unity Package 1.9.4 이상을 준비합니다.

- ADXLibrary (iOS)

  source 'https://github.com/adxcorp/AdxLibrary_iOS_Release.git'
  source 'https://github.com/CocoaPods/Specs.git'      

  # 배너, 전면, 네이티브
  pod 'ADXLibrary', '1.8.5'
  pod 'ADXLibrary-FBAudienceNetwork', '1.8.5'
  pod 'ADXLibrary-Pangle', '1.8.5'
  pod 'ADXLibrary-Vungle', '1.8.5'

  # 리워드 비디오 사용 시 추가
  pod 'ADXLibrary-UnityAds', '1.8.5'

- ADXLibrary (Unity)

Version : 1.9.4

Step 2:Info.plist 파일 적용 (SKAdNetwork 구성)

광고 네트워크에 지원되는 목록을 SKAdNetwork ID List 에서 확인하여 Info.plist 에 넣어줘야 합니다.

(Example)

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>example100.skadnetwork</string>
    </dict>
    <dict>   
         <key>SKAdNetworkIdentifier</key>
         <string>example200.skadnetwork</string>
    </dict>
</array>

Step 3:Info.plist 파일 적용 (권한 사용에 대한 설명 문구)

Info.plist 파일에 NSUserTrackingUsageDescription 키와 권한 사용에 대한 동의를 구하는 메시지를 추가합니다.

(Example - English)

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

(Example - 한글)

<key>NSUserTrackingUsageDescription</key>
<string>개인 맞춤 광고를 게재하는 데 사용됩니다.</string>

Step 4:코드 수정 (권한 요청)

광고 SDK 초기화를 하기 전에 ATT 알림을 통한 권한을 요청합니다.
권한 요청 관련 메소드로 requestTrackingAuthorizationWithCompletionHandler: 호출을 사용합니다.
앞서 설명한 Info.plist 파일에 설명 문구를 추가하지 않으면 Crash가 발생하니 유의해야 합니다.

AppDelegate.m (iOS - Objective C)

#import "AppDelegate.h"
#import <ADXLibrary/ADXLibrary.h>
#import <MoPub.h>
#import <FBAudienceNetwork/FBAudienceNetwork.h>
#import <AppTrackingTransparency/AppTrackingTransparency.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:
(NSDictionary *)launchOptions {

    if (@available(iOS 14, *)) {
        // ATT 알림을 통한 권한 요청
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {

            // 광고추적제한 설정 (페이스북 광고)
            if (ATTrackingManager.trackingAuthorizationStatus == ATTrackingManagerAuthorizationStatusAuthorized) {
                [FBAdSettings setAdvertiserTrackingEnabled:YES];
            } else {
                [FBAdSettings setAdvertiserTrackingEnabled:NO];
            }
            
            // 광고 SDK 초기화
            [self initializeAdSdk];
        }];
    } else {
        // 광고 SDK 초기화
        [self initializeAdSdk];
    }
    
    return YES;
}

- (void) initializeAdSdk {
    MPMoPubConfiguration *sdkConfig = [[MPMoPubConfiguration alloc] initWithAdUnitIdForAppInitialization:<YOUR AD UNIT ID>];
    [[MoPub sharedInstance] initializeSdkWithConfiguration:sdkConfig
                                                completion:^{
            [ADXGDPR.sharedInstance showADXConsent:^(ADXConsentState consentState, BOOL success) {
                 //*** success가 호출 된 후 광고 관련 코드를 사용해주시기 바랍니다.

                 

            }];
    }];
    
    [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
}

...

@end

AppDelegate.swift (iOS - Swift)

import UIKit
import GoogleMobileAds
import MoPub
import ADXLibrary
import AppTrackingTransparency
import FBAudienceNetwork

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?
    func application(_ application: UIApplication, didFinishLaunchingWithOptions
 launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        if #available(iOS 14, *) {
            // ATT 알림을 통한 권한 요청
            ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in
                // 광고추적제한 설정 (페이스북 광고)
                if (ATTrackingManager.trackingAuthorizationStatus == ATTrackingManager.AuthorizationStatus.authorized) {
                    FBAdSettings.setAdvertiserTrackingEnabled(true)
                } else {
                    FBAdSettings.setAdvertiserTrackingEnabled(false)
                }
                
                // 광고 SDK 초기화
                self.initializeAdSdk()
              })
        } else {
            // 광고 SDK 초기화
            initializeAdSdk()
        }
        
        return true
    }
    
    func initializeAdSdk() {
        MoPub.sharedInstance().initializeSdk(with: MPMoPubConfiguration(adUnitIdForAppInitialization: BANNER_AD_UNIT_ID), completion:{
            ADXGDPR.sharedInstance()?.showADXConsent({ (ADXConsentState, Bool) in
                //*** success가 호출 된 후 광고 관련 코드를 사용해주시기 바랍니다.
            })
        })
        
        GADMobileAds.sharedInstance().start(completionHandler:nil)
    }

}

UnityAppController.mm (Unity)

#import "UnityAppController.h"

#import <FBAudienceNetwork/FBAudienceNetwork.h>
#import <AppTrackingTransparency/AppTrackingTransparency.h>

@implementation UnityAppController

- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:
(NSDictionary*)launchOptions {

    ...

    if (@available(iOS 14, *)) {
        // ATT 알림을 통한 권한 요청
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {

            // 광고추적제한 설정 (페이스북 광고)
            if (ATTrackingManager.trackingAuthorizationStatus == ATTrackingManagerAuthorizationStatusAuthorized) {
                [FBAdSettings setAdvertiserTrackingEnabled:YES];
            } else {
                [FBAdSettings setAdvertiserTrackingEnabled:NO];
            }
        }];
    }
    
    return YES;
}

...

@end

적용화면

Preparing your app for iOS 14 - adxcorp/ADXLibrary_Integration GitHub Wiki

IDFA (Identifier for Advertisers)

ATT (AppTrackingTransparency) 사용

Step 1:SDK 준비

- ADXLibrary (iOS)

- ADXLibrary (Unity)

Step 2:Info.plist 파일 적용 (SKAdNetwork 구성)

(Example)

Step 3:Info.plist 파일 적용 (권한 사용에 대한 설명 문구)

Step 4:코드 수정 (권한 요청)

AppDelegate.m (iOS - Objective C)

AppDelegate.swift (iOS - Swift)

UnityAppController.mm (Unity)

적용화면

⚠️ GitHub.com Fallback ⚠️

Preparing your app for iOS 14 - adxcorp/ADXLibrary_Integration GitHub Wiki

IDFA (Identifier for Advertisers)

ATT (AppTrackingTransparency) 사용

Step 1:SDK 준비

- ADXLibrary (iOS)

- ADXLibrary (Unity)

Step 2:Info.plist 파일 적용 (SKAdNetwork 구성)

(Example)

Step 3:Info.plist 파일 적용 (권한 사용에 대한 설명 문구)

Step 4:코드 수정 (권한 요청)

AppDelegate.m (iOS - Objective C)

AppDelegate.swift (iOS - Swift)

UnityAppController.mm (Unity)

적용화면

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️