3. 项目配置

3.1 AdMob App ID

如果你启用的广告平台中包含 AdMob/GAM，请将你自己的 AdMob App ID 添加到 Info.plist（此 ID 专属于你的应用，无法打包在 xcframework 中）：

<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 均有发布），而不要复制旧列表，因为这些平台会不断添加新的 ID。

3.3 应用跟踪透明度（ATT）——需要自行补充配置

**注意：**参考集成中既未配置 NSUserTrackingUsageDescription，也未调用 ATTrackingManager.requestTrackingAuthorization()。AKS 不会在 iOS 上替你弹出 ATT 授权提示。如果你希望 AdMob/AppLovin/IronSource 广告聚合和 AppsFlyer/Adjust 归因能够使用 IDFA，就需要自行添加以下两项：

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

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（拖入源代码文件夹，并确认已勾选对应的 Target Membership）。此处没有 AKS 特有的配置要求，直接按照 Firebase 的标准配置流程操作即可。

3.5 最低部署版本

AppsKit.xcframework/AKSKit.xcframework 使用 Swift 5.9（Xcode 15.2+）构建，最低支持 iOS 15.0，并通过 BUILD_LIBRARY_FOR_DISTRIBUTION: YES 启用模块稳定性。请将应用 target 的 IPHONEOS_DEPLOYMENT_TARGET 设置为 15.0 或更高版本。另外请注意，Podfile 的 post_install（§1.2）也会将所有 pod target 的最低部署版本强制设为 15.0，因此即使将应用的最低部署版本设得更低，也无法正常链接这些 pod。