Добавление SDK Audience Network в приложение для iOS

Подготовка к обновлению для версии iOS 14.5

Для монетизации приложений на устройствах с iOS 14.5 всем издателям потребуется SDK Audience Network версии не ниже 6.2.1. Пользователям iOS 14 мы также рекомендуем выбирать SDK Audience Network версии 6.2.1. В этой версии представлены два требования:

необходимо реализовать параметр setAdvertiserTrackingEnabled вне зависимости от типа агрегации, чтобы мы знали, можно ли использовать данные для показа персонализированной рекламы;
необходимо добавить предложенные ID SKAdNetwork в файл Info.plist проекта Xcode, чтобы рекламодатели могли измерять эффективность рекламных кампаний.

Подробнее см. в нашем посте на Meta for Developers.

Прежде чем настраивать монетизацию приложения, установите последнюю версию SDK.

В этом руководстве рассказано, как добавить SDK Audience Network в приложение для iOS, чтобы вызывать API Audience Network. Для управления зависимостями рекомендуется использовать CocoaPods, однако мы также включили ресурсы для скачивания на случай интеграции вручную.

CocoaPods (предпочтительный метод скачивания)

Добавьте следующую строку в файл Podfile проекта:

pod 'FBAudienceNetwork'

Выполните следующую команду:

pod install

Скачивание вручную

Если использовать CocoaPods нет возможности, вы можете скачать SDK Audience Network по ссылкам в таблице ниже.

Package	Date	Change Log
iOS Audience Network SDK 6.15.0	March 15, 2024	6.15.0 Change Log
iOS Audience Network SDK 6.14.0	August 3, 2023	6.14.0 Change Log

После скачивания SDK Audience Network выполните перечисленные ниже действия, чтобы завершить интеграцию.

Откройте свой проект в XCode.
Перетащите в XCode файл FBAudienceNetwork.xcframework из папки Dynamic в скачанном архиве SDK Audience Network для iOS.
На вкладке General (Общие) в настройках целевого объекта своего приложения выберите для файла FBAudienceNetwork.xcframework значение Embed & Sign (Вставить и подписать).

Примечания

Также можно использовать статический вариант SDK Audience Network из скачанного архива. Для этого перетащите файл FBAudienceNetwork.xcframework из папки Static.
Если вы хотите воспользоваться статическим вариантом, проект должен использовать Swift. Если Swift не используется, добавьте в проект пустой файл swift: File (Файл) -> New (Создать) -> Swift в XCode.
Если ваш проект рассчитан на версию iOS до 12.4, не забудьте установить для параметра Always embed Swift standard libraries (Всегда вставлять стандартные библиотеки Swift) в разделе Build settings (Настройки сборки) для целевого объекта своего приложения в XCode значение YES (ДА).
Чтобы после установки вручную не настраивать какие-либо дополнительные параметры, используйте CocoaPods.

Устранение неполадок для SDK версии 6.9.0 и более поздних

Начиная с версии 6.9.0 в SDK Audience Network для iOS включена поддержка Swift. Ниже описано, как устранять распространенные проблемы с установкой SDK и совместимостью со Swift.

XCode выдает ошибку "Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection" и "Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider" (Неопределенный символ: …). Эти ошибки означают, что вы используете не последнюю версию XCode. Чтобы устранить их, обновите XCode до версии 13 или более поздней.
XCode выдает много ошибок типа Undefined symbol__swift_FORCE_LOAD_$_. Эти ошибки означают, что в вашем проекте не включена поддержка Swift. Чтобы устранить их, проще всего добавить в XCode пустой файл Swift: File (Файл) -> New (Создать) -> Swift file (Файл Swift).
При запуске на устройстве работа приложения завершается с ошибкой "dyld: Library not loaded: @rpath/FBAudienceNetwork.framework" (dyld: не загружена библиотека: @rpath/FBAudienceNetwork.framework). Эта ошибка означает, что вы не вставили SDK Audience Network в свой файл. Откройте настройки целевого объекта, перейдите на вкладку General (Общие) и выберите для FBAudienceNetwork.xcframework значение Embed & Sign (Вставить и подписать).
Работа приложения завершается сразу после запуска с ошибкой "dyld: Library not loaded: @rpath/libswiftCore.dylib" (dyld: не загружена библиотека: @rpath/libswiftCore.dylib). Эта ошибка означает, что приложение запускается в iOS версии до 12.4 и для параметра "Always embed Swift standard libraries (Всегда вставлять стандартные библиотеки Swift)" не установлено значение "YES (ДА)". Задайте для параметра "Always embed Swift standard libraries (Всегда вставлять стандартные библиотеки Swift)" в разделе "Build settings (Настройки сборки)" настроек целевого объекта приложения в XCode значение "YES (ДА)".