3. Настройка проекта

3.1 AdMob App ID

Если AdMob/GAM входит в число подключённых рекламных сетей, добавьте свой AdMob App ID в Info.plist (этот идентификатор привязан к конкретному приложению, поэтому его нельзя включить в состав xcframework):

xml

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

3.2 SKAdNetworkItems

Рекламным сетям медиации и атрибуции, с которыми работает AKS (AppLovin, IronSource и их партнёрам по биддингу), нужны записи SKAdNetworkIdentifier для корректной атрибуции установок при использовании ATT. Пример приложения содержит около 48 записей для партнёров по медиации AppLovin, IronSource, Meta и других сетей. Берите актуальный список из панелей управления ваших рекламных сетей (AppLovin, IronSource и AdMob публикуют такие списки), а не копируйте устаревший: со временем сети добавляют новые идентификаторы.

3.3 App Tracking Transparency (ATT) — нужно настроить самостоятельно

Обратите внимание: в примере интеграции нет ни NSUserTrackingUsageDescription, ни вызова ATTrackingManager.requestTrackingAuthorization(). AKS не запрашивает разрешение ATT за вас на iOS. Если вы хотите, чтобы IDFA был доступен для медиации AdMob/AppLovin/IronSource и атрибуции AppsFlyer/Adjust, необходимо самостоятельно добавить и описание, и вызов:

xml

<key>NSUserTrackingUsageDescription</key>
<string>Your data will be used to deliver personalized ads.</string>

swift

import AppTrackingTransparency

ATTrackingManager.requestTrackingAuthorization { status in
    // call this before initializing ads — see §4.4
}

Без строки с описанием цели использования данных вызов requestTrackingAuthorization приводит к аварийному завершению приложения. Поэтому не добавляйте этот вызов без соответствующего ключа в Info.plist и не считайте, что эти шаги уже выполнены только потому, что SDK интегрирован.

3.4 GoogleService-Info.plist

Добавьте файл Firebase GoogleService-Info.plist в таргет приложения обычным способом: перетащите его в папку с исходным кодом и убедитесь, что он включён в нужный таргет (Target Membership). Никаких особенностей, связанных с AKS, здесь нет — стандартная настройка Firebase применяется без изменений.

3.5 Минимальная версия iOS (Deployment Target)

AppsKit.xcframework/AKSKit.xcframework собраны для iOS 15.0 и выше с использованием Swift 5.9 (Xcode 15.2+) и параметра BUILD_LIBRARY_FOR_DISTRIBUTION: YES для обеспечения стабильности модулей. Установите IPHONEOS_DEPLOYMENT_TARGET таргета приложения в 15.0 или выше. Помните, что post_install в Podfile (§1.2) также принудительно задаёт версию 15.0 для всех таргетов pod-зависимостей, поэтому при более низкой минимальной версии iOS у приложения в любом случае возникнут проблемы с линковкой этих зависимостей.

← 2. Настройка проекта Xcode — локальное подключение xcframework 4. Инициализация SDK →