Audience Network SDK를 iOS 앱에 추가

iOS 14.5 변경 사항에 따른 조치

모든 퍼블리셔는 반드시 Audience Network SDK 6.2.1 이상을 사용해야 iOS 14.5 사용자를 대상으로 수익을 창출할 수 있습니다. (iOS 14 사용자는 Audience Network SDK 6.2.1을 사용하는 것이 좋습니다.) 이 버전에는 다음 두 가지 요구 사항이 있습니다.

미디에이션 사용과 무관하게 ‘setAdvertiserTrackingEnabled’ 플래그를 구현하여 데이터를 사용하여 맞춤형 광고를 게재하는지 Facebook에 알려야 합니다.
추천 SKAdNetwork ID를 Xcode 프로젝트의 Info.plist에 추가하여 광고주가 광고 캠페인의 성공을 측정하도록 하세요.

자세한 내용은 Meta for Developers 게시물을 참조하세요.

SDK 최신 버전으로 업그레이드한 다음, 수익 창출을 위해 앱을 온보딩하세요.

이 가이드에서는 Audience Network API를 호출하기 위해 iOS 앱에 Audience Network SDK를 포함하는 방법을 설명합니다. CocoaPods를 사용하여 종속성을 관리하는 것이 좋습니다. 그러나 수동 통합을 위한 다운로드 위치도 제공됩니다.

CocoaPods(기본 다운로드 수단)

다음 행을 프로젝트의 Podfile에 추가하세요.

pod 'FBAudienceNetwork'

다음 명령을 실행하세요.

pod install

수동 다운로드

CocoaPods를 사용할 수 없는 경우 다음 표에 나와 있는 위치 중 하나에서 Audience Network SDK를 다운로드할 수 있습니다.

Package	Date	Change Log
iOS Audience Network SDK 6.16.0	Oct 15, 2024	6.16.0 Change Log
iOS Audience Network SDK 6.15.2	Aug 15, 2024	6.15.2 Change Log

Audience Network SDK를 다운로드한 후 다음 단계에 따라 통합을 완료하세요.

XCode에서 프로젝트를 엽니다.
다운로드한 iOS Audience Network SDK 아카이브의 Dynamic 폴더에서 FBAudienceNetwork.xcframework를 XCode에 끌어서 놓습니다.
앱 타겟 설정의 General(일반) 탭에서 FBAudienceNetwork.xcframework에 대해 Embed & Sign(포함 및 서명)을 선택합니다.

참고

다운로드에 제공된 Audience Network SDK의 고정 에디션을 사용해도 됩니다. 이렇게 하려면 Static 폴더에서 FBAudienceNetwork.xcframework를 끌어서 놓습니다.
고정 에디션을 사용하고자 하는 경우 프로젝트에서 Swift를 사용합니다. 프로젝트에서 Swift를 사용하지 않을 경우 프로젝트에 빈 Swift 파일을 추가합니다(XCode에서 파일 -> 새로 만들기 -> Swift).
프로젝트가 12.4보다 이전인 iOS 버전을 타게팅할 경우 XCode의 앱 타겟에 있는 빌드 설정에서 항상 Swift 표준 라이브러리 포함 설정을 예로 설정합니다.
수동 설치 후 추가적인 조정을 하지 않으려면 CocoaPods를 사용합니다.

SDK 버전 6.9.0 이상에 대한 문제 해결

6.9.0부터는 iOS Audience Network SDK가 Swift를 사용하도록 설정되어 있습니다. SDK 설치 및 Swift 상호운용성과 관련하여 가장 일반적으로 발생하는 문제를 해결하려면 아래의 내용을 참조하세요.

XCode에서 '정의되지 않은 기호: __swift_FORCE_LOAD_$_swiftDataDetection' 및 '정의되지 않은 기호: __swift_FORCE_LOAD_$_swiftFileProvider' 오류가 발생합니다. 이러한 오류는 최신 버전의 XCode를 사용하고 있지 않음을 의미합니다. 이 오류를 해결하려면 XCode 13 이상으로 업데이트하세요.
XCode에서 여러 가지 Undefined symbol__swift_FORCE_LOAD_$_ 오류가 발생합니다. 이러한 오류는 프로젝트에서 Swift 지원을 사용하도록 설정하지 않았음을 의미합니다. 가장 간단한 해결 방법은 빈 Swift 파일을 추가하는 것입니다(XCode에서 '파일' -> '새로 만들기' -> 'Swift 파일').
기기에서 앱을 실행하면 시작 직후에 'dyld: Library not loaded: @rpath/FBAudienceNetwork.framework' 오류와 함께 바로 중단됩니다. 이 오류는 앱에 Audience Network SDK를 포함하지 않았다는 것을 의미합니다. 타겟 설정으로 이동하고 'General(일반)' 탭에서 'FBAudienceNetwork.xcframework'에 대해 'Embed & Sign(포함 및 서명)'을 선택하세요.
앱을 시작하자마자 'dyld: Library not loaded: @rpath/libswiftCore.dylib' 오류와 함께 중단됩니다. 이 오류는 iOS 12.4보다 이전인 버전에서 앱을 실행하고 있고 '항상 Swift 표준 라이브러리 포함' 설정에서 '예'를 선택하지 않았다는 것을 의미합니다. XCode에서 앱 타겟의 '빌드 설정'에서 '항상 Swift 표준 라이브러리 포함' 설정을 '예'로 선택하세요.