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, поэтому при более низкой минимальной версии на уровне приложения корректная компоновка с pod-зависимостями всё равно невозможна.

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