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 →