3. Configuração do projeto

3.1 ID do app no AdMob

Se AdMob/GAM for uma das suas redes de anúncios habilitadas, adicione seu próprio ID do app no AdMob ao Info.plist (esse ID é específico do app — não pode ser incluído nos xcframeworks):

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

3.2 SKAdNetworkItems

As redes de mediação/atribuição usadas pelo AKS (AppLovin, IronSource e seus parceiros de leilão) precisam de entradas SKAdNetworkIdentifier para atribuir instalações corretamente sob as regras do ATT. O app de referência inclui cerca de 48 entradas que abrangem parceiros de mediação de AppLovin/IronSource/Meta/etc. Obtenha a lista atualizada nos painéis das suas redes de anúncios (AppLovin, IronSource e AdMob publicam suas próprias listas), em vez de copiar uma lista antiga — essas redes adicionam novos IDs ao longo do tempo.

3.3 App Tracking Transparency (ATT) — uma lacuna que você precisa resolver

Atenção: a integração de referência não inclui NSUserTrackingUsageDescription nem chamadas a ATTrackingManager.requestTrackingAuthorization(). O AKS não solicita a autorização do ATT por você no iOS. Se quiser disponibilizar o IDFA para a mediação de AdMob/AppLovin/IronSource e para a atribuição de AppsFlyer/Adjust, você precisará adicionar ambos por conta própria:

<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
}

Sem a string de descrição de uso, chamar requestTrackingAuthorization causa o encerramento inesperado do app em tempo de execução — portanto, não adicione a chamada sem a chave no Info.plist e não presuma que qualquer um desses dois requisitos já esteja atendido só porque o SDK está integrado.

3.4 GoogleService-Info.plist

Adicione o GoogleService-Info.plist do Firebase ao target do seu app da maneira habitual (arraste-o para a pasta de código-fonte e confirme que ele está associado ao target). Não há nada específico do AKS nesse processo — a configuração padrão do Firebase se aplica sem alterações.

3.5 Versão mínima de implantação

AppsKit.xcframework/AKSKit.xcframework são compilados para iOS 15.0 ou superior, com Swift 5.9 (Xcode 15.2+) e BUILD_LIBRARY_FOR_DISTRIBUTION: YES para garantir a estabilidade dos módulos. Defina IPHONEOS_DEPLOYMENT_TARGET no target do seu app como 15.0 ou superior — e lembre-se de que o post_install do Podfile (§1.2) também força todos os targets de pods a usar a versão 15.0. Portanto, definir uma versão inferior no target do app causaria problemas de vinculação com os pods de qualquer forma.